Como rodar APK no Linux (Waydroid, Anbox e mais)

Você pode rodar arquivos APK no Linux com o Waydroid, que roda Android dentro de um contêiner no seu desktop com cerca de dez segundos de inicialização. Existem alternativas para casos específicos: o Genymotion e o Android Studio rodam Android em uma máquina virtual, e o Android-x86 inicializa ele como o sistema operacional inteiro. O Linux não tem nenhum runtime de Android nativo, então todo caminho aqui constrói um.

Você consegue rodar APK no Linux?

Existem cinco caminhos, e um deles está morto. O Waydroid é o padrão atual para uso em desktop, o Genymotion e o Android Studio cobrem necessidades de desenvolvedor, o Android-x86 roda Android como sistema de dual boot, e o Anbox deve ser evitado por completo, já que o projeto foi descontinuado em fevereiro de 2023.

A escolha se resume a duas perguntas. Você quer Android em uma janela ao lado do seu desktop ou como o sistema inteiro? E a sua máquina roda Wayland, que o Waydroid exige?

Método 1: Waydroid

O Waydroid roda um sistema Android baseado em LineageOS dentro de um contêiner e desenha as janelas dele pelo Wayland. Ele compartilha o seu kernel em vez de inicializar uma máquina virtual completa, então começa rápido e usa menos memória que uma VM.

Instale o Waydroid na sua distribuição

O empacotamento agora é feito pelas próprias distribuições em versões recentes:

• Ubuntu 26.10 e Debian 14: disponíveis nos repositórios. Usuários do Debian 13 o pegam nos backports.
• Fedora: sudo dnf install waydroid.
• Arch: o pacote waydroid do repositório da comunidade ou do AUR.
• Void e NixOS: pacotes comunitários existem e estão documentados nas páginas de instalação do Waydroid.

Cada linha te dá o mesmo comando waydroid e o mesmo nome de serviço. Versões mais antigas sem pacote ainda instalam pelo script documentado no site do Waydroid, e depois disso o restante deste guia se aplica sem mudanças.

Antes da primeira inicialização, carregue os módulos binder. No Ubuntu e no Debian é sudo apt install waydroid mais um reinício se o pacote os puxar; no Arch e no Fedora, confirme que binder_linux aparece no lsmod. Depois inicialize uma imagem com sudo waydroid init.

Confirme que você está no Wayland

Rode:

echo $XDG_SESSION_TYPE

Se ele imprimir x11, o Waydroid vai falhar. Em uma sessão Wayland, inicie o serviço e abra o contêiner:

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

Instale um APK no Waydroid

Dois caminhos funcionam. Clique com o botão direito no arquivo no seu gerenciador de arquivos e escolha Open With Waydroid, ou envie de um terminal:

waydroid app install /path/to/file.apk

O adb install também funciona uma vez que você habilite a depuração dentro do contêiner, o que está coberto no guia de instalação por ADB.

Limitações do Waydroid

O Waydroid entrega uma lacuna de tradução de ARM. Uma imagem x86 instala pacotes x86 e rejeita os só de ARM com INSTALL_FAILED_NO_MATCHING_ABIS, que é a falha de instalação mais comum aqui. A Google Play também precisa de uma imagem com os apps do Google embutidos, escolhida durante o waydroid init. A aceleração de GPU depende do seu driver: Mesa em hardware Intel e AMD funciona bem, enquanto drivers NVIDIA mais antigos precisam da pilha proprietária e de um passo de configuração manual.

Carregue os módulos binder em toda inicialização

O Waydroid precisa do módulo de kernel binder antes de o contêiner iniciar, e o sudo modprobe binder_linux dura só até o próximo reinício, então escreva o nome do módulo na configuração de inicialização da sua distribuição para mantê-lo carregado, caso contrário a primeira execução depois de reiniciar falha com um erro de binder ausente.

Verifique depois do reinício com lsmod | grep binder. Uma linha começando com binder_linux significa que ele carregou. Sem saída significa editar o arquivo de novo.

Se sudo modprobe binder_linux responder com Module binder_linux not found, o kernel em execução não traz suporte a binder nenhum. Instale o pacote de módulos extras da sua distribuição ou mude para um kernel que inclua binder. Reinstalar o Waydroid não conserta um kernel que não tem o módulo.

Rode a Google Play dentro do Waydroid

A imagem padrão do Waydroid vem sem os apps do Google, então a Play Store nunca aparece no launcher até você rodar sudo waydroid init de novo, escolher a opção da imagem Open GApps no prompt e reiniciar o contêiner para carregar a nova imagem. Até isso dar certo, waydroid app install é o único caminho para qualquer app.

1. Pare o serviço com sudo systemctl stop waydroid-container.
2. Rode sudo waydroid init e escolha a opção da imagem Open GApps quando perguntado.
3. Inicie o serviço com sudo systemctl start waydroid-container e depois abra waydroid show-full-ui.
4. Entre na primeira inicialização. A loja então instala e atualiza apps como sempre.

Duas coisas surpreendem os iniciantes. O pacote do Google acrescenta several centenas de megabytes ao download da imagem, e um login pode falhar enquanto o registro do contêiner é recusado. Ambos normalmente se resolvem depois de um segundo waydroid init e de nova tentativa. Os apps que você fizer sideload nesse meio tempo continuam funcionando pelo waydroid app install /path/to/file.apk.

Instale apps sem a Play Store

Quatro caminhos colocam um app no Waydroid quando a Play Store não está ali: sideload com waydroid app install, login em um cliente de loja anônimo como o Aurora Store, navegação no F-Droid por ferramentas de código aberto ou reconstrução da imagem com Open GApps durante o waydroid init para ter a loja completa.

Os comandos de gerenciamento são curtos. waydroid app list mostra o que está instalado, waydroid app launch com.example.app abre um, e waydroid app remove com.example.app apaga. Os três funcionam em qualquer imagem.

Uma segunda build com outra chave de assinatura imprime INSTALL_FAILED_UPDATE_INCOMPATIBLE. Remova o pacote antigo primeiro e depois instale de novo. A mesma regra vale nos celulares.

Configure os gráficos do Waydroid

O Waydroid renderiza pelo seu compositor, então GPUs Intel e AMD precisam do driver aberto Mesa, que a maioria das distribuições já traz, enquanto placas NVIDIA precisam do driver proprietário mais nvidia_drm.modeset=1 definido na linha de comando do kernel antes de o contêiner do Waydroid iniciar. Uma configuração errada aparece como uma janela preta, pisqueira forte ou um app que fecha na inicialização.

Dois comandos mostram o que o contêiner realmente usa. Rode os dois antes de trocar de driver.

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

Três casos cobrem quase todo relato. Mesa em Intel e AMD não precisa de configuração nenhuma. A pilha proprietária da NVIDIA funciona uma vez que o modeset está na linha de comando do kernel. A renderização por software funciona em todo lugar e roda lenta em todo lugar, então trate isso como um teste, não como uma correção.

A documentação do Waydroid traz as notas de driver para cada caso. Leia-as antes de trocar de driver, porque uma configuração NVIDIA divergente leva mais tempo para desfazer do que uma taxa de quadros lenta.

Atualize o Waydroid e a imagem de sistema dele

Atualize o Waydroid com o seu gerenciador de pacotes para as ferramentas do contêiner e com waydroid upgrade para a imagem de Android, porque os dois componentes andam em cronogramas separados e atualizar só um deles deixa um desalinhamento que quebra a próxima inicialização do contêiner. O lançamento atual é o 1.6.3, de 28 de maio de 2026, e ele trouxe suporte inicial a imagens do Android 16.

1. Atualize o pacote primeiro: sudo apt upgrade waydroid no Debian e no Ubuntu, sudo dnf upgrade waydroid no Fedora, sudo pacman -Syu waydroid no Arch.
2. Rode waydroid upgrade para atualizar a imagem de sistema dentro do contêiner.
3. Confirme o resultado com waydroid version, que imprime o número da release instalada.

As duas atualizações são independentes. Um pacote novo sem waydroid upgrade deixa a imagem de Android antiga no lugar. Uma atualização de imagem com um pacote antigo pode deixar um arquivo de serviço veloz para trás. Rode as duas na mesma sessão.

