Membangun Agent 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

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

Butuh Android SDK terpasang dan JDK 17.

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

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

# Release APK (tanpa tanda tangan kami)
./gradlew assembleRelease

Di Windows pakai gradlew.bat.

Soal penandatanganan

Build lokal Anda akan 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 Langkah 3 di panduan pemasangan — aktifkan Accessibility Service lalu pasangkan dengan kode pairing.

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 WebSocket — 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 (device_id 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: server bisa memakai parser yang sudah ada dan teruji tanpa perlu mengubah adapter platform sama sekali.

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, dan Samsung yang punya lapisan pembatas latar belakang sendiri
• Perbaikan keandalan reconnect pada jaringan tidak stabil
• Temuan keamanan — laporkan lewat issue repo publik

Server dan dasbor GoSosmed berada di repo terpisah yang tertutup, jadi PR untuk sisi itu tidak bisa kami terima lewat repo ini. Alasannya di Apa yang Publik & Apa yang Tidak.