Instalasi, Pairing & ADB Loopback

Halaman ini memandu Anda memasang APK Mobile Agent, melewati tiga lapisan pembatasan Android yang akan Anda temui, memverifikasi keaslian biner, mengaktifkan izin yang diperlukan, hingga menghubungkan perangkat ke dasbor GoSosmed.

Versi terbaru selalu di halaman rilis

Dokumen ini sengaja tidak mengunci nomor versi, karena versi berubah setiap rilis. Versi terbaru selalu ada di halaman rilis resmi. Nomor versi yang resmi hanyalah yang tertulis di halaman itu dan di app/build.gradle.kts.

---

Ringkasan: apa yang akan Anda hadapi

Android memblokir aplikasi dari luar Play Store dalam tiga lapisan terpisah. Ini bukan tanda APK-nya berbahaya — ini perilaku bawaan Android untuk semua aplikasi sideload. Bedakan gejalanya, karena obatnya berbeda:

Yang Anda lihat di layar HP	Nama sebenarnya	Kapan muncul	Sifat
“Demi keamanan, ponsel Anda tidak diizinkan memasang aplikasi yang tidak dikenal”	Install unknown apps	Saat memasang	Sekali aktif, beres selamanya
“Aplikasi tidak dipasang” / “App not installed”, atau tombol Install anyway	Play Protect	Saat memasang	Bisa dilewati
“App was denied access” — “Access to this permission can put your personal and financial info at risk”	Restricted Settings	Setelah terpasang, saat menyalakan Aksesibilitas	Dibuka manual, sekali per aplikasi

Jangan berhenti di lapisan ketiga

Dua blokir pertama terjadi saat memasang. Blokir ketiga terjadi setelah aplikasi terpasang dengan benar. Inilah sebabnya banyak orang bingung dan mengira aplikasinya rusak — padahal instalasi sudah sukses, hanya izinnya belum dibuka. Instalasi sukses tidak sama dengan izin terbuka. Lihat Langkah 2C.

---

Sebelum Memulai

Kebutuhan	Keterangan
HP Android Fisik	Android 9 (Pie) hingga Android 15. Disarankan perangkat fisik riil, bukan emulator.
Koneksi Internet	Wi-Fi atau data seluler aktif (hanya butuh koneksi keluar).
Akun GoSosmed	Untuk login ke dasbor di app.bamsbung.id dan menerbitkan kode pairing.
Akses Root	Tidak diperlukan sama sekali. Jangan me-root HP Anda.
Waktu	Sekitar 10 menit, termasuk mengaktifkan izin.

---

Langkah 1 — Unduh APK Resmi

Unduh biner APK resmi langsung dari rilis publik GitHub:

Buka halaman rilis resmi (GitHub Releases)

Di halaman itu, unduh berkas app-release.apk dari rilis terbaru (yang tidak ditandai Pre-release). Bila Anda ingin mengompilasi sendiri dari kode sumber terbuka, ikuti panduan di Kompilasi APK dari Sumber.

Keamanan Biner APK

Agent memerlukan izin Aksesibilitas — izin terkuat di Android, yang bisa membaca seluruh layar Anda. Pasang APK hanya dari halaman rilis resmi di GitHub atau biner yang Anda bangun sendiri. Jangan pernah memasang APK GoSosmed dari grup pesan instan, tautan kiriman, atau situs unduhan APK pihak ketiga.

Verifikasi Keaslian (Disarankan)

Setiap rilis resmi ditandatangani dengan kunci yang sama dan menyertakan berkas SHA256SUMS.txt. Cocokkan checksum sebelum memasang:

# Linux / macOS
sha256sum app-release.apk

# Windows PowerShell
Get-FileHash -Algorithm SHA256 .\app-release.apk

Bandingkan hasilnya dengan nilai di berkas SHA256SUMS.txt pada halaman rilis yang sama.

Untuk pemeriksaan yang lebih kuat, cocokkan sidik jari sertifikat penandatangan:

apksigner verify --print-certs app-release.apk
# atau, bila tidak punya apksigner:
keytool -printcert -jarfile app-release.apk

Kenapa ini penting

Android sendiri tidak bisa memberi tahu Anda bahwa APK ini asli. Verifikasi checksum adalah satu-satunya cara Anda memastikannya. Bila checksum tidak cocok, jangan pasang berkas itu.

---

Langkah 2 — Pasang APK di HP Android

Langkah 2A — Mengatasi “aplikasi tidak dikenal” (Install unknown apps)

1. Buka berkas APK yang sudah diunduh di HP Android Anda.
2. Jika muncul peringatan “Demi keamanan, ponsel Anda tidak diizinkan memasang aplikasi yang tidak dikenal dari sumber ini”, ketuk Setelan pada dialog itu.
3. Nyalakan sakelar untuk aplikasi yang Anda pakai membuka APK — biasanya Chrome, Files, atau Pengelola Berkas.
4. Kembali, lalu ketuk Pasang.

Cukup sekali. Setelah ini peringatan tersebut tidak muncul lagi untuk aplikasi itu.

Langkah 2B — Mengatasi blokir Play Protect

Play Protect memeriksa setiap aplikasi yang dipasang dari luar Play Store. APK GoSosmed baru dirilis dan belum dikenal Google, jadi verdict-nya bisa “tidak aman” walaupun APK-nya benar.

Cara 1 — lewati saja (paling cepat):

1. Saat muncul layar blokir, cari dan ketuk “Install anyway” / “Tetap pasang” / “Pasang saja”. Tombol ini selalu ada — blokir Play Protect bukan blokir mutlak.
2. Selesai.

Cara 2 — matikan Play Protect sementara (bila tombol Install anyway tidak muncul):

1. Buka Play Store → ketuk foto profil Anda (kanan atas).
2. Pilih Play Protect → ketuk ikon roda gigi ⚙️ (kanan atas).
3. Matikan “Scan apps with Play Protect”. (Baris “Improve harmful app detection” tidak perlu dimatikan — baris itu hanya mengirim sampel ke Google, tidak memblokir instalasi.)
4. Pasang APK-nya.
5. Nyalakan kembali Play Protect. Play Protect tidak akan menghapus aplikasi yang sudah terpasang, jadi mematikannya cukup sebentar.

Cara 3 — tanpa internet (bila Anda tidak ingin menyentuh setelan Play Protect):

1. Aktifkan Mode Pesawat.
2. Pasang APK-nya — tanpa koneksi, Play Protect tidak bisa memutuskan apa pun.
3. Matikan Mode Pesawat.

Bila aplikasi sampai dihapus otomatis oleh Play Protect

Buka Play Store → Play Protect → ⚙️ → Recent harmful app activity, cari GoSosmed Agent, lalu pilih untuk mengizinkannya kembali (allow). Setiap notifikasi penghapusan selalu menyediakan tombol ini.

Langkah 2C — Mengatasi “App was denied access” (Restricted Settings)

Ini penyebab paling sering orang menyerah

Android 13 ke atas membatasi izin “sensitif” — termasuk Aksesibilitas — hanya untuk aplikasi yang dipasang dari Play Store. Aplikasi yang di-sideload harus dibuka kuncinya secara manual, satu kali, per aplikasi.

Gejalanya: Anda sudah menekan toggle GoSosmed Agent di halaman Aksesibilitas, lalu muncul dialog:

App was denied access Access to this permission can put your personal and financial info at risk. It’s possible the app won’t work properly without this restricted permission.

Ada juga tautan “Learn how to allow access” di dialog itu — ketuk itu, dan Android akan membawa Anda langsung ke langkah yang benar.

Cara membuka kuncinya:

1. Buka Setelan Android → Aplikasi → Kelola aplikasi (atau Semua aplikasi).
2. Cari dan ketuk Agent GoSosmed.
3. Ketuk ikon tiga titik ⋮ di kanan atas halaman App info.
4. Pilih “Allow restricted settings” / “Izinkan setelan yang dibatasi”.
5. Android akan meminta sidik jari, PIN, atau pola Anda. Selesaikan.
6. Baru sekarang kembali ke Setelan → Aksesibilitas → Agent GoSosmed dan nyalakan toggle-nya. Kali ini berhasil.

Menu ⋮ hanya bisa dibuka SEKALI

Bila Anda menutupnya tanpa menekan “Allow restricted settings”, menu itu hilang dan tidak ada cara memunculkannya kembali dari layar HP. Bila itu terjadi, satu-satunya jalan adalah lewat komputer dengan ADB:

adb shell appops set com.gososmed.agent SYSTEM_ALERT_WINDOW allow
adb reboot