Reinicie o contêiner depois com sudo systemctl restart waydroid-container. Os apps instalados mantêm os dados ao longo de uma atualização comum. Exporte anything irreparável antes de uma mudança grande de imagem, porque os dados do app podem ser apagados junto.

Redefina ou desinstale o Waydroid

Uma instalação quebrada do Waydroid normalmente precisa de uma redefinição de imagem em vez da remoção do pacote, porque os arquivos de Android corrompem com mais frequência do que o pacote: pare o contêiner, rode sudo waydroid init de novo para puxar uma imagem de sistema nova e reinstale seu APK. A remoção completa leva três comandos e apaga todo app dentro do contêiner.

Redefina nesta ordem. Cada passo espera o anterior.

1. sudo systemctl stop waydroid-container
2. sudo waydroid init para puxar uma imagem nova
3. sudo systemctl start waydroid-container e depois instale seu APK de novo

Limpe um único app em vez de tudo rodando waydroid shell e depois pm clear com.example.app no prompt do Android. O Waydroid também guarda chaves de runtime sob o prefixo persist.waydroid., e waydroid prop set persist.waydroid.multi_windows.on true muda uma delas sem reconstruir a imagem.

Para remover por completo, desabilite o serviço e apague os dois diretórios de dados. Nada guardado em nenhum dos locais sobrevive a isso.

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

Troque o comando do gerenciador de pacotes para o da sua distribuição. A última linha apaga a imagem e todo app dentro dela, então exporte primeiro o que você precisa.

Rode apps Android nas próprias janelas

O Waydroid pode colocar cada app em uma janela redimensionável em vez de um tablet de tela cheia, e a troca é uma única propriedade, persist.waydroid.multi_windows.on, definida como true e seguida de um reinício do contêiner, depois do qual os apps Android se comportam como programas comuns no seu desktop.

1. Rode waydroid prop set persist.waydroid.multi_windows.on true.
2. Reinicie o contêiner com sudo systemctl restart waydroid-container.
3. Abra o desktop com waydroid show-full-ui.
4. Abra dois apps e arraste as bordas de cada janela.

Confira o valor atual com waydroid prop get persist.waydroid.multi_windows.on. Volte ao anterior terminando o mesmo comando com false. Nenhum download novo é necessário em nenhum dos casos.

Jogos em tela cheia ainda ocupam uma janela. O multi-janela serve para apps de mensagens, launchers e qualquer coisa que você queira ao lado de um terminal.

Método 2: Genymotion Desktop

O Genymotion inicializa Android como uma máquina virtual de verdade, o que custa mais memória que o Waydroid e entrega em troca uma imagem x86 limpa. A edição pessoal é gratuita para uso individual, sem suporte e sem as imagens de Android mais recentes.

Instale o AppImage do site do Genymotion, crie um dispositivo virtual e depois arraste seu APK para a janela. Ele roda em Windows, macOS e Linux, então o mesmo fluxo serve em qualquer máquina. Escolha ele quando um app se recusa a instalar no Waydroid por motivo de arquitetura.

Método 3: Android-x86 e builds de Android TV

O Android-x86 inicializa Android direto no hardware do PC a partir de um pendrive USB, em dual boot ao lado do Linux. Ele roda APKs normalmente uma vez que Android é o sistema operacional em vez de um convidado.

O status dele vale declarar de forma direta: o lançamento mais recente é 9.0-r2, datado de 25 de março de 2020, e nenhuma build do Android 10 ou mais nova saiu do projeto. Ele é fine para hardware antigo e inútil em uma máquina moderna onde o Waydroid está disponível.

Dual boot do Android-x86 com Linux

O Android-x86 instala como qualquer distribuição Linux: grave a ISO 9.0-r2 em um pendrive USB, inicialize-a, escolha Create or modify partitions e deixe o instalador adicionar uma entrada do GRUB que inicializa o Android ao lado do seu sistema existente sem tocar nos seus arquivos. O trabalho inteiro leva cerca de 30 minutos em um disco sobrando.

