Magisk Manager

Passos rápidos

  1. Baixe o SDK Platform-Tools do Google para o seu computador e descompacte o arquivo.
  2. No celular, ative a Depuração USB nas Opções do desenvolvedor.
  3. Abra um terminal na pasta platform-tools e execute adb devices.
  4. Toque em Permitir no aviso Permitir depuração USB? do celular.
  5. Para testar o fastboot, execute adb reboot bootloader e depois fastboot devices.

O que são o ADB e o fastboot?

O ADB (Android Debug Bridge) se comunica com o celular enquanto o Android está rodando. Você o usa para copiar arquivos, instalar apps e reiniciar o celular em outros modos.

O fastboot se comunica com o bootloader do celular. Você o usa para desbloquear o bootloader e para gravar imagens, como a imagem de boot que o Magisk modifica.

Os dois vêm no pacote gratuito SDK Platform-Tools do Google. Baixe-o apenas do Google. Pacotes "Minimal ADB" de outros sites costumam estar desatualizados, e alguns já vieram acompanhados de software indesejado.

Instalar o ADB e o fastboot no Windows

  1. Baixe o Platform-Tools

    Abra a página do Platform-Tools do Google, baixe o SDK Platform-Tools para Windows e aceite os termos.

  2. Descompacte o arquivo

    Extraia o zip em um caminho curto, como C:\platform-tools. Caminhos longos e nomes de pasta com caracteres especiais podem causar erros.

  3. Abra um terminal na pasta

    Abra a pasta no Explorador de Arquivos, clique na barra de endereços, digite cmd e pressione Enter. Um Prompt de Comando abre nessa pasta. No PowerShell ou no Windows Terminal, comece cada comando com .\, por exemplo .\adb devices.

  4. Instale o driver USB

    O Windows costuma instalar um driver automaticamente. Se isso não acontecer, instale o Google USB Driver para celulares Pixel, ou o driver USB do fabricante do celular para outras marcas.

  5. Opcional: adicione ao PATH

    Para executar o adb de qualquer pasta, pesquise no Windows por Editar as variáveis de ambiente do sistema, abra Variáveis de Ambiente, selecione Path, escolha Editar e adicione C:\platform-tools. Depois abra um novo terminal.

Instalar o ADB e o fastboot no macOS

O jeito mais fácil é com o Homebrew:

brew install --cask android-platform-tools

Sem o Homebrew, baixe o SDK Platform-Tools para Mac na página do Platform-Tools do Google, descompacte, abra o Terminal na pasta platform-tools e comece cada comando com ./, por exemplo ./adb devices. Macs não precisam de driver USB.

Instalar o ADB e o fastboot no Linux

A maioria das distribuições tem pacotes para as duas ferramentas:

DistribuiçãoComando
Debian, Ubuntu, Linux Mintsudo apt install adb fastboot
Fedorasudo dnf install android-tools
Arch Linuxsudo pacman -S android-tools

Esses pacotes podem ficar atrás das versões do Google. Se o fastboot falhar em um celular mais novo, baixe o SDK Platform-Tools para Linux na página do Platform-Tools do Google e execute ./adb e ./fastboot na pasta descompactada.

Se adb devices disser no permissions, seu usuário não tem permissão para acessar o celular por USB. No Debian e no Ubuntu, o pacote android-sdk-platform-tools-common adiciona as regras que resolvem isso. Depois, desconecte e conecte o celular de novo.

Conecte o celular

  1. Ative a depuração USB

    Ative as Opções do desenvolvedor (toque em Número da versão sete vezes em Configurações → Sobre o telefone) e depois ative a Depuração USB nas Opções do desenvolvedor.

  2. Conecte e autorize o computador

    Conecte o celular com um cabo USB que transmita dados. Alguns cabos baratos só carregam. Execute:

    adb devices
    

    O celular pergunta Permitir depuração USB? Marque Sempre permitir a partir deste computador e toque em Permitir.

  3. Confira o resultado

    Execute adb devices de novo. O número de série do celular deve aparecer com a palavra device. Se aparecer unauthorized, desbloqueie a tela do celular e aceite o aviso.

  4. Teste o fastboot

    Reinicie no bootloader e confira se o fastboot reconhece o celular:

    adb reboot bootloader
    
    fastboot devices
    

    Execute fastboot reboot para voltar ao Android.

Comandos que você vai usar com o Magisk

ComandoO que faz
adb devicesLista os celulares conectados
adb reboot bootloaderReinicia o celular no bootloader (modo fastboot)
adb pull /sdcard/Download/file.imgCopia um arquivo do celular para o computador
adb push file.img /sdcard/Download/Copia um arquivo do computador para o celular
fastboot devicesLista os celulares no modo fastboot
fastboot flash init_boot file.imgGrava uma imagem em uma partição, aqui a init_boot
fastboot rebootReinicia o celular no Android

Os passos completos para fazer root estão no guia principal: como fazer root no celular com o Magisk.

Erros comuns do ADB e do fastboot

adb devices não mostra nada. Tente outro cabo e outra porta USB, de preferência uma do próprio computador, e não de um hub. No celular, defina o modo USB como Transferência de arquivos. No Windows, instale o driver USB de novo.

O aparelho aparece como "unauthorized". Desbloqueie o celular e aceite o aviso Permitir depuração USB?. Se ele não aparecer, toque em Revogar autorizações de depuração USB nas Opções do desenvolvedor e conecte de novo.

"'adb' não é reconhecido como um comando interno ou externo". O Windows não encontra o adb. Abra o terminal dentro da pasta platform-tools ou adicione a pasta ao PATH. No PowerShell, digite .\adb.

"command not found: adb" no Mac ou no Linux. Execute ./adb dentro da pasta platform-tools ou instale as ferramentas com o Homebrew ou com o gerenciador de pacotes.

O ADB funciona, mas o fastboot não mostra nada ou diz "waiting for any device". Confira se o celular está mostrando a tela do bootloader. No Windows, abra o Gerenciador de Dispositivos com o celular no bootloader: se houver um aparelho com um ícone de alerta, atualize o driver dele e escolha Android Bootloader Interface.

"Flashing is not allowed in Lock State". O bootloader ainda está bloqueado. Primeiro desbloqueie-o.

Perguntas frequentes

Preciso do Android Studio para usar o ADB?

Não. O SDK Platform-Tools do Google é um download pequeno e separado que contém o adb e o fastboot. Você não precisa do Android Studio nem do Android SDK completo.

Usar o ADB é seguro?

Sim. O ADB e o fastboot são as ferramentas oficiais do Google. A depuração USB permite que um computador aprovado por você controle o celular, então só autorize computadores em que você confia e desative a depuração USB quando terminar.

Dá para usar o ADB por Wi-Fi?

Sim. O Android 11 e versões mais recentes têm a Depuração por Wi-Fi nas Opções do desenvolvedor. Mas o fastboot precisa de um cabo USB em quase todos os celulares, então use um cabo quando for instalar o Magisk.

Por que usar a versão mais recente do Platform-Tools?

Versões antigas do fastboot podem falhar em celulares mais novos. O Google atualiza o Platform-Tools com frequência, então baixe a versão mais recente em vez de usar uma cópia de outro site.