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 versão.

Etapa 1: instalar o software necessário

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

  • Xcode versão 26.0 ou mais recente

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

Gerenciador de pacotes do Swift

O SDK de navegação pode ser instalado pelo gerenciador de pacotes do Swift. Para adicionar o SDK, remova todas as dependências do SDK de navegação.

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

  1. Abra o project ou workspace do Xcode e acesse File > Add Package Dependencies.
  2. Insira https://github.com/googlemaps/ios-navigation-sdk como o URL, pressione Enter para extrair o pacote e clique em "Add Package".
  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 Choose Package Products, verifique se GoogleNavigation será adicionado ao destino main designado. Quando terminar, clique em "Adicionar pacote".
  5. Para verificar a instalação, acesse o painel General do destino. Em Frameworks, Libraries, and Embedded Content, você verá os pacotes instalados. Você também pode conferir a seção "Package Dependencies" do "Project Navigator" 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 Package Dependencies do Project Navigator 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 do projeto do 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

Este guia mostra 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 definir as configurações de build no Xcode. Um XCFramework é um pacote binário que pode ser usado em várias plataformas, incluindo máquinas que usam 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 o iOS, crie um novo projeto e selecione o modelo de app iOS.
  3. Remova todas as referências atuais do Maps, Navigation e Places do projeto.
  4. Arraste os seguintes XCFrameworks para seu projeto em Frameworks, Libraries, and Embedded Content para instalar os SDKs do Maps e do Navigation (quando solicitado, selecione Copy items if needed):
    • GoogleMaps.xcframework
    • GoogleNavigation.xcframework
  5. Arraste GoogleMaps.bundle de GoogleMapsResources que você salvou para o diretório de nível superior do seu projeto do Xcode. Quando solicitado, verifique se a opção Copy items if needed está selecionada.
  6. Arraste GoogleNavigation.bundle de GoogleNavigationResources que você salvou para o diretório de nível superior do seu projeto do Xcode. Quando solicitado, verifique se a opção Copiar itens para a pasta do grupo de destino está selecionada.
  7. Selecione seu projeto no Project Navigator e escolha o 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. No destino do aplicativo, selecione a guia Capabilities, ative Background Modes e 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 Other Linker Flags, 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 quando em uso)
      Valor: "Este app precisa de permissão para usar sua localização na navegação guiada."
    • Chave: NSLocationAlwaysAndWhenInUseUsageDescription (Privacy - Location Always and When In Use Usage Description)
      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 seu projeto no Xcode:

Swift

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

  1. Adicione as seguintes instruçõ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 instruçõ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 App Store da Apple para ver 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 o registro de transações, consulte Configurar o faturamento. Para saber como adicionar IDs de transação à sua implementação do SDK do Navigation, consulte Associar o uso do serviço às transações do Mobility.

A seguir

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