Leia estes quatro pontos antes de começar. Três deles evitam uma reinstalação.

1. Grave a ISO com uma ferramenta que verifique a imagem depois de copiar. Uma gravação truncada produz um boot loop.
2. Dê ao Android a própria partição, porque o instalador formata o destino que recebe.
3. Reinicie e selecione a nova entrada do GRUB. Quando ela faltar, rode sudo update-grub a partir do Linux.
4. Instale seu APK do jeito normal quando o Android chegar à tela inicial.

Dois limites decidem se isso vale a pena. O lançamento mais recente continua no 9.0-r2 datado de 25 de março de 2020, então apps que pedem Android 10 ou mais novo se recusam a instalar. Hardware que já roda o Waydroid não tem motivo para seguir esse caminho.

Inicialize o Android-x86 em uma máquina virtual

O Android-x86 9.0-r2 também inicializa dentro de uma máquina virtual, o que não custa nada, não arrisca dados no seu disco real e termina a configuração em dez minutos, então você pode testar a imagem no desktop antes de decidir se faz dual boot ao lado do Linux.

1. Crie uma máquina virtual com 4 GB de RAM e um disco de 8 GB. Defina o tipo como Linux, Other Linux.
2. Anexe android-x86_64-9.0-r2.iso como drive óptico e inicialize por ele.
3. Escolha Live CD - Run Android-x86 without installation primeiro. O desktop aparece em cerca de um minuto com o KVM habilitado.
4. Escolha Installation só quando você quiser Android no disco virtual.

O QEMU faz o mesmo trabalho em uma linha: qemu-system-x86_64 -enable-kvm -cpu host -m 4096 -cdrom android-x86_64-9.0-r2.iso. O KVM precisa estar acessível em /dev/kvm, e o seu usuário precisa pertencer ao grupo kvm. Adicione a si mesmo com sudo usermod -aG kvm $USER e depois saia e entre de novo.

O modo live não grava nada. A build continua no 9.0-r2 de 25 de março de 2020, então apps que pedem Android 10 ou mais novo ainda se recusam a instalar. O Waydroid continua mais rápido em qualquer coisa que rode um kernel atual.

Método 4: o emulador do Android Studio

O emulador do Android Studio roda no Linux exatamente como roda no Windows e no macOS. Crie um AVD, escolha uma imagem, inicialize-a e instale seu APK arrastando-o para a janela. Esse é o caminho para desenvolvedores e para quem precisa de um nível de API específico para testar.

A primeira inicialização baixa uma imagem de sistema de um a dois gigabytes, e as partidas frias são mais lentas que as do Waydroid. Em troca você ganha uma build Google de fábrica, níveis de API atuais e nenhuma empacotagem comunitária para depurar.

Acelere o emulador do Android Studio com KVM

O emulador do Android Studio no Linux usa o KVM para velocidade, e sem ele um dispositivo virtual roda em uma fração da velocidade, então confira /dev/kvm, adicione o seu usuário ao grupo kvm e reinicie a sessão antes de criar um dispositivo.

1. Confirme que a CPU oferece virtualização: grep -Ec '(vmx|svm)' /proc/cpuinfo precisa imprimir um número acima de zero.
2. Confira o device node com ls -l /dev/kvm e depois confira seus grupos com groups.
3. Adicione a si mesmo ao grupo: sudo usermod -aG kvm $USER. Saia e entre de novo, porque uma mudança de grupo só se aplica a uma sessão nova.
4. Se /dev/kvm estiver ausente, instale os pacotes de virtualização da sua distribuição, como o qemu-kvm no Debian e no Ubuntu.

O KVM importa porque o emulador inicia uma máquina virtual de verdade. Sem ele o convidado cai para uma tradução lenta, as partidas frias se esticam em minutos e os jogos ficam inutilizáveis. Crie o AVD depois da mudança de grupo, já que um dispositivo criado antes dela continua falhando em /dev/kvm com um erro de permissão.

Método 5: streaming de Android na nuvem

Quando nada local instala o app, um dispositivo na nuvem termina o trabalho. Redfinger (redfinger.cloud) e BlueStacks X (x.bluestacks.com) transmitem uma sessão de Android remota para o seu navegador, então sua distribuição, kernel e GPU deixam de importar.

