App de exemplo do Android das APIs do Google Home

O app de exemplo mostra os recursos básicos das APIs 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. As versões anteriores a essa podem não funcionar corretamente com o SDK das APIs Home.

    Faça o download do Android Studio

  • O depurador do Android (adb).

    Instale adb.

    Isso pode ser feito com o SDK Manager.

Para testar as APIs Home, você precisa de:

  • Um dispositivo Android com a versão 10 ou mais recente configurado com uma Conta do Google que você pretende usar para desenvolvimento. Confira se uma versão atualizada do Android Studio está instalada e conectada a essa conta de desenvolvimento.
  • Uma rede Wi-Fi.
  • Para acessar e controlar Matter dispositivos, você também precisa de um hub do Google que ofereça suporte às 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 precisará ser um roteador de borda Thread. Os seguintes tipos e características de dispositivos são compatíveis com o app de exemplo do Android:

    • Luz de temperatura de cor (ligada e desligada, brilho)
    • Sensor de contato (estado booleano)
    • Iluminação regulável (ligada e desligada, brilho)
    • Luz de cor estendida (ligada e desligada, brilho)
    • Interruptor genérico
    • Câmera do Google
    • Sensor de presença (detecção de ocupação)
    • Luz liga/desliga (ligada e desligada, brilho)
    • Interruptor de luz liga/desliga
    • Unidade de plug-in liga/desliga (ligada e desligada)
    • Sensor liga/desliga

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 nesta versão Beta aberta ainda não fazem parte das bibliotecas padrão fornecidas pelo Google para desenvolvimento. Para desenvolver aplicativos Android com as APIs Home, é necessário fazer o download e hospedar as bibliotecas localmente.

Para fazer o download do SDK do Android das APIs Home, primeiro você precisa fazer login nos desenvolvedores do Google Home.

Faça login agora!

Criar o app

  1. Abra Android Studio, em seguida, abra a pasta do projeto google-home-api-sample-app-android que foi clonada para sua máquina local.

  2. Durante a primeira configuraçã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.

  3. Conecte o computador a um smartphone Android físico com um cabo USB e ative o ADB nas opções do desenvolvedor. Confira se Android Studio pode se conectar ao smartphone Android pelo ADB.

  4. 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:

    1. Abra o projeto.
    2. Expanda a hierarquia de origem.
    3. Selecione a parte do pacote que você quer mudar, ou seja, com.example.
    4. Clique com o botão direito do mouse no pacote e selecione Refactor > Rename... Menu "Refatorar > Renomear"
    5. Digite o novo nome e clique em Refactor.
    6. Edite o arquivo build.gradle.kts, mudando o android namespace e o applicationId para o novo nome do pacote.

  5. Depois que todas as bibliotecas necessárias forem baixadas e a sincronização do Gradle for concluída, clique no botão Run para criar e executar o app. Quando o app estiver em execução no smartphone, a página principal do app de exemplo será exibida.

Criar um certificado de assinatura

Ao executar ou depurar 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.

  1. Gere um certificado de assinatura de apps de depuração executando o app em Android Studio. Ao executar ou depurar um app em Android Studio, Android Studio gera automaticamente um certificado de assinatura de apps destinado ao desenvolvimento e à depuração. Consulte Android Studio: assinar seu build de depuração para uma explicação completa.

    Conecte seu dispositivo móvel à máquina local. Android Studio vai listar os dispositivos conectados pelo número do modelo. Selecione seu dispositivo na lista e clique em Run project. 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, interrompa o app em execução.

  2. Receba a impressão digital SHA-1 do certificado de depuração seguindo as instruções detalhadas em Gerenciar clientes OAuth / Tipos de aplicativos / Aplicativos nativos / Android no site de ajuda do console do Google Cloud.

  1. 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.
  2. Acesse a página APIs e serviços e clique em Credenciais no menu de navegação.

  3. Se você ainda não configurou a tela de permissão para esse projeto do Google Cloud, o botão Configurar tela de permissão vai aparecer. Nesse caso, configure a tela de permissão usando o procedimento a seguir. Caso contrário, avance para a próxima seção.

    1. Clique em Configurar tela de permissão. A página Tela de permissão OAuth é exibida.
    2. Dependendo do seu caso de uso, selecione Interno ou Externo e, em seguida, clique em Criar. O painel Tela de permissão OAuth é exibido.
    3. 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 Escopos é exibido.
    4. Não é necessário adicionar escopos. Clique em Salvar e continuar. O painel Usuários de teste é exibido.
    5. Clique em Público-alvo e no botão + ADICIONAR USUÁRIOS.
    6. Insira o endereço de e-mail do usuário de teste e clique no botão SALVAR.
    7. Clique em Salvar e continuar. O painel Resumo é exibido.
    8. Revise as informações da tela de permissão OAuth e clique em Voltar ao painel.

Consulte Configurar a tela de permissão OAuth screen no site de ajuda do console do Google Cloud para mais detalhes. Adicione pelo menos um usuário de teste antes de continuar.

Configurar credenciais do OAuth

  1. Registre o app de exemplo para o OAuth 2.0 e crie credenciais do OAuth seguindo as instruções fornecidas em Configurar o OAuth 2.0.
    1. Indique o tipo de aplicativo, que é nativo/app Android.
    2. Adicione a impressão digital SHA-1 ao cliente OAuth seguindo as instruções em Configurar o OAuth 2.0 / Aplicativos nativos / Android no site de ajuda do console do Google Cloud. Gere a chave SHA-1 da chave padrão do Android Studio durante todo o processo de desenvolvimento.

Executar o app

  1. 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 estará disponível no seu dispositivo móvel como Home API Sample App.