Install APK dari Mac dan debug Android — dengan atau tanpa terminal

Ada dua pekerjaan yang sama sekali berbeda di balik frasa "install APK dari Mac", dan sebagian besar panduan hanya menjawab salah satunya. Halaman ini menjawab keduanya, lalu membahas hal yang sebenarnya bikin orang tersendat setelah itu: membaca logcat, dan membuat macOS mengenali ponselnya sama sekali. Semua langkah di bawah bisa dijalankan dengan perintah adb biasa; di titik-titik yang GUI-nya memang benar-benar memangkas pekerjaan, kami sebutkan persis apa yang bisa dan tidak bisa dilakukannya. Diperbarui Agustus 2026.

Pertama: aplikasinya mau jalan di Mac, atau di ponsel?

Hasil pencarian untuk frasa ini terbelah dua, dan yang muncul di urutan teratas hanya melayani satu sisi saja. Artikel yang menjawab dengan "install BlueStacks / NoxPlayer / LDPlayer" sedang menjawab pertanyaan pertama: menjalankan software Android di macOS itu sendiri. Itu butuh emulator, dan di Apple Silicon pilihan realistis Anda adalah emulator bawaan Android Studio (gratis, dengan system image arm64) atau produk sejenis Google Play Games on PC — bukan emulator x86 lama.

Kalau yang ada di meja Anda justru sebuah ponsel atau tablet, dan file .apk ada di folder Downloads, Anda sama sekali tidak butuh emulator. Yang Anda perlukan adalah ADB — Android Debug Bridge — dan sebuah kabel. Sisa halaman ini membahas jalur itu.

1. Ingin menjalankan aplikasinya di Mac itu sendiri → pakai emulator; tidak ada satu pun langkah di bawah yang berlaku.
2. Ingin mengirim aplikasinya ke perangkat Android fisik yang terhubung ke Mac → lanjut baca.

Langkah nol: aktifkan proses debug USB (bagian ini dikerjakan di ponsel)

Tidak ada aplikasi Mac yang bisa menyalakan sakelar ini untuk Anda — Android memang sengaja mengharuskannya diaktifkan langsung di perangkat, dan koneksi pertama harus dikonfirmasi di layar ponsel. Siapa pun yang mengklaim sebaliknya, keliru.

Berbeda dengan Windows, macOS tidak memerlukan driver USB. Kalau perangkat tidak muncul, penyebabnya hampir selalu kabel yang hanya bisa mengisi daya, USB hub, atau dialog otorisasi yang belum dikonfirmasi.

1. Setelan → Tentang ponsel → ketuk Nomor build tujuh kali.
2. Kembali ke Setelan → Sistem → Opsi pengembang → aktifkan Proses debug USB.
3. Hubungkan ponsel ke Mac dengan kabel yang mendukung transfer data, langsung, bukan lewat hub.
4. Di ponsel, setujui "Izinkan proses debug USB?" dan centang "Selalu izinkan dari komputer ini".

Jalur terminal: adb install

Ini metode klasiknya, dan tetap layak dikuasai meski pada akhirnya Anda memakai GUI. Homebrew memasang binary platform-tools yang persis sama dengan yang dirilis Google.

Kegagalan yang paling sering muncul, terus terang saja: INSTALL_FAILED_UPDATE_INCOMPATIBLE berarti aplikasi dengan nama paket itu sudah terpasang tetapi ditandatangani dengan kunci berbeda — copot dulu yang lama. INSTALL_FAILED_VERSION_DOWNGRADE diatasi dengan menambahkan -d. "adb: no devices/emulators found" berarti langkah otorisasi di atas belum tuntas.

1. brew install --cask android-platform-tools
2. adb devices — nomor serinya harus tercantum sebagai device, bukan unauthorized atau offline.
3. adb install -r ~/Downloads/app.apk (opsi -r memasang ulang di atas salinan yang sudah ada, tanpa menghapus data).
4. Perhatikan keluaran Success; apa pun yang diawali INSTALL_FAILED_ adalah pesan error yang sebenarnya.

Jalur tanpa terminal: seret APK ke jendela aplikasi

