Este artigo explica como usar o ADB (Android Debug Bridge), uma utilidade de linha de comando incluída com as Ferramentas da Plataforma do SDK Android do Google.
O ADB pode ser usado para se comunicar com um dispositivo Elo Android a partir de um computador via USB ou conexão de rede. Os usos comuns incluem copiar arquivos, instalar e desinstalar aplicativos, executar comandos de shell, coletar logs e depurar aplicativos.
Algumas plataformas Elo Android mais antigas incluem uma configuração de Alternar USB para Modo do Dispositivo nas Opções de Desenvolvedor. Novas plataformas Elo Android, incluindo dispositivos compatíveis com Android 14, não requerem essa configuração. Nesses dispositivos, ative a depuração USB e conecte o cabo USB apropriado.
Em plataformas Elo que requerem Alternar USB para Modo do Dispositivo, ativar o Modo do Dispositivo pode desabilitar a comunicação com as portas periféricas USB. Quando o acesso a periféricos USB deve ser mantido, use o ADB por meio de uma conexão de rede quando possível.
Configurando o ADB no Computador
- Baixe as Ferramentas da Plataforma do SDK Android no site dos Desenvolvedores Android.
- Extraia o arquivo ZIP baixado para um local de fácil acesso.
Ativando as Opções de Desenvolvedor no Dispositivo Elo
- Abra o Painel de Controle do dispositivo Elo. Se solicitado, insira a senha do Painel de Controle.
- Se a senha não foi alterada, a senha padrão pode ser 1elo.
- Na área de Aplicativos, selecione Configurações.
- Abra Sobre o Telefone, Sobre o Tablet ou Sobre o Dispositivo, dependendo da plataforma Elo.
- Toque em Número da Versão sete vezes ou até que a mensagem Você agora é um desenvolvedor apareça.
- Retorne à tela de Configurações anterior.
- Abra Opções de Desenvolvedor. Dependendo da versão do Android, as Opções de Desenvolvedor podem estar localizadas em Sistema ou Sistema > Avançado.
Configurando a Depuração USB
Plataformas Elo Android mais Novas - Incluindo Android 14
- Certifique-se de que o cabo USB está desconectado do dispositivo Elo.
- Em Opções de Desenvolvedor, ative depuração USB.
- Selecione OK se solicitado para confirmar a depuração USB.
A opção Alternar USB para Modo do Dispositivo usada em algumas plataformas Elo Android mais antigas não é necessária em plataformas compatíveis mais novas com Android 14. Se essa opção não for exibida nas Opções de Desenvolvedor, continue com o procedimento de conexão USB abaixo.
Plataformas Elo Android mais Antigas com Modo do Dispositivo
Se o dispositivo Elo incluir uma opção de Alternar USB para Modo do Dispositivo nas Opções de Desenvolvedor:
- Certifique-se de que o cabo USB está desconectado do dispositivo Elo.
- Ative depuração USB.
- Ative Alternar USB para Modo do Dispositivo.
- Selecione OK se solicitado.
Ativar Alternar USB para Modo do Dispositivo em plataformas Elo aplicáveis pode interromper a comunicação com as portas periféricas USB.
Conectando-se ao Dispositivo Elo via USB
- Conecte o dispositivo Elo ao computador de desenvolvedor usando o cabo de dados USB apropriado.
Os requisitos para o cabo USB e porta de depuração variam de acordo com o produto Elo. Exemplos incluem:
- I-Series 2.0: USB Tipo-A para USB Tipo-A.
- PayPoint Plus para Android e PayPoint para Android Rev B: Mini-USB para USB Tipo-A.
- Novos produtos Elo Android: Use a porta de depuração USB e o cabo especificados no manual do usuário do produto.
Use um cabo USB que suporte dados. Cabos USB apenas para carregamento não podem estabelecer uma conexão ADB.
- Abra o Prompt de Comando do Windows ou o Terminal do Windows e navegue até o diretório platform-tools extraído.
- Digite o seguinte comando:
adb devices- O dispositivo Elo pode exibir uma mensagem de autorização perguntando se deve permitir a depuração USB do computador conectado.
- Se solicitado, selecione Permitir ou OK. Você também pode selecionar Sempre permitir deste computador se apropriado.
- Execute o seguinte comando novamente:
adb devices- Verifique se o dispositivo Elo está listado com um status de device.
O dispositivo Elo agora está pronto para aceitar comandos ADB do computador de desenvolvedor.
Usando ADB por meio de uma Conexão de Rede
O ADB também pode se comunicar com dispositivos Elo Android compatíveis usando uma conexão de rede. Isso pode ser útil quando o Modo do Dispositivo USB interferiria com periféricos USB conectados.
Alternando uma Conexão USB ADB Existente para TCP/IP
- Conecte o dispositivo Elo e o computador de desenvolvedor à mesma rede.
- Estabeleça uma conexão USB ADB funcionando usando os procedimentos acima.
- Determine o endereço IP do dispositivo Elo.
- A partir do computador de desenvolvedor, digite:
adb tcpip 5555- Digite o seguinte comando, substituindo <endereco-ip-do-dispositivo> pelo endereço IP do dispositivo Elo:
adb connect <endereco-ip-do-dispositivo>:5555Exemplo:
adb connect 192.168.1.100:5555- Execute o seguinte comando para verificar a conexão de rede:
adb devicesO dispositivo Elo deve aparecer na lista usando seu endereço IP seguido de :5555.
Use o ADB por TCP/IP apenas em uma rede confiável. Não exponha uma conexão ADB a uma rede não confiável ou acessível publicamente.
Solução de Problemas de Conexões USB ADB
Se o dispositivo Elo não aparecer ao executar adb devices, execute os seguintes passos.
- No dispositivo Elo, retorne para Configurações > Opções de Desenvolvedor.
- Selecione Revogar autorizações de depuração USB.
- Selecione OK para limpar computadores autorizados anteriormente.
- Desative a depuração USB.
- Desconecte o cabo USB do dispositivo Elo.
- Do Prompt de Comando do Windows ou do Terminal do Windows, digite os seguintes comandos:
adb kill-server
adb start-server- Reative a depuração USB.
- Em uma plataforma Elo anterior que requer o Modo do Dispositivo, ative também Alternar USB para Modo do Dispositivo.
- Reconecte o cabo USB.
- Execute:
adb devices- Se solicitado no dispositivo Elo, selecione Sempre permitir deste computador e então selecione Permitir ou OK.
- Execute o seguinte comando novamente:
adb devices- Se o dispositivo Elo estiver listado com um status de device, a conexão foi restaurada com sucesso.
Informações Adicionais
Para informações adicionais sobre o Android Debug Bridge, veja Android Debug Bridge (adb) - Desenvolvedores Android.
Please report any broken links by emailing support@elotouch.com and include a link to the knowledge article