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 do Navigation, você precisa ter os itens a seguir.

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 Google Maps, dependendo do seu nível de experiência. Os desenvolvedores que conhecem as APIs 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 SDK de navegação 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 da API relacionados à experiência do usuário em 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 de 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 aparelho.
    • 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ê verá o seguinte:

  • a interface de navegação
  • um botão "Set Destination" no menu do aplicativo
  • 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 ver o que acontece quando você chama uma API. Por exemplo, você pode clicar em View Methods para tentar forçar o SDK a entrar no modo noturno para ver.

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 de 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 Secrets Gradle (link em inglês) 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 se quiser ativar as opções para desenvolvedores no seu dispositivo Android e configurar o sistema de modo a detectar o aparelho.
    • 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 para os usuários das demonstrações do SDK do Google Maps. Isso ocorre porque a demonstração do GoogleMap foi projetada para ser semelhante ao app de demonstração da API Maps. A principal diferença é que a demonstração do SDK do Navigation permite que o usuário escolha em qual classe de visualização quer fazer uma demonstração: NavigationView ou MapView, quando aplicável.

O Google geralmente incentiva os usuários a usar o NavigationView. Esta demonstração oferece a flexibilidade de testar esses comportamentos em ambas as versões em nosso app de demonstração e escolher a que funcionar 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.