Testar a versão de demonstração

Ao integrar o SDK do Navigation para Android, seu app pode ir além da vinculação a uma visualização externa do mapa. 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 Navigation SDK, que estão disponíveis no GitHub.

Prepare-se

Para começar a usar o SDK de navegação, confira os itens a seguir.

Esta documentação foi elaborada para pessoas que já conhecem os conceitos de desenvolvimento do Android e 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 de navegação 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 GoogleNavigation. Os desenvolvedores que não conhecem os dois projetos vão achar os dois apps úteis.

A partir do Navigation SDK 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 em relação à 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.

  2. No Android Studio, clique na opção de menu Run (ou no ícone 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 encontrar o seguinte:

  • 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 Google Maps

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 gradle de segredos 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 Gerenciador de dispositivos virtuais Android (AVD) para configurar um dispositivo virtual. Ao escolher um emulador, escolha uma imagem que inclua as APIs do Google.

  2. No Android Studio, clique na opção de menu Run (ou no ícone 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 para os usuários das demonstrações do SDK do Google Maps. Isso ocorre porque a demonstração do Google Maps foi 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 for melhor para você. Por exemplo, ainda pode ser necessário usar um MapView em situações em que você está usando uma biblioteca de terceiros que espera interagir com essa classe.