Kalau Anda memang tidak berniat berlama-lama di terminal, instalasi Homebrew, penyuntingan PATH, dan ritual cd platform-tools hanyalah beban tambahan. Super ADB Manager menyertakan adb dan server scrcpy di dalam aplikasinya, jadi tidak ada yang perlu dipasang berdampingan dan tidak ada yang perlu diperbarui secara terpisah.

Aplikasinya gratis, tanpa akun, tanpa iklan, dan telemetri mati secara bawaan. Aplikasi ini ditandatangani dan dinotarisasi oleh Apple, jadi terbuka seperti biasa — bukan memaksa Anda memakai trik klik kanan lalu Buka, seperti pada tool tanpa tanda tangan yang beredar di situs agregator unduhan.

1. Unduh DMG-nya, seret aplikasinya ke folder Applications, lalu buka.
2. Colokkan ponselnya dan setujui permintaan proses debug USB (sama seperti di atas).
3. Pilih perangkatnya, buka tab Aplikasi, lalu tekan Instal APK atau langsung jatuhkan file .apk ke jendelanya.
4. Tab yang sama menampilkan daftar paket yang terpasang, dan bisa membukanya, menarik APK-nya kembali ke Mac, menghapus datanya, atau mencopot pemasangannya.

Split APK: base.apk plus file konfigurasi

Apa pun yang diunduh dari APKMirror sebagai App Bundle, atau diekspor oleh SAI, datang dalam bentuk beberapa file — base.apk plus split_config.arm64_v8a.apk, split_config.xxhdpi.apk, split bahasa, dan seterusnya. Memasang base.apk saja menghasilkan aplikasi yang crash saat dibuka atau tampil tanpa resource.

Semua bagian harus berasal dari build dan tanda tangan yang sama; mencampur versi pasti gagal. Kalau yang Anda punya adalah wadah .xapk atau .apks, ekstrak dulu — keduanya sebenarnya arsip ZIP — lalu pasang semua bagian hasil ekstraksinya sekaligus.

1. Terminal: adb install-multiple -r base.apk split_config.arm64_v8a.apk split_config.xxhdpi.apk
2. GUI: di jendela pemilih file, pilih semua bagiannya sekaligus, atau seret semuanya bersamaan ke jendela aplikasi — aplikasinya menjalankan install-multiple untuk Anda dan menampilkan jumlah bagian selama pemasangan.

Membaca logcat di Mac tanpa Android Studio

adb logcat jalan baik-baik saja sendirian, dan untuk berburu satu crash secara cepat, baris perintah sering kali sudah cukup. Masalahnya ada pada pembacaan yang berkelanjutan: logcat mentah menghasilkan ribuan baris per menit dari seluruh proses di perangkat.

Pilihan GUI di bidang ini sedikit dan kebanyakan sudah usang. Penampil logcat macOS yang paling dikenal adalah proyek Objective-C berumur satu dekade beserta fork-forknya, sebuah tool Tcl/Tk, dan beberapa utilitas Rust bergaya terminal yang lebih baru; ada satu pilihan komersial berbayar. Semuanya mengharapkan Anda memasang dan merawat platform-tools sendiri, dan sebagian besar tidak ditandatangani — di macOS 13 ke atas itu berarti bergulat dengan Gatekeeper sebelum satu baris log pun terlihat.

Di Super ADB Manager, tab Logcat menampilkan aliran langsung dari perangkat yang dipilih, lengkap dengan filter prioritas (Semua / Info+ / Warning+ / Error / Fatal), filter siap pakai untuk Crash, Jaringan, Sistem, dan aplikasi yang sedang berada di latar depan, pencarian teks bebas, pewarnaan, gulir otomatis, dan tombol bersihkan. Satu batasan yang perlu dikatakan terus terang: tampilan ini menyimpan 2000 baris terakhir di memori, jadi fungsinya adalah jendela debug langsung, bukan arsip sesi panjang — untuk perekaman penuh, alihkan keluaran adb logcat ke sebuah file.

