Testar a versão de demonstração

Com a integração do SDK do Navigation para Android, seu app pode ir além da vinculação a uma visualização de mapa externa. Com a navegação do Google Maps, seu app pode oferecer recursos recuperação e relatórios de visão única 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.

  • Um representante da Plataforma Google Maps para ter acesso aos seguintes itens:

    • Uma chave de API provisionada para uso com SDK do Navigation. Você precisa fornecer projectID, que pode ser encontrado no painel principal do console do Google Cloud, no nome do projeto.
    • O artefato do SDK. Verifique se o projeto está configurado. para usar o Maven no SDK do Navigation.
    • Para projetos que usam a v4.99.0 e versões anteriores Se não puder usar o Maven, poderá fazer o download do artefato compactado no Google Drive compartilhado. O arquivo de biblioteca estática é o arquivo .aar na Diretório libs/ que contém o SDK do Navigation. como Pacote AAR.
    • Um ou mais dos apps de demonstração.
    • Android Studio, o ambiente de desenvolvimento recomendado para criar um app. com o SDK do Navigation.

Esta documentação foi criada para pessoas familiarizadas com desenvolvimento e testes para Android de programação orientada a objetos. Você também precisa conhecer o Google Mapas do ponto de vista do usuário.

Instalar os apps de demonstração

O Google oferece dois apps para ajudar você a entender o que que o SDK do Navigation oferece, além do APIs do Google Maps, dependendo do seu nível de experiência. Desenvolvedores familiarizados com as APIs do Google Maps possa focar a atenção na demonstração do GoogleNavigation. Desenvolvedores iniciantes em ambos projetos vão considerar os dois aplicativos úteis.

A partir do SDK do Navigation para Android v4.1, os aplicativos de demonstração a seguir são disponíveis no GitHub para download.

  • Demonstração do GoogleNavigation: mostra a integração dos comportamentos da API e visualizações no que se refere à experiência do usuário em uma navegação guiada sessão.

  • Demonstração do GoogleMap: mostra comportamentos individuais de GoogleMap para personalizar a aparência e a apresentação dos mapas.

Uma observação sobre o uso do Maven

Os apps de demonstração estão configurados para fazer o download do artefato do SDK do Maven remoto usando o plug-in do Artifact Registry no Gradle. Não se esqueça de seguir as instruções de configuração do projeto para ter acesso ao SDK.

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 do 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 os Secrets do Gradle plug-in 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 o instruções para ativar as opções do desenvolvedor no dispositivo Android e configurar o sistema para detectar o dispositivo.
    • Emuladormdash;Use o Dispositivo virtual Android (AVD) Gerente de e 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 botão de reprodução icon); e escolha um destino de implantação.

Quando criado e iniciado, o aplicativo apresenta ao usuário uma página de destino de uma lista várias 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, chamada NavFragmentActivity, mostra usando o SupportNavigationFragment junto com Navigator.

Ao clicar em uma dessas opções, você verá o seguinte:

  • a IU de navegação;
  • em "Definir destino" botão no menu do app
  • uma sobreposição com a qual você pode interagir para invocar dinamicamente métodos no 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 o controle se sobrepõem para ver o que acontece quando você chama uma API. Por exemplo, é possível clique em View Methods para tentar forçar o SDK a entrar no modo noturno para ver o que como é.

Opção SwappingMapAndNavActivity

O SwappingMapAndNavActivity mostra os seguintes padrões comuns:

  • mostrando um MapView
  • trocando para um NavigationView quando a navegação começa
  • retornando para um MapView. quando a navegação terminar

A 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 de 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 os secrets Gradle plug-in 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 o instruções para ativar as opções do desenvolvedor no dispositivo Android e configurar sistema para detectar o dispositivo.
    • Emulador: use o Dispositivo virtual Android (AVD) Gerente 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 botão de reprodução icon); e escolha um destino de implantação.

Quando criado e iniciado, o aplicativo apresenta ao usuário uma página de destino de uma lista de demonstrações.

Esse padrão de apresentação e a estrutura correspondente do código-fonte deve ser familiar para os usuários das demonstrações do SDK do Google Maps. Isso ocorre porque o A demonstração do GoogleMap foi projetada para ser semelhante à demonstração da API do Google Maps app. O principal A diferença é que a demonstração do SDK do Navigation permite que o usuário escolha qual classe de visualização ele gostaria de testar, faça uma demonstração sobre: NavigationView ou MapView, quando aplicável.

O Google geralmente incentiva os adotantes a usar NavigationView Esta demonstração oferece a flexibilidade de testar esses comportamentos em ambas as versões nosso app de demonstração e escolha o que funcionar para você. Por exemplo, ainda pode ser necessário para usar um MapView em situações em que você está usando um que espera interagir com essa classe.