Configurar um projeto do Xcode

Depois de ativar o faturamento e criar uma chave de API, você poderá configurar o projeto do Xcode usado para desenvolver seu app.

As notas da versão estão disponíveis para cada lançamento.

Etapa 1: instalar o software necessário

Para criar um projeto usando o SDK Navigation para iOS, faça o download e instale:

  • Xcode versão 26.0 ou mais recente

Etapa 2: criar o projeto Xcode e instalar o SDK Navigation

Gerenciador de pacotes do Swift

O SDK Navigation pode ser instalado pelo Swift Package Manager. Para adicionar o SDK, remova todas as dependências do SDK Navigation atuais.

Para adicionar o SDK a um projeto novo ou atual, siga estas etapas:

  1. Abra o Xcode project ou workspace e acesse Arquivo > Adicionar dependências de pacote.
  2. Insira https://github.com/googlemaps/ios-navigation-sdk como o URL, pressione Enter para extrair o pacote e clique em "Adicionar pacote".
  3. Para instalar um version específico, defina o campo Regra de dependência como uma das opções baseadas em versão. Para novos projetos, recomendamos especificar a versão mais recente e usar a opção "Versão exata". Quando terminar, clique em "Adicionar pacote".
  4. Na janela Escolher produtos do pacote, verifique se GoogleNavigation será adicionado ao destino main designado. Quando terminar, clique em "Adicionar pacote".
  5. Para verificar a instalação, navegue até o painel Geral do destino. Em Frameworks, Libraries, and Embedded Content, você vai encontrar os pacotes instalados. Você também pode conferir a seção "Dependências de pacote" do "Navegador de projetos" para verificar o pacote e a versão dele.

Para atualizar o package de um projeto, siga estas etapas:

  1. No Xcode, acesse File > Packages > Update To Latest Package Versions.
  2. Para verificar a instalação, acesse a seção Dependências de pacote do Navegador de projetos para verificar o pacote e a versão dele.

Para remover o SDK do Navigation para iOS instalado manualmente, siga estas etapas:
  1. Nas configurações de configuração do projeto Xcode, encontre Frameworks, Libraries, and Embedded Content. Use o sinal de menos(-) para remover o seguinte framework:
    • GoogleMaps.xcframework
    • GoogleNavigation.xcframework
  2. No diretório de nível superior do projeto do Xcode, remova o pacote GoogleMaps.

Instalação manual

Neste guia, mostramos como adicionar manualmente os XCFrameworks que contêm o SDK do Navigation para iOS e o SDK do Maps para iOS ao seu projeto e configurar as opções de build no Xcode. Um XCFramework é um pacote binário que pode ser usado em várias plataformas, incluindo máquinas com o chipset M1.

Siga estas etapas para instalar os XCFrameworks do SDK do Navigation para iOS e do SDK do Maps para iOS:

  1. Faça o download dos seguintes binários do SDK e arquivos de recursos:
  2. Inicialize o Xcode e abra ou crie um projeto. Se você não tem experiência com iOS, crie um projeto e selecione o modelo de app iOS.
  3. Remova todas as referências atuais do Maps, da Navegação e do Places do projeto.
  4. Arraste os seguintes XCFrameworks para seu projeto em Frameworks, Libraries, and Embedded Content para instalar os SDKs do Maps e Navigation. Quando solicitado, selecione Copy items if needed:
    • GoogleMaps.xcframework
    • GoogleNavigation.xcframework
  5. Arraste GoogleMaps.bundle de GoogleMapsResources que você baixou para o diretório de nível superior do seu projeto Xcode. Quando solicitado, verifique se a opção Copiar itens, se necessário está selecionada.
  6. Arraste GoogleNavigation.bundle de GoogleNavigationResources, que você baixou, para o diretório de nível superior do seu projeto Xcode. Quando solicitado, verifique se a opção Copiar itens para a pasta do grupo de destino está selecionada.
  7. Selecione o projeto no Project Navigator e escolha o local de destino do aplicativo.
  8. Abra a guia Build Phases e, em Link Binary with Libraries, adicione os seguintes frameworks e bibliotecas:
    • Accelerate.framework
    • AudioToolbox.framework
    • AVFoundation.framework
    • CarPlay.framework
    • Contacts.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libxml2.tbd
    • libz.tbd
    • MapKit.framework
    • Metal.framework
    • OpenGLES.framework
    • QuartzCore.framework
    • Security.framework
    • SystemConfiguration.framework
    • UIKit.framework
    • UserNotifications.framework
    • WebKit.framework
  9. Na meta do seu aplicativo, selecione a guia Recursos, ative Modos em segundo plano e habilite os seguintes modos:
    • Áudio, AirPlay e picture-in-picture
    • Atualizações de local
  10. Escolha seu projeto, em vez de um destino específico, e abra a guia Build Settings. Na seção Outras flags do vinculador, adicione ‑ObjC para debug e release. Se essas configurações não estiverem visíveis, mude o filtro na barra Build Settings de Basic para All.
  11. Abra Info.plist e adicione os seguintes pares de chave-valor:
    • Chave:NSLocationWhenInUseUsageDescription (Privacidade - Descrição do uso da localização durante o uso)
      Valor: "Este app precisa de permissão para usar sua localização na navegação guiada."
    • Chave:NSLocationAlwaysAndWhenInUseUsageDescription (Privacidade - Descrição de uso de localização sempre e durante o uso)
      Valor: "Este app precisa de permissão para usar sua localização na navegação guiada."

Etapa 3: adicionar sua chave de API ao projeto

Os exemplos a seguir mostram como adicionar a chave de API ao projeto no Xcode:

Swift

Inclua sua chave de API ao AppDelegate.swift da seguinte maneira:

  1. Adicione as seguintes declarações de importação: 
    import GoogleMaps
import GoogleNavigation
  2. Adicione o seguinte ao método application(_:didFinishLaunchingWithOptions:): 
    GMSServices.provideAPIKey("YOUR_API_KEY")

Objective-C

Inclua sua chave de API ao AppDelegate.m da seguinte maneira:

  1. Adicione as seguintes declarações de importação: 
    @import GoogleMaps;
@import GoogleNavigation;
  2. Adicione o seguinte ao método application:didFinishLaunchingWithOptions:: 
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];

Etapa 4 (opcional): inspecionar o arquivo de manifesto de privacidade da Apple

A Apple exige detalhes de privacidade para apps na App Store. Acesse a página de detalhes de privacidade da Apple App Store para atualizações e mais informações.

O arquivo de manifesto de privacidade da Apple está incluído no pacote de recursos do SDK. Para verificar se o arquivo de manifesto de privacidade foi incluído e inspecionar o conteúdo dele, crie um arquivo do app e gere um relatório de privacidade com base nele.

Se você é cliente dos Serviços de mobilidade

Se você é cliente dos Serviços de mobilidade, saiba mais sobre o faturamento na documentação de mobilidade. Para mais informações sobre como registrar transações, consulte Configurar o faturamento. Para saber como adicionar IDs de transação à sua implementação do SDK Navigation, consulte Associar o uso do serviço a transações de mobilidade.

A seguir

Agora que você tem uma chave de API e um projeto do Xcode, já pode criar e executar apps. O SDK Navigation para iOS oferece tutoriais que podem ajudar você a começar. Confira mais detalhes em: