Testar a versão de demonstração

Ao integrar o SDK do Navigation para Android, seu app pode ir além de vincular a uma visualização de mapa externa. Com a navegação do Google Maps, seu app pode oferecer recuperação dinâmica e relatórios de dados sobre a jornada de um usuário. Este guia explica como executar os apps de demonstração do SDK do Navigation, que estão disponíveis no GitHub.

Prepare-se

Para começar a usar o SDK Navigation, confira os seguintes itens.

Esta documentação foi projetada para pessoas familiarizadas com o desenvolvimento do Android e conceitos de programação orientada a objetos. Também é preciso saber utilizar o Google Maps como usuário.

Instalar os apps de demonstração

O Google oferece dois apps para ajudar você a entender o que o SDK Navigation oferece além das APIs do Google Maps, dependendo do seu nível de experiência. Os desenvolvedores que já conhecem as APIs do Google Maps podem se concentrar na demonstração do Google Navigation. Os desenvolvedores que não conhecem os dois projetos vão achar os dois apps úteis.

A partir do SDK Navigation para Android v4.1, os seguintes apps de demonstração estão disponíveis para download no GitHub.

  • Demonstração do GoogleNavigation: mostra a integração de comportamentos e visualizações de APIs, já que elas se referem à experiência do usuário durante uma sessão de navegação guiada.

  • Demonstração do Google Maps: mostra comportamentos individuais da interface GoogleMap para personalizar a sensação e a apresentação dos mapas.

Demonstração do GoogleNavigation

A demonstração mais recente do GoogleNavigation está disponível no GitHub.

Construção

  1. No Android Studio, importe o app de demonstração e permita a execução do Gradle.

  2. Abra local.defaults.properties e atualize o valor da propriedade MAPS_API_KEY:

      MAPS_API_KEY=YOUR_API_KEY

  3. Clique em build e examine os detalhes da implementação do SDK.

    • Na classe Java, observe o código de implementação.

    • No XML do layout, observe o design e o texto do layout.

    • No arquivo build.gradle, observe o SDK nas dependências.

Consulte a documentação do plug-in Secrets Gradle para mais informações sobre como a chave de API é adicionada ao manifesto.

Em execução

  1. Conecte um dispositivo Android ao computador ou use um emulador.

    • Dispositivo Android: consulte as instruções para ativar as opções para desenvolvedores no seu dispositivo Android e configurar o sistema para detectar o dispositivo.
    • Emulator: use o AVD Manager do Android (AVD, na sigla em inglês) para configurar um dispositivo virtual. Ao escolher um emulador, selecione uma imagem que inclua as APIs do Google.

  2. No Android Studio, clique na opção de menu Run ou no ícone do botão de reprodução e escolha um destino de implantação.

Quando criado e lançado, o app apresenta ao usuário uma página de destino com uma lista de opções.

Os novos usuários do NavSDK provavelmente vão achar essas duas opções as mais úteis.

Opção 1: NavViewActivity mostra comportamentos usando o NavigationView em conjunto com o Navigator.

Opção 2: a segunda opção, intitulada NavFragmentActivity, mostra comportamentos usando o SupportNavigationFragment com o Navigator.

Ao clicar em uma dessas opções, você vai receber as seguintes informações:

  • a interface de navegação
  • um botão "Definir destino" no menu do app
  • uma sobreposição com a qual você pode interagir para invocar métodos dinamicamente na API
  • um menu flutuante com mais opções

Para começar, clique em Definir destino e escolha um endereço. Em seguida, o app simula uma viagem do seu local atual até esse endereço. Use a sobreposição de painéis de controle para conferir o que acontece quando você chama uma API. Por exemplo, você pode clicar em View Methods para tentar forçar o SDK no modo noturno e conferir como ele fica.

Opção SwappingMapAndNavActivity

O SwappingMapAndNavActivity mostra os seguintes padrões comuns:

Demonstração do GoogleMap

A demonstração mais recente do GoogleNavigation está disponível no GitHub.

Construção

  1. No Android Studio, importe o app de demonstração e permita a execução do Gradle.

  2. Abra local.defaults.properties e atualize o valor da propriedade MAPS_API_KEY:

      MAPS_API_KEY=YOUR_API_KEY

  3. Clique em build e examine os detalhes da implementação do SDK.

    • Na classe Java, observe o código de implementação.

    • No XML do layout, observe o design e o texto do layout.

    • No arquivo build.gradle, observe o SDK nas dependências.

Consulte o plug-in do Gradle para secrets para mais informações sobre como a chave de API é adicionada ao manifesto.

Em execução

  1. Conecte um dispositivo Android ao computador ou use um emulador.

    • Dispositivo Android: consulte as instruções para ativar as opções para desenvolvedores no seu dispositivo Android e configurar o sistema para detectar o dispositivo.
    • Emulador: use o AVD Manager para configurar um dispositivo virtual. Ao escolher um emulador, selecione uma imagem que inclua as APIs do Google.

  2. No Android Studio, clique na opção de menu Run ou no ícone do botão de reprodução e escolha um destino de implantação.

Quando criado e lançado, o app apresenta ao usuário uma página de destino com uma lista de demonstrações.

Esse padrão de apresentação e a estrutura correspondente do código-fonte devem ser familiares aos usuários das demonstrações do SDK do Google Maps. Isso ocorre porque a demonstração do Google Maps é projetada para ser semelhante ao app de demonstração da API Maps. A principal diferença é que a demonstração do SDK de navegação permite que o usuário escolha em qual classe de visualização ele quer executar uma demonstração: NavigationView ou MapView, se aplicável.

O Google geralmente incentiva os usuários a usar o NavigationView. Essa demonstração oferece a flexibilidade de testar esses comportamentos nas duas versões do app de demonstração e escolher a que funcionar melhor para você. Por exemplo, ainda pode ser necessário usar uma MapView em situações em que você está usando uma biblioteca de terceiros que espera interagir com essa classe.