O app de exemplo mostra os recursos básicos das APIs do Google Home para Android.
Pré-requisitos
Para criar, instalar e testar o app, você precisa atender a alguns pré-requisitos:
Android Studio, versão 2024.2.1 ("Ladybug") ou mais recente. Versões anteriores podem não funcionar corretamente com o SDK das APIs do Google Home.
O depurador do Android (
adb
).Instalar o
adb
:Isso pode ser feito com o gerenciador do SDK.
Para testar as APIs do Google Home, você vai precisar de:
- Um dispositivo Android com o Android 10 ou mais recente configurado com uma Conta do Google que você pretende usar para desenvolvimento. Verifique se uma versão atualizada do Android Studio está instalada e conectada a essa conta de desenvolvedor.
- Uma rede Wi-Fi.
- Para acessar e controlar dispositivos Matter, você também precisa de uma central do Google compatível com as APIs Home. Consulte Conectividade no Android para mais detalhes.
Pelo menos um dispositivo compatível na casa. Se esse dispositivo (ou qualquer outro que você queira testar) usar o Thread, o hub também precisa ser um roteador de borda do Thread. O app de exemplo do Android oferece suporte aos seguintes tipos e características de dispositivo:
- Luz de temperatura de cor (ligar e desligar, brilho)
- Sensor de contato (estado booleano)
- Luz regulável (ligar e desligar, brilho)
- Luz de cores estendida (ligar e desligar, brilho)
- Switch genérico
- Sensor de ocupação (detecção de ocupação)
- Luz de ativação/desativação (ativação e desativação, brilho)
- Interruptor de luz liga/desliga
- Unidade de plugue liga/desliga (ligada e desligada)
- Sensor de ativação/desativação
Faça o download do código-fonte
O código-fonte do app de exemplo está disponível no GitHub.
Navegue até o local em que você quer salvar o projeto e clone-o:
git clone https://github.com/google-home/google-home-api-sample-app-android.git
configurar o SDK
As APIs Home para Android nessa versão Beta aberta ainda não fazem parte das bibliotecas padrão fornecidas pelo Google para desenvolvimento. Para desenvolver apps Android com as APIs Home, é necessário fazer o download e hospedar as bibliotecas localmente.
Para fazer o download do SDK das APIs Home para Android, primeiro é necessário fazer login no Google Home Developers.
Criar o app
- Abra Android Studio e, em seguida, a pasta do projeto
google-home-api-sample-app-android
que foi clonada para a máquina local. Durante a primeira configuração, o Android Studio pode levar até 10 minutos para fazer o download de todas as dependências do projeto e concluir o build do Gradle.
Conecte o computador a um smartphone Android físico por um cabo USB e ative o ADB nas opções para desenvolvedores. Confira se o Android Studio pode se conectar ao smartphone Android pelo ADB.
Mude o nome do pacote do app de exemplo para um novo que não tenha sido registrado antes, como um baseado no nome da sua organização:
- Abra o projeto.
- Expanda a hierarquia de origem.
- Selecione a parte do pacote que você quer mudar, ou seja,
com.example
. - Clique com o botão direito do mouse no pacote e selecione Refactor > Rename...
- Digite o novo nome e clique em Refactor.
- Edite o arquivo
build.gradle.kts
, mudando oandroid namespace
e oapplicationId
para o novo nome do pacote.
Depois que todas as bibliotecas necessárias forem baixadas e a sincronização do Gradle for concluída, clique no botão Run (Executar) para criar e executar o app. Quando o app estiver em execução no smartphone, a página principal do app de exemplo vai aparecer.
Criar um certificado de assinatura
Quando você executa ou depura um app em Android Studio, ele gera automaticamente um certificado de depuração destinado ao desenvolvimento e à depuração. Consulte Android Studio: assinar seu build de depuração para uma explicação completa.
Gere um certificado de assinatura de depuração do app executando o app em Android Studio. Quando você executa ou depura um app em Android Studio, o Android Studio gera automaticamente um certificado de assinatura de app destinado ao desenvolvimento e à depuração. Consulte Android Studio: assinar o build de depuração para uma explicação completa.
Conecte seu dispositivo móvel à máquina local. Android Studio lista os dispositivos conectados por número de modelo. Selecione seu dispositivo na lista e clique em Executar projeto. Isso cria e instala o app de exemplo no seu dispositivo móvel.
Para instruções mais detalhadas, consulte Executar apps em um dispositivo de hardware no site para desenvolvedores Android.
Agora, pare o app em execução.
Para conseguir a impressão digital SHA-1 do certificado de depuração, siga as instruções detalhadas em Gerenciar clientes OAuth / Tipos de aplicativo / Aplicativos nativos / Android no site de ajuda do console do Google Cloud.
Configurar o consentimento do OAuth
- No console do Google Cloud, acesse o painel do seletor de projetos e selecione o projeto que você quer usar para criar credenciais do OAuth.
- Acesse a página APIs e serviços e clique em Credenciais no menu de navegação.
Se você ainda não tiver configurado a tela de consentimento para este projeto do Google Cloud, o botão Configurar tela de consentimento vai aparecer. Nesse caso, configure a tela de consentimento usando o procedimento a seguir. Caso contrário, avance para a próxima seção.
- Clique em Configurar tela de consentimento. A página Tela de consentimento do OAuth é exibida.
- Dependendo do caso de uso, selecione Interno ou Externo e clique em Criar. O painel Tela de consentimento do OAuth é exibido.
- Insira informações na página de informações do app de acordo com as instruções na tela e clique em Salvar e continuar. O painel Scopes é exibido.
- Não é necessário adicionar escopos. Clique em Salvar e continuar. O painel Test users é exibido.
- Clique em Público-alvo e no botão + ADICIONAR USUÁRIOS.
- Digite o endereço de e-mail do usuário de teste e clique no botão SALVAR.
- Clique em Salvar e continuar. O painel Summary é exibido.
- Revise as informações da tela de consentimento OAuth e clique em Voltar ao painel.
Consulte Como configurar a tela de consentimento OAuth no site de ajuda do console do Google Cloud para conferir todos os detalhes. Adicione pelo menos um usuário de teste antes de continuar.
Configurar credenciais do OAuth
- Registre o app de exemplo para o OAuth 2.0 e crie credenciais do OAuth
seguindo as instruções fornecidas em
Como configurar o OAuth 2.0.
- Indique o tipo de aplicativo, que é app nativo/Android.
- Adicione a impressão digital SHA-1 ao cliente OAuth seguindo as instruções em Como configurar o OAuth 2.0 / Aplicativos nativos / Android no site de ajuda do Google Cloud Console. Você precisa gerar a chave SHA-1 a partir da chave padrão do Android Studio durante o processo de desenvolvimento.
Executar o app
- Com o dispositivo móvel conectado à máquina local, clique em Run project novamente para executar o app de exemplo no dispositivo móvel.
Depois de instalado, o app fica disponível no seu dispositivo móvel como App de exemplo da API Home.