Cara Menjalankan APK di Linux (Waydroid, Anbox, dan Lainnya)

Anda bisa menjalankan berkas APK di Linux dengan Waydroid, yang menjalankan Android di dalam kontainer pada desktop Anda dengan waktu mulai sekitar sepuluh detik. Alternatif tersedia untuk kasus tertentu: Genymotion dan Android Studio menjalankan Android di mesin virtual, dan Android-x86 me-boot-nya sebagai seluruh sistem operasi. Linux tidak memiliki runtime Android native, jadi setiap jalur di sini membangunnya sendiri.

Bisakah APK Dijalankan di Linux?

Lima jalur tersedia, dan satu di antaranya sudah mati. Waydroid adalah standar saat ini untuk penggunaan desktop, Genymotion dan Android Studio memenuhi kebutuhan pengembang, Android-x86 menjalankan Android sebagai sistem operasi dual-boot, dan Anbox sebaiknya dihindari sepenuhnya karena proyeknya di-deprecate pada Februari 2023.

Pilihannya berujung pada dua pertanyaan. Apakah Anda ingin Android di dalam jendela bersampingan desktop Anda, atau sebagai seluruh sistem? Dan apakah mesin Anda menjalankan Wayland, yang dibutuhkan Waydroid?

Metode 1: Waydroid

Waydroid menjalankan sistem Android berbasis LineageOS di dalam kontainer dan menggambar jendelanya melalui Wayland. Ia berbagi kernel Anda alih-alih me-boot mesin virtual penuh, sehingga ia mulai cepat dan memakai lebih sedikit memori daripada sebuah VM.

Pasang Waydroid di Distribusi Anda

Pengemasan kini ditangani oleh distribusi itu sendiri pada rilis terbaru:

• Ubuntu 26.10 dan Debian 14: tersedia di repositori. Pengguna Debian 13 menariknya dari backports.
• Fedora: sudo dnf install waydroid.
• Arch: paket waydroid dari repositori komunitas atau AUR.
• Void dan NixOS: paket komunitas tersedia dan didokumentasikan di halaman instalasi Waydroid.

Setiap baris memberi Anda perintah waydroid yang sama dan nama layanan yang sama. Rilis lama yang belum punya paket tetap terpasang melalui skrip yang didokumentasikan di situs Waydroid, setelahnya sisa panduan ini berlaku tanpa perubahan.

Sebelum mulai pertama, muat modul binder. Di Ubuntu dan Debian perintahnya sudo apt install waydroid plus reboot bila paket ikut menariknya; di Arch dan Fedora, pastikan binder_linux muncul di lsmod. Lalu inisialisasi sebuah citra dengan sudo waydroid init.

Pastikan Anda Berada di Wayland

Jalankan:

echo $XDG_SESSION_TYPE

Jika keluarannya x11, Waydroid akan gagal. Pada sesi Wayland, mulai layanannya dan buka kontainernya:

sudo systemctl enable --now waydroid-container
waydroid show-full-ui

Pasang APK di Waydroid

Dua jalur berfungsi. Klik kanan berkas di pengelola berkas Anda dan pilih Open With Waydroid, atau dorong dari terminal:

waydroid app install /path/to/file.apk

adb install juga berfungsi setelah Anda mengaktifkan debugging di dalam kontainer, yang dibahas di panduan instalasi ADB.

Keterbatasan Waydroid

Waydroid membawa celah terjemahan ARM. Sebuah citra x86 memasang paket x86 dan menolak paket khusus ARM dengan INSTALL_FAILED_NO_MATCHING_ABIS, yang merupakan kegagalan pemasangan paling umum di sini. Google Play juga membutuhkan citra dengan aplikasi Google yang sudah tertanam, dipilih selama waydroid init. Akselerasi GPU bergantung pada driver Anda: Mesa pada perangkat keras Intel dan AMD bekerja dengan baik, sementara driver NVIDIA lama membutuhkan stack proprietari beserta satu langkah konfigurasi manual.

Muat Modul Binder Setiap Boot

Waydroid membutuhkan modul kernel binder sebelum kontainernya mulai, dan sudo modprobe binder_linux hanya bertahan sampai reboot berikutnya, jadi tulis nama modul ke dalam konfigurasi boot distribusi Anda agar tetap termuat, jika tidak peluncuran pertama setelah restart gagal dengan kesalahan binder yang hilang.

Verifikasi setelah reboot dengan lsmod | grep binder. Satu baris yang diawali binder_linux berarti ia termuat. Tidak ada keluaran berarti sunting berkasnya lagi.

Jika sudo modprobe binder_linux menjawab dengan Module binder_linux not found, kernel yang berjalan sama sekali tidak mengirimkan dukungan binder. Pasang paket modul ekstra milik distribusi Anda atau pindah ke kernel yang menyertakan binder. Pemasangan ulang Waydroid mana pun tidak memperbaiki kernel yang kekurangan modul tersebut.

Jalankan Google Play di Dalam Waydroid

Citra Waydroid bawaan dikirim tanpa aplikasi Google, sehingga Play Store tidak pernah muncul di launcher sampai Anda menjalankan ulang sudo waydroid init, memilih opsi citra Open GApps saat diminta, dan me-restart kontainer agar citra baru termuat. Sampai itu berhasil, waydroid app install adalah satu-satunya jalur ke aplikasi mana pun.

1. Hentikan layanannya dengan sudo systemctl stop waydroid-container.
2. Jalankan sudo waydroid init dan pilih opsi citra Open GApps ketika ditanya.
3. Mulai layanannya dengan sudo systemctl start waydroid-container, lalu buka waydroid show-full-ui.
4. Masuk pada peluncuran pertama. Toko kemudian memasang dan memperbarui aplikasi seperti biasa.

Dua hal mengejutkan pengguna pertama kali. Paket Google menambahkan beberapa ratus megabyte ke unduhan citra, dan sebuah masuk akun bisa gagal selama registrasi kontainer ditolak. Keduanya biasanya teratasi setelah waydroid init kedua dan satu percobaan lagi. Aplikasi yang Anda sideload sementara itu tetap berfungsi melalui waydroid app install /path/to/file.apk.

Pasang Aplikasi Tanpa Play Store

Empat jalur memasukkan sebuah aplikasi ke Waydroid ketika Play Store tidak ada: sideload dengan waydroid app install, masuk ke klien toko anonim seperti Aurora Store, telusuri F-Droid untuk alat open source, atau bangun ulang citra dengan Open GApps selama waydroid init untuk toko penuh.

Perintah pengelolaannya pendek. waydroid app list menampilkan apa yang terpasang, waydroid app launch com.example.app membuka satu aplikasi, dan waydroid app remove com.example.app menghapusnya. Ketiganya berfungsi di setiap citra.

Build kedua dengan kunci tanda tangan yang berbeda mencetak INSTALL_FAILED_UPDATE_INCOMPATIBLE. Hapus paket lama terlebih dahulu, lalu pasang lagi. Aturan yang sama berlaku di ponsel.

Siapkan Grafis untuk Waydroid

Waydroid me-render melalui kompositor Anda, sehingga GPU Intel dan AMD membutuhkan driver open Mesa yang sudah dikirim sebagian besar distribusi, sementara kartu NVIDIA membutuhkan driver proprietari plus nvidia_drm.modeset=1 yang diatur di baris perintah kernel sebelum kontainer Waydroid mulai. Pengaturan yang salah muncul sebagai jendela hitam, kedipan berat, atau aplikasi yang keluar saat diluncurkan.

Dua perintah menunjukkan apa yang sebenarnya dipakai kontainer. Jalankan keduanya sebelum Anda mengganti driver.

glxinfo | grep "OpenGL renderer"
waydroid log | tail -50

Tiga kasus mencakup hampir setiap laporan. Mesa pada Intel dan AMD tidak membutuhkan konfigurasi apa pun. Stack NVIDIA proprietari berfungsi begitu modeset diatur di baris perintah kernel. Render software berfungsi di mana-mana dan berjalan lambat di mana-mana, jadi perlakukan itu sebagai pengujian, bukan perbaikan.

Dokumentasi Waydroid memuat catatan driver untuk setiap kasus. Bacalah sebelum menukar driver, karena pengaturan NVIDIA yang tidak cocok membutuhkan waktu lebih lama untuk dibongkar daripada frame rate yang lambat.

Perbarui Waydroid dan Sistem Citranya

Perbarui Waydroid dengan manajer paket Anda untuk alat kontainer dan dengan waydroid upgrade untuk citra Android, karena dua komponen bergerak dengan jadwal terpisah dan memperbarui hanya salah satunya meninggalkan ketidakcocokan yang merusak boot kontainer berikutnya. Rilis saat ini adalah 1.6.3 dari 28 Mei 2026, dan ia membawa dukungan awal untuk citra Android 16.

1. Perbarui paketnya dulu: sudo apt upgrade waydroid di Debian dan Ubuntu, sudo dnf upgrade waydroid di Fedora, sudo pacman -Syu waydroid di Arch.
2. Jalankan waydroid upgrade untuk menyegarkan sistem citra di dalam kontainer.
3. Konfirmasi hasilnya dengan waydroid version, yang mencetak nomor rilis yang terpasang.

Dua pembaruan itu independen. Paket baru tanpa waydroid upgrade meninggalkan citra Android lama di tempatnya. Penyegaran citra dengan paket lama bisa meninggalkan berkas layanan yang basi. Jalankan keduanya dalam sesi yang sama.

Restart kontainer setelahnya dengan sudo systemctl restart waydroid-container. Aplikasi yang terpasang menyimpan datanya melintasi upgrade biasa. Ekspor apa pun yang tidak tergantikan sebelum perubahan citra besar, karena data aplikasi bisa ikut terhapus.

Atur Ulang atau Hapus Waydroid

Instalasi Waydroid yang rusak biasanya membutuhkan pengaturan ulang citra alih-alih penghapusan paket, karena berkas Android rusak lebih sering daripada paketnya: hentikan kontainer, jalankan sudo waydroid init lagi untuk mengambil sistem citra segar, lalu pasang ulang APK Anda. Penghapusan lengkap membutuhkan tiga perintah dan menghapus setiap aplikasi di dalam kontainer.

Atur ulang dengan urutan ini. Setiap langkah menunggu langkah sebelumnya.

1. sudo systemctl stop waydroid-container
2. sudo waydroid init untuk menarik citra baru ke tempatnya
3. sudo systemctl start waydroid-container, lalu pasang APK Anda lagi

Bersihkan satu aplikasi alih-alih semuanya dengan menjalankan waydroid shell, lalu pm clear com.example.app di prompt Android. Waydroid juga menyimpan sakelar runtime di bawah awalan persist.waydroid., dan waydroid prop set persist.waydroid.multi_windows.on true mengubah satu di antaranya tanpa membangun ulang citra.

Untuk penghapusan lengkap, nonaktifkan layanannya dan hapus kedua direktori data. Apa pun yang tersimpan di kedua lokasi tidak selamat dari ini.

sudo systemctl disable --now waydroid-container
sudo apt remove waydroid
sudo rm -rf /var/lib/waydroid ~/.local/share/waydroid

Sesuaikan perintah manajer paket dengan distribusi Anda. Baris terakhir menghapus citra dan setiap aplikasi di dalamnya, jadi ekspor dulu apa pun yang Anda butuhkan.

Jalankan Aplikasi Android di Jendelanya Masing-masing

Waydroid bisa menempatkan setiap aplikasi di jendela yang bisa diubah ukurannya alih-alih satu tablet layar penuh, dan sakelarnya hanya sebuah properti, persist.waydroid.multi_windows.on, yang diatur ke true dan diikuti restart kontainer, setelahnya aplikasi Android berperilaku seperti program biasa di desktop Anda.

1. Jalankan waydroid prop set persist.waydroid.multi_windows.on true.
2. Restart kontainer dengan sudo systemctl restart waydroid-container.
3. Buka desktop dengan waydroid show-full-ui.
4. Luncurkan dua aplikasi dan seret tepi setiap jendela.

Periksa nilai saat ini dengan waydroid prop get persist.waydroid.multi_windows.on. Kembalikan dengan mengakhiri perintah yang sama dengan false. Tidak ada unduhan baru yang dibutuhkan dalam kedua kasus.

Game layar penuh masih mengklaim satu jendela. Multi-jendela cocok untuk aplikasi pesan, launcher, dan apa pun yang Anda inginkan bersampingan terminal.

Metode 2: Genymotion Desktop

Genymotion me-boot Android sebagai mesin virtual yang sungguhan, yang memakan lebih banyak memori daripada Waydroid dan sebagai gantinya menghadirkan citra x86 yang bersih. Edisi personal gratis untuk penggunaan individu, tanpa dukungan dan tanpa citra Android terbaru.

Pasang AppImage dari situs Genymotion, buat perangkat virtual, lalu seret APK Anda ke jendelanya. Ia berjalan di Windows, macOS, dan Linux, jadi alur kerja yang sama berlaku lintas mesin. Pilih ia ketika sebuah aplikasi menolak terpasang di bawah Waydroid karena alasan arsitektur.

Metode 3: Build Android-x86 dan Android TV

Android-x86 me-boot Android langsung pada perangkat keras PC dari stik USB, dual-boot bersama Linux. Ia menjalankan APK secara normal begitu Android menjadi sistem operasi, bukan tamu.

Statusnya perlu dinyatakan dengan jelas: rilis terbaru adalah 9.0-r2, bertanggal 25 Maret 2020, dan tidak ada build Android 10 atau lebih baru yang pernah dirilis dari proyek ini. Ia baik untuk perangkat keras lama dan tidak berguna pada mesin modern di mana Waydroid tersedia.

Dual-Boot Android-x86 Bersama Linux

Android-x86 terpasang seperti distribusi Linux mana pun: tulis ISO 9.0-r2 ke stik USB, boot, pilih Create or modify partitions, dan biarkan pemasang menambahkan entri GRUB yang boot Android bersampingan sistem Anda yang ada tanpa menyentuh berkas Anda. Seluruh pekerjaan memakan waktu sekitar 30 menit di disk cadangan.

Baca empat poin ini sebelum Anda mulai. Tiga di antaranya mencegah pemasangan ulang.

1. Tulis ISO dengan alat yang memverifikasi citra setelah penyalinan. Tulisan yang terpotong menghasilkan boot loop.
2. Beri Android partisinya sendiri, karena pemasang memformat target yang diberikan kepadanya.
3. Reboot dan pilih entri GRUB yang baru. Jika hilang, jalankan sudo update-grub dari Linux.
4. Pasang APK Anda dengan cara biasa setelah Android mencapai layar utama.

Dua batasan menentukan apakah ini sepadan. Rilis terbaru bertahan di 9.0-r2 bertanggal 25 Maret 2020, sehingga aplikasi yang meminta Android 10 atau lebih baru menolak terpasang. Perangkat keras yang sudah menjalankan Waydroid tidak punya alasan untuk menempuh jalur ini.

Boot Android-x86 di Mesin Virtual

Android-x86 9.0-r2 juga bisa boot di dalam mesin virtual, yang tidak memakan biaya apa pun, tidak menimbulkan risiko pada data di disk asli Anda, dan menyelesaikan penyiapan dalam sepuluh menit, sehingga Anda bisa menguji citra di desktop sebelum memutuskan untuk dual-boot-nya bersama Linux.

1. Buat mesin virtual dengan 4 GB RAM dan disk 8 GB. Atur tipenya ke Linux, Other Linux.
2. Pasang android-x86_64-9.0-r2.iso sebagai drive optik, lalu boot darinya.
3. Pilih Live CD - Run Android-x86 without installation terlebih dahulu. Desktop muncul dalam waktu sekitar satu menit dengan KVM aktif.
4. Pilih Installation hanya ketika Anda menginginkan Android di disk virtual.

QEMU melakukan pekerjaan yang sama dalam satu baris: qemu-system-x86_64 -enable-kvm -cpu host -m 4096 -cdrom android-x86_64-9.0-r2.iso. KVM harus bisa diakses di /dev/kvm, dan pengguna Anda harus berada di grup kvm. Tambahkan diri Anda dengan sudo usermod -aG kvm $USER, lalu keluar dan masuk kembali.

Mode live tidak menulis apa pun. Build tetap di 9.0-r2 dari 25 Maret 2020, sehingga aplikasi yang meminta Android 10 atau lebih baru masih menolak terpasang. Waydroid tetap lebih cepat pada apa pun yang menjalankan kernel terkini.

Metode 4: Emulator Android Studio

Emulator Android Studio berjalan di Linux persis seperti di Windows dan macOS. Buat sebuah AVD, pilih sebuah citra, boot, dan pasang APK Anda dengan menyeretnya ke jendelanya. Inilah jalur untuk pengembang dan bagi siapa pun yang membutuhkan level API tertentu untuk diuji.

Boot pertama mengunduh sistem citra satu hingga dua gigabyte, dan mulai dingin lebih lambat daripada Waydroid. Sebagai gantinya Anda mendapat build Google stok, level API terkini, dan tidak ada pengemasan komunitas yang harus di-debug.

Percepat Emulator Android Studio dengan KVM

Emulator Android Studio di Linux memakai KVM untuk kecepatan, dan tanpa itu sebuah perangkat virtual berjalan pada sebagian kecil dari kecepatannya, jadi periksa /dev/kvm, tambahkan pengguna Anda ke grup kvm, dan restart sesinya sebelum Anda membuat perangkat.

1. Konfirmasi CPU menawarkan virtualisasi: grep -Ec '(vmx|svm)' /proc/cpuinfo harus mencetak angka di atas nol.
2. Periksa node perangkat dengan ls -l /dev/kvm, lalu periksa grup Anda dengan groups.
3. Tambahkan diri Anda ke grup: sudo usermod -aG kvm $USER. Keluar dan masuk kembali, karena perubahan grup hanya berlaku untuk sesi baru.
4. Jika /dev/kvm hilang, pasang paket virtualisasi milik distribusi Anda, seperti qemu-kvm di Debian dan Ubuntu.

KVM penting karena emulator memulai mesin virtual yang sungguhan. Tanpa itu tamu jatuh ke terjemahan yang lambat, boot dingin membentang menjadi menit, dan game menjadi tidak bisa dimainkan. Buat AVD setelah perubahan grup, karena perangkat yang dibuat sebelum itu terus gagal di /dev/kvm dengan kesalahan izin.

Metode 5: Streaming Android Cloud

Ketika tidak ada yang lokal memasang aplikasi, sebuah perangkat cloud menyelesaikan pekerjaannya. Redfinger (redfinger.cloud) dan BlueStacks X (x.bluestacks.com) men-stream sesi Android jauh ke browser Anda, sehingga distribusi, kernel, dan GPU Anda berhenti menjadi penentu.

Ini cocok untuk perangkat keras lemah dan aplikasi yang hanya sesekali Anda buka. Ia membutuhkan langganan dan menambah latensi input yang terlihat pada game cepat.

Varian APK Mana yang Berfungsi di Linux

Arsitektur menentukan lebih banyak di Linux daripada di tempat lain, karena citra tamu memilih aturannya:

• Citra x86, APK x86. Muat langsung, kecepatan penuh. Inilah konfigurasi yang diberikan Genymotion dan Android-x86 kepada Anda.
• Citra x86, APK hanya-ARM. Gagal dengan INSTALL_FAILED_NO_MATCHING_ABIS. Waydroid tidak mengirimkan terjemahan ARM, jadi paketnya tidak punya pustaka untuk dimuat.
• Host arm64 dengan citra arm64. Kecepatan native, dan kasus yang umum pada komputer papan tunggal ARM seperti Raspberry Pi.

Ketika sebuah unduhan menawarkan beberapa berkas, ambil build x86 atau universal di desktop. Alasan di balik setiap nama ABI ada di ukuran berkas dan arsitektur APK.

Baca Persyaratan APK Sebelum Memasang

Baca persyaratan sebuah APK di Linux dengan perintah yang sama seperti di tempat lain: aapt dump badging file.apk mencetak versi Android minimum dan arsitektur CPU di dalam paket, dan dua baris itu menentukan apakah citra Waydroid x86 Anda menerima berkas tersebut.

Binernya dikirim bersama Android SDK di ~/Android/Sdk/build-tools/34.0.0/aapt, dan Android Studio membuat folder itu pada awal berjalan. Debian dan Ubuntu membawa alat yang sama sebagai paket aapt. Baca berkasnya sebelum Anda mendorongnya ke kontainer.

package: name='com.example.app'
sdkVersion:'26'
native-code: 'arm64-v8a'

Waydroid tidak punya terjemahan ARM. Sekali lihat baris arsitektur menghemat satu percobaan pemasangan ulang.

Kesalahan APK Linux yang Umum

Masalah binder menyebabkan sebagian besar pemasangan pertama yang gagal. Periksa itu sebelum memasang ulang apa pun.

Periksa Sesi dan Baca Log

Tiga perintah mendiagnosis sebagian besar kegagalan Waydroid di distribusi mana pun: waydroid status melaporkan apakah sesi dan kontainer sedang berjalan, waydroid log mencetak keluaran kontainer itu sendiri, dan sudo journalctl -u waydroid-container -e menunjukkan mengapa layanan systemd berhenti bahkan sebelum Anda membuka aplikasi apa pun. Jalankan keduanya dalam urutan itu sebelum Anda memasang ulang apa pun.

waydroid status mencetak baris yang penting: Session, Container, dan Vendor type. Baik Session maupun Container seharusnya bertuliskan RUNNING. Apa pun itu menjelaskan layar yang kosong.

Untuk detail, waydroid log men-tail keluaran kontainer dan sudo journalctl -u waydroid-container -e membuka riwayat layanan. Salin sepuluh baris terakhir sebelum Anda meminta bantuan. String kesalahannya biasanya ada di sana.

Bandingkan Waydroid, Genymotion, dan Android Studio

Pilih Waydroid untuk penggunaan desktop harian karena ia mulai dalam hitungan detik dan berbagi kernel Anda, pilih Genymotion ketika sebuah aplikasi menolak terpasang karena ia membutuhkan citra x86, dan pilih Android Studio ketika Anda harus menguji level API yang persis. Ketiganya tidak membiayai apa pun untuk cara kebanyakan orang memakainya.

Waydroid 1.6.3 dirilis pada 28 Mei 2026 dengan dukungan awal citra Android 16, sementara citra runtime-nya tetap Android 13 berbasis LineageOS. Genymotion dan Android Studio sebaliknya me-boot mesin virtual penuh, yang memakan lebih banyak memori dan sebagai gantinya membeli isolasi yang lebih baik.

Jalur Mana yang Harus Anda Pilih

Penggunaan harian jatuh ke Waydroid: ia mulai cepat, berbagi desktop Anda, dan terpasang dari repositori distribusi Anda sendiri. Pekerjaan pengembangan jatuh ke Android Studio. Aplikasi yang menolak terpasang di bawah Waydroid jatuh ke Genymotion untuk sebuah mesin virtual x86.

Mulailah dengan Waydroid, konfirmasi Anda berada di Wayland, dan muat binder sebelum peluncuran pertama. Panduan Raspberry Pi membahas alat yang sama pada perangkat keras ARM, dan panduan instalasi menangani izin dan paket split setelah APK Anda boot.