Jangan menutup menu itu sebelum Anda menekan “Allow restricted settings”.

Catatan versi Android

Batasan ini berlaku sejak Android 13 (API 33). Pada Android 14 dan 15 pembatasannya lebih ketat lagi, dan beberapa merek (Xiaomi/HyperOS, Oppo/ColorOS, Vivo, Samsung) menambahkan lapisan persetujuan mereka sendiri di atasnya. Bila cara di atas tetap gagal, lihat Pemecahan Masalah.

Langkah 2D — Buka aplikasi

Setelah terpasang, buka aplikasi Agent GoSosmed. Pada pembukaan pertama, Anda akan disambut dialog Trust & Legal Center yang menjelaskan komitmen privasi dan lisensi keterbukaan kode.

---

Langkah 3 — Aktifkan Izin Wajib

Aplikasi memiliki tab Setup yang menampilkan status setiap izin secara jujur. Ikuti kartu di tab itu — halaman ini menjelaskan konteksnya.

3A — Layanan Aksesibilitas (WAJIB)

Aksesibilitas adalah mesin utama (Inspection Engine) yang membaca struktur layar aplikasi target.

1. Buka aplikasi Agent GoSosmed → tab Setup.
2. Pada kartu “Akses otomatisasi (Aksesibilitas)”, ketuk Aktifkan.
3. Android membuka Setelan → Aksesibilitas. Cari Agent GoSosmed di bagian Layanan terpasang (Downloaded / Installed services), lalu aktifkan.
4. Android menampilkan peringatan standar. Ketuk Izinkan / OK.
   • Bila yang muncul justru “App was denied access”, Anda belum melewati Langkah 2C. Kembali ke sana dulu.
5. Kembali ke aplikasi. Statusnya sekarang harus AKTIF ✓.

Mengapa Android Menampilkan Peringatan?

Android menampilkan peringatan standar bahwa Aksesibilitas dapat membaca konten layar. Ini wajar dan merupakan prasyarat otomasi tanpa root. Anda dapat memverifikasi kode pembacaan layar di repositori terbuka kami.

3B — “Tampilkan di Atas Aplikasi Lain” (WAJIB)

Izin ini wajib agar agent dapat memicu peluncuran aplikasi media sosial dari latar belakang. Sejak Android 10, tanpa izin ini Android diam-diam menolak pembukaan aplikasi — tanpa pesan error apa pun. Gejalanya terlihat seperti “tidak terjadi apa-apa”.

1. Masih di tab Setup, cari kartu izin tampilan → ketuk Aktifkan.
2. Android membuka daftar aplikasi. Cari Agent GoSosmed.
3. Aktifkan sakelar menjadi Diizinkan.

Catatan untuk pengguna Xiaomi, Redmi, dan POCO: Aktifkan juga izin Mulai Otomatis (Autostart) dan Tampilkan jendela pop-up saat berjalan di latar belakang pada menu Pengelola Izin MIUI/HyperOS.

Setelah Langkah 3A dan 3B selesai, Anda sudah bisa memakai aplikasi.

---

Langkah 4 — Pasangkan Perangkat ke Akun (Pairing Dasbor)

1. Buka dasbor GoSosmed di komputer Anda (app.bamsbung.id).
2. Klik tombol Tambah Perangkat / Pair Device untuk menerbitkan Kode Pairing 6 Digit (contoh: 849-201).
3. Buka aplikasi Agent GoSosmed di HP, masukkan kode tersebut ke kolom pairing, lalu ketuk Hubungkan.
4. Aplikasi akan membuka koneksi WebSocket keluar yang aman ke server.
5. Dalam beberapa detik, status perangkat di dasbor akan berubah menjadi Online (Hijau).

Setelah berhasil, identitas perangkat tersimpan secara permanen di ponsel. Anda tidak perlu memasangkan ulang setiap hari; jika koneksi terputus karena jaringan, agent akan menyambung ulang secara otomatis.

---

Langkah 5 — Otomasi Lanjutan / ADB Loopback (OPSIONAL)

Lewati dulu langkah ini

Selesaikan Langkah 1–4, coba pakai aplikasinya, dan baru kembali ke sini bila ada aplikasi target yang gagal dibuka otomatis (terutama TikTok). Sebagian besar pemakaian tidak memerlukan ini.

Kenapa ini ada

Beberapa aplikasi — terutama TikTok — menolak dibuka dengan cara biasa. Untuk membukanya dengan andal, GoSosmed perlu hak khusus yang setara dengan perintah adb shell, hak yang sama yang dipakai alat pengembang Android. Hak itu hanya bisa didapat lewat Debug nirkabel bawaan Android.

Yang perlu Anda tahu dulu

• Ini koneksi di dalam HP Anda sendiri (loopback), bukan ke server GoSosmed. Tidak ada data yang dikirim ke luar karena langkah ini.
• Harus diulang setiap HP reboot. Android otomatis mematikan Debug nirkabel saat HP dinyalakan ulang. Ini perilaku Android, bukan aplikasi kita.
• Bila tidak dilakukan, aplikasi tetap berfungsi — hanya dengan kemampuan terbatas, dan UI akan mengatakannya secara jujur.

5A — Membuka Mode Pengembang (untuk yang belum pernah)

Mode Pengembang adalah menu tersembunyi Android. Membukanya aman dan tidak menghapus data Anda.

1. Buka Setelan Android.
2. Cari dan buka Tentang ponsel (About phone).
   • Umumnya: Setelan → Tentang ponsel → Informasi perangkat lunak.
3. Cari baris “Nomor build” (Build number).
   • Xiaomi / HyperOS: cari “Versi MIUI” / “Versi HyperOS”.
   • Oppo / Vivo / Realme: cari “Nomor versi” (Version number).
   • Samsung: Setelan → Tentang ponsel → Informasi perangkat lunak → Nomor build.
4. Ketuk baris itu 7 kali berturut-turut.
5. Setelah 3–4 ketukan, muncul hitungan: “Anda berada 4 langkah lagi untuk menjadi pengembang”. Teruskan sampai muncul “Anda sekarang seorang pengembang”.
6. Bila diminta PIN/pola/fingerprint, masukkan.
7. Kembali ke Setelan utama → Sistem → Opsi Pengembang (Developer options).
   • Xiaomi / HyperOS: Setelan → Tambahan → Opsi Pengembang.
   • Samsung: paling bawah Setelan → Opsi Pengembang.

5B — Mengaktifkan Debug Nirkabel & pairing

1. Di Opsi Pengembang, cari Proses Debug Nirkabel (Wireless debugging) dan nyalakan.
2. Ketuk baris Proses Debug Nirkabel untuk masuk.
3. Pilih “Pasangkan perangkat dengan kode pairing” (Pair device with pairing code).
4. Layar HP menampilkan IP, Port dinamis, dan 6 digit kode pairing. Biarkan layar ini terbuka.
5. Buka aplikasi Agent GoSosmed → kartu ADB Loopback.
6. Masukkan port dan kode pairing yang tampil di layar HP, lalu ketuk Sambungkan Loopback.
7. Layar akan mengonfirmasi bahwa transport loopback lokal telah aktif.

Loopback Lokal 100% Bebas PC

Hubungan ADB ini sepenuhnya terjadi di dalam internal HP (internal loopback). Ponsel tidak membutuhkan komputer kabel data, dan koneksi loopback ini tidak terekspos ke jaringan luar.

---

Setelah Terpasang — Menjaga Kestabilan

Tiga setelan ini yang paling menentukan apakah agent tetap hidup:

1. Baterai → Tidak Dibatasi. Buka Setelan → Aplikasi → Agent GoSosmed → Baterai, pilih Tidak Dibatasi (Unrestricted). Ini penyebab nomor satu agent berhenti sendiri.
2. Autostart / Auto-launch (khusus Xiaomi, Oppo, Vivo, Realme, Transsion). Tanpa ini, sistem mematikan agent saat layar mati.
3. Kunci dari pembersih RAM. Buka menu Recents, tekan lama kartu Agent GoSosmed, lalu ketuk ikon gembok agar tidak terhapus saat pembersihan memori.

Panduan lengkap per merek HP ada di Pemecahan Masalah & Baterai.

---

Langkah Selanjutnya

• Pemecahan Masalah & Baterai — Solusi per merek HP untuk agent yang berhenti sendiri, dan cara membaca setiap pesan error.
• Izin, Privasi & Trust Center — Pelajari apa saja yang disensor secara native oleh agent.
• Navigasi Cockpit AI — Pantau perangkat secara visual dari dasbor web.