Kompilasi APK dari Sumber

Agent dipublikasikan sebagai kode terbuka supaya Anda tidak perlu percaya pada biner yang kami bagikan. Halaman ini menjelaskan cara membangunnya sendiri.

Repo: github.com/dedy45/gososmed-mobile-agent — lisensi Apache-2.0.

Bentuk proyeknya

Proyek Android standar berbasis Gradle dengan Kotlin DSL:

app/                    modul aplikasi (sumber + aturan ProGuard)
build.gradle.kts        konfigurasi build root
settings.gradle.kts     definisi modul
gradle.properties       properti build
.github/workflows/      pipeline build APK

Cara 1 — GitHub Actions (disarankan)

Cara ini tidak menuntut Android SDK di mesin Anda. Pipeline-nya sudah ada di repo.

# Jalankan build
gh workflow run build-apk --repo dedy45/gososmed-mobile-agent

# Lihat status
gh run list --repo dedy45/gososmed-mobile-agent --limit 5

# Unduh hasilnya
gh run download <run-id> -n gososmed-agent-debug

Kalau Anda mem-fork repo, jalankan perintah yang sama dengan --repo <akun-anda>/gososmed-mobile-agent.

Cara 2 — Gradle lokal

Kebutuhan alat:

• JDK 17
• Gradle 8.9
• Android SDK dengan platform 34 dan build-tools 34.0.0

git clone https://github.com/dedy45/gososmed-mobile-agent.git
cd gososmed-mobile-agent

# Debug APK
gradle assembleDebug
# hasil: app/build/outputs/apk/debug/app-debug.apk

# Release APK (tanpa tanda tangan kami)
gradle assembleRelease

Repo ini tidak memakai Gradle wrapper

gradlew tidak di-commit, jadi ./gradlew akan gagal. Setel JAVA_HOME (JDK 17) dan ANDROID_HOME (SDK 34), lalu panggil gradle dari instalasi lokal Anda. Di Windows, pakai gradle.bat bila Anda memanggilnya dari cmd.

Soal penandatanganan

Build lokal Anda memakai kunci debug Android atau kunci Anda sendiri, bukan kunci rilis kami. Itu memang seharusnya begitu.

Konsekuensi praktisnya: APK hasil build Anda tidak bisa menimpa (update) APK rilis kami secara langsung, karena Android menolak update dari penanda tangan berbeda. Hapus dulu versi lama sebelum memasang versi bangunan Anda.

Memasang hasil build

adb install -r app/build/outputs/apk/debug/app-debug.apk

Atau pindahkan berkas APK-nya ke HP dan buka seperti biasa. Setelah terpasang, lanjutkan dari Instalasi & pairing — aktifkan Aksesibilitas dan izin “tampilkan di atas aplikasi lain”, lalu pasangkan dengan kode dari dasbor.

Yang layak Anda periksa di kode

Kalau tujuan Anda mengaudit dan bukan sekadar mengompilasi, empat titik ini paling informatif:

1. Penangan perintah — daftar lengkap perintah yang diterima agent. Bandingkan dengan tabel di Izin & privasi; jangan percaya tabel kami kalau kodenya berbeda.
2. Klien koneksi — ke mana agent terhubung, dan data apa yang dikirim pada tiap heartbeat.
3. Serializer hierarki layar — apa yang diekstrak dari layar aplikasi target.
4. Penyimpanan lokal — apa yang disimpan permanen di perangkat (identitas perangkat dan konfigurasi pairing).

Kompatibilitas yang dipertahankan

Agent menghasilkan XML hierarki layar dengan format yang sama persis seperti keluaran uiautomator dump. Ini keputusan desain yang sengaja diambil: sisi server bisa memakai parser yang sudah ada dan teruji tanpa perlu mengubah penanganan platform.

Kalau Anda memodifikasi serializer, jaga format keluarannya — mengubahnya akan memutus sisi server.

Kontribusi

Issue dan pull request diterima di repo publik. Yang paling berguna:

• Laporan kompatibilitas perangkat, terutama Xiaomi, Oppo, Vivo, Realme, dan Samsung yang punya lapisan pembatas latar belakang sendiri.
• Perbaikan keandalan penyambungan ulang pada jaringan tidak stabil.
• Temuan keamanan pada agent.

Saat membuka issue, sertakan merek dan model HP, versi Android, versi agent, yang Anda harapkan, dan yang sebenarnya terjadi. Jangan sertakan kode pairing, token, kredensial, atau tangkapan layar yang memuat isi akun pribadi.

Untuk temuan yang menyangkut sisi server atau dasbor, laporkan secara privat ke support@bamsbung.id. Server dan dasbor berada di repo terpisah yang tertutup, jadi pull request untuk sisi itu tidak bisa diterima lewat repo publik ini — alasannya di Apa yang publik & apa yang tidak.

Langkah berikutnya

• Memasang dan memasangkan: Instalasi & pairing
• Apa yang dikirim agent: Izin & privasi
• Batas keterbukaan: Apa yang publik & apa yang tidak