1. adb logcat -v time — stempel waktu yang mudah dibaca.
2. adb logcat *:E — hanya error dan fatal.
3. adb logcat --pid=$(adb shell pidof -s com.example.app) — keluaran dari satu aplikasi saja.
4. adb logcat -c — bersihkan buffer sebelum mereproduksi bug.
5. adb logcat -v time > ~/Desktop/session.log — rekam semuanya ke sebuah file.

Ketika Mac tidak bisa melihat perangkatnya

Tidak ada halaman pemecahan masalah khusus macOS yang bermutu dan masih mutakhir untuk kasus ini, jadi berikut daftar periksanya dalam urutan yang benar-benar menyelesaikan masalah. Di sebagian model Samsung, Xiaomi, dan Honor, mode USB-nya juga harus diubah dari "Hanya mengisi daya" menjadi "Transfer file" lewat panel notifikasi sebelum ADB mau tersambung.

Kalau adb devices menampilkan nomor seri dengan kata unauthorized, ponselnya sebenarnya terhubung dan sehat — yang kurang hanya dialog konfirmasinya, atau dialog itu pernah ditolak sebelumnya. Mencabut otorisasi akan memaksanya muncul lagi.

1. Ganti kabelnya. Kabel USB-C yang hanya bisa mengisi daya adalah penyebab tunggal yang paling sering terjadi.
2. Colokkan langsung ke Mac; lewati hub, dock, dan port di monitor.
3. adb kill-server lalu adb devices untuk memulai ulang daemon-nya.
4. Opsi pengembang → Cabut otorisasi proses debug USB, lalu cabut dan colokkan kembali kabelnya.
5. system_profiler SPUSBDataType | grep -i -A4 android — kalau di sini tidak muncul apa pun, masalahnya ada di perangkat keras atau kabel, bukan di ADB.

Proses debug nirkabel dan perangkat non-ADB

Android 11 ke atas mendukung penyambungan lewat Wi-Fi dengan kode enam digit, dan ini benar-benar berguna saat port USB sedang terpakai atau perangkatnya terpasang di rig pengujian. Port penyambungan yang ditampilkan di ponsel sifatnya sementara dan berbeda dari port koneksinya. Kedua perangkat harus berada di subnet yang sama — Wi-Fi kantor dengan isolasi klien memblokirnya sepenuhnya. Di aplikasi, panel Nirkabel memindai jaringan lewat mDNS dan menerima kode penyambungannya; dan selama perangkat masih tersambung lewat USB, Pintasan → Beralih ke nirkabel menuntaskan seluruh peralihan itu dalam satu klik.

Terpisah dari itu, tidak semua perangkat bisa bicara ADB. Kindle serta banyak kamera atau pemutar media hanya membuka penyimpanannya lewat MTP, sementara Google sudah menghentikan Android File Transfer yang sampai sekarang masih direkomendasikan di mana-mana. Super ADB Manager punya bagian Perangkat MTP yang bisa menjelajah dan memindahkan file di perangkat semacam itu tanpa ADB. Catatannya: sesi MTP bisa putus kalau perangkatnya dicabut atau dikeluarkan di tengah transfer, dan Anda perlu menyambung ulang untuk melanjutkan.

Syarat dan batasannya, tanpa dibungkus-bungkus: versi 0.6.0, hanya Apple Silicon, macOS 13 Ventura atau lebih baru, sekitar 27 MB, sudah dinotarisasi. Perekaman layar bertumpu pada screenrecord milik Android dan tidak berfungsi di sebagian perangkat HONOR dan Huawei. Ini adalah alat pengelolaan perangkat dan pembacaan log, bukan pengganti debugger Android Studio — di sini tidak ada breakpoint maupun inspeksi variabel.

1. Ponsel: Opsi pengembang → Proses debug nirkabel → Sambungkan perangkat dengan kode penyambungan.
2. Mac: adb pair 192.168.1.20:41234 lalu masukkan kode enam digitnya.
3. adb connect 192.168.1.20:5555 untuk menyambung dan bekerja dengan ADB seperti biasa.
4. Atau pakai panel Nirkabel di aplikasi: pindai, klik perangkatnya, ketik kodenya.

Tanya Jawab

Panduan lainnya