Isso serve para hardware fraco e para apps que você abre só de vez em quando. Custa uma assinatura e acrescenta latência de entrada perceptível em jogos rápidos.

Qual variante de APK funciona no Linux

A arquitetura decide mais no Linux do que em qualquer outro lugar, porque a imagem convidada escolhe a regra:

• Imagem x86, APK x86. Carga direta, velocidade total. É a configuração que o Genymotion e o Android-x86 te dão.
• Imagem x86, APK só de ARM. Falha com INSTALL_FAILED_NO_MATCHING_ABIS. O Waydroid não traz tradução de ARM, então o pacote não tem bibliotecas para carregar.
• Host arm64 com imagem arm64. Velocidade nativa, e o caso comum em computadores de placa única ARM como o Raspberry Pi.

Quando um download oferece vários arquivos, leve o build x86 ou universal em um desktop. O raciocínio por trás de cada nome de ABI está em tamanho de arquivo e arquitetura do APK.

Leia os requisitos de um APK antes de instalar

Leia os requisitos de um APK no Linux com o mesmo comando de sempre: aapt dump badging file.apk imprime a versão mínima do Android e as arquiteturas de CPU dentro do pacote, e essas duas linhas decidem se a sua imagem x86 do Waydroid aceita o arquivo.

O binário vem com o Android SDK em ~/Android/Sdk/build-tools/34.0.0/aapt, e o Android Studio cria essa pasta na primeira execução. Debian e Ubuntu trazem a mesma ferramenta como o pacote aapt. Leia o arquivo antes de empurrá-lo para o contêiner.

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

O Waydroid não tem tradução de ARM. Uma olhada na linha de arquitetura evita uma tentativa de reinstalação.

Erros comuns de APK no Linux

Problemas de binder respondem pela maioria das primeiras instalações que falham. Confira-os antes de reinstalar qualquer coisa.

Confira a sessão e leia os logs

Três comandos diagnosticam a maioria das falhas do Waydroid em qualquer distribuição: waydroid status informa se a sessão e o contêiner estão rodando, waydroid log imprime a própria saída do contêiner, e sudo journalctl -u waydroid-container -e mostra por que o serviço systemd parou antes de você abrir qualquer app. Rode-os nessa ordem antes de reinstalar qualquer coisa.

O waydroid status imprime as linhas que importam: Session, Container e Vendor type. Session e Container devem estar RUNNING. Qualquer outra coisa explica uma tela vazia.

Para detalhes, waydroid log mostra o fim da saída do contêiner e sudo journalctl -u waydroid-container -e abre o histórico do serviço. Copie as últimas dez linhas antes de pedir ajuda. A string de erro costuma estar nelas.

Compare Waydroid, Genymotion e Android Studio

Escolha o Waydroid para uso diário no desktop porque ele inicializa em segundos e compartilha o seu kernel, escolha o Genymotion quando um app se recusa a instalar porque precisa de uma imagem x86, e escolha o Android Studio quando você precisa testar um nível de API exato. Os três custam nada para a forma como a maioria das pessoas usa.

O Waydroid 1.6.3 foi publicado em 28 de maio de 2026 com suporte inicial a imagens Android 16, enquanto a imagem de runtime dele continua sendo Android 13 baseado em LineageOS. Genymotion e Android Studio inicializam uma máquina virtual completa em vez disso, o que custa mais memória e compra melhor isolamento em troca.

Qual caminho você deve escolher

O uso diário vai para o Waydroid: ele começa rápido, compartilha o seu desktop e instala pelos próprios repositórios da sua distribuição. Trabalho de desenvolvimento vai para o Android Studio. Um app que se recusa a instalar no Waydroid vai para o Genymotion em uma máquina virtual x86.

Comece pelo Waydroid, confirme que você está no Wayland e carregue o binder antes da primeira execução. O guia do Raspberry Pi cobre as mesmas ferramentas em hardware ARM, e o guia de instalação cuida das permissões e dos pacotes divididos uma vez que o seu APK inicializar.