Configurar um projeto do Xcode

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

As Notas de lançamento estão disponíveis para cada versão.

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 do Xcode e instalar o SDK Navigation

Gerenciador de pacotes do Swift

O SDK Navigation pode ser instalado pelo Gerenciador de pacotes do Swift. Para adicionar o SDK, remova todas as dependências do SDK Navigation.

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 URL, pressione Enter para extrair o pacote e clique em "Add Package".
  3. Para instalar um version específico, defina o campo Dependency Rule como uma das as opções baseadas na versão. Para novos projetos, recomendamos especificar a versão mais recente e usar a opção "Exact Version". Quando terminar, clique em "Add Package".
  4. Na janela Choose Package Products, verifique se GoogleNavigation será adicionado ao seu destino main designado. Quando terminar, clique em "Add Package".
  5. Para verificar a instalação, navegue até o painel General do destino. Em Frameworks, Libraries, and Embedded Content , você verá os pacotes instalados. Você também pode acessar a seção "Package Dependencies" do "Project Navigator" para verificar o pacote e a versão dele.

Para atualizar o package de um projeto atual, 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 Navigation para iOS instalado manualmente, siga estas etapas:
  1. Nas configurações de configuração do projeto do Xcode, encontre Frameworks, Libraries, and Embedded Content. Use o sinal de menos(-) para remover o framework a seguir:
    • GoogleMaps.xcframework
    • GoogleNavigation.xcframework
  2. No diretório de nível superior do projeto do Xcode, remova o GoogleMaps pacote.

Instalação manual

Este guia mostra como adicionar manualmente os XCFrameworks que contêm o SDK Navigation para iOS e o SDK do Maps para iOS ao seu projeto e configurar 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 Navigation para iOS, e do SDK do Maps para iOS:

  1. Faça o download dos seguintes binários e arquivos de recursos do SDK:
  2. Inicialize o Xcode e abra ou crie um novo projeto. Se você não conhece o iOS, crie um 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 o 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ê fez o download para o diretório de nível superior do projeto do Xcode. Quando solicitado, verifique se a opção Copy items if needed está selecionada.
  6. Arraste GoogleNavigation.bundle de GoogleNavigationResources que você fez o download para o diretório de nível superior do projeto do Xcode. Quando solicitado, verifique se a opção Copy items into destination group's folder está selecionada.
  7. Selecione o projeto no navegador de projetos 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 ative os seguintes modos:
    • Audio, AirPlay, and Picture in Picture
    • Location updates
  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 Build Settings barra de Basic para All.
  11. Abra Info.plist e adicione os seguintes pares de chave-valor:
    • Chave: NSLocationWhenInUseUsageDescription (Privacidade – Descrição de uso do local quando em uso)
      Valor: "Este app precisa de permissão para usar sua localização para navegação guiada."
    • Chave: NSLocationAlwaysAndWhenInUseUsageDescription (Privacidade – Descrição de uso do local sempre e quando em uso)
      Valor: "Este app precisa de permissão para usar sua localização para 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 instruções de importação: 
    import GoogleMaps
import GoogleNavigation
  2. Adicione o seguinte ao seu application(_:didFinishLaunchingWithOptions:) método: 
    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 seu application:didFinishLaunchingWithOptions: método: 
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];

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

A Apple exige detalhes de privacidade de apps na App Store. Acesse a página 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 do arquivo.

Se você é cliente do Mobility Services

Se você é cliente do Mobility Services, saiba mais sobre o faturamento na documentação do Mobility. Para mais informações sobre como registrar transações, consulte Configurar o faturamento. Para saber como adicionar IDs de transação à 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: