cts-verifier-pro

CTS Verifier Pro

CTS Verifier Pro adalah aplikasi desktop berbasis Tauri untuk otomasi CTS Verifier Android dengan dukungan multi-device, precondition setup, instrumentation run, pull result, dan resource APK eksternal.

Fitur

• Menjalankan flow CTS Verifier ke banyak device sekaligus.
• Resource APK dipisah dari installer dan tidak disimpan di GitHub repository/release karena batas ukuran file.
• Paket rilis otomatis untuk Linux deb/rpm dan Windows exe.
• GitHub Release otomatis saat push tag v*.
• GitHub Pages untuk halaman download dan panduan instalasi singkat.

Struktur Resource

Installer tidak membundel APK resource. Resource harus dicopy manual ke folder resources/ atau diarahkan lewat environment variable CTS_VERIFIER_RESOURCE_DIR.

resources/
  ApkTest/
    AutoCtsVerifier-debug.apk
    AutoCtsVerifier-debug-androidTest.apk
  Normal/
    13/
    14/
    15/
    16/

Urutan pencarian resource:

• CTS_VERIFIER_RESOURCE_DIR
• folder resources/ di samping binary
• fallback development path di workspace

Menjalankan dari Source

npm install
npm run tauri dev

Contoh override resource:

export CTS_VERIFIER_RESOURCE_DIR=/path/to/resources
npm run tauri dev

Build Lokal

Linux

Menghasilkan installer deb dan rpm.

npm run build:linux

Windows

Menghasilkan installer exe NSIS.

npm run build:windows

Auto

Memilih platform berdasarkan host saat ini.

npm run build:auto

Instalasi dari Release

Unduh asset dari:

• Release GitHub: https://github.com/endrisusanto/cts-verifier-pro/releases/latest
• GitHub Pages: https://endrisusanto.github.io/cts-verifier-pro/

Linux Debian/Ubuntu

sudo dpkg -i ./cts-verifier-pro_*.deb

Linux Fedora/RHEL

sudo dnf install ./cts-verifier-pro-*.rpm

Windows

• Jalankan file installer *.exe.

Pasang Resource Terpisah

1. Siapkan folder resource dari shared storage / backup internal tim.
2. Copy manual menjadi folder resources/.
3. Letakkan folder resources/ di samping binary/aplikasi, atau set:

export CTS_VERIFIER_RESOURCE_DIR=/path/to/resources

Release dengan Git Tag

Workflow release ada di .github/workflows/release.yml. Saat tag v* di-push, workflow akan:

• build deb
• build rpm
• build exe
• membuat draft GitHub Release

Langkah rilis:

git checkout main
git pull
git tag -a v1.4.0 -m "Release v1.4.0"
git push origin v1.4.0

Setelah workflow selesai:

1. Buka tab Actions.
2. Pastikan job Release sukses.
3. Buka halaman draft release.
4. Verifikasi asset installer.
5. Publish release.

Catatan Resource Besar

File APK resource sengaja di-gitignore dan tidak ikut release asset GitHub karena GitHub membatasi file besar sekitar 100 MB per file.

Alur operasionalnya:

• installer dirilis lewat GitHub Release
• resource disimpan di shared storage / folder internal terpisah
• setelah install, operator copy manual folder resources/

GitHub Pages

Halaman statis ada di docs/index.html, dan deploy workflow ada di .github/workflows/pages.yml.

Aktifkan sekali di repository settings:

1. Buka Settings
2. Masuk ke Pages
3. Pastikan source menggunakan GitHub Actions

Setelah itu, push ke main akan otomatis deploy halaman docs/.

Timeout Instrumentation

Jika perlu ubah timeout guard:

export CTS_VERIFIER_TEST_TIMEOUT_SECS=600
export CTS_VERIFIER_TEST_IDLE_TIMEOUT_SECS=180

File Penting

• Build script: build.sh
• Release workflow: .github/workflows/release.yml
• Pages workflow: .github/workflows/pages.yml
• Pages index: docs/index.html
• Tauri config: src-tauri/tauri.conf.json