Configurar um projeto do Xcode

Depois de ativar o faturamento e criar uma chave de API, você poderá configurar o projeto 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 16.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 existente, siga estas etapas:

  1. Abra o project ou workspace do Xcode 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".

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

  1. 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
    • Contacts.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libxml2.tbd
    • libz.tbd
    • 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 de uso da localização durante o uso)
      Valor: "Este app precisa de permissão para usar sua localização na navegação passo a passo."
    • 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 curva a curva."

CocoaPods

O SDK Navigation para iOS está disponível como um pod do CocoaPods (em inglês). O CocoaPods é um gerenciador de dependências de código aberto para projetos Cocoa em Swift e Objective-C.

Se você ainda não tem essa ferramenta, instale-a no macOS executando o seguinte comando no terminal. Para saber mais, consulte o Guia de primeiros passos do CocoaPods (em inglês).

sudo gem install cocoapods

Crie um Podfile para o SDK Navigation para iOS e instale a API e as dependências dela:

  1. Se você ainda não tiver um projeto Xcode, crie um agora e salve-o no computador local. Se você não tem experiência com desenvolvimento para iOS:
    1. Crie um novo projeto.
    2. Selecione o modelo iOS > App.
    3. Na tela de opções do projeto:
      1. Insira o Nome do projeto.
      2. Registre o valor do campo Identificador do pacote. Você pode usar esse valor para restringir sua chave de API abaixo.
      3. Defina a Interface do projeto como Storyboard.
      4. Defina a Linguagem como Swift ou Objective-C.
  2. Crie um arquivo chamado Podfile no seu diretório do projeto para definir as dependências.
  3. Edite o Podfile e adicione suas dependências com as respectivas versões. Confira um exemplo que inclui a dependência necessária para o SDK Navigation para iOS: # Cocoapods install reference # 
    source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '16.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleNavigation', '10.1.0'
end
    Execute pod outdated regularmente para detectar versões mais recentes. Se necessário, faça upgrade para a versão mais recente.
  4. Salve o Podfile.

  5. Abra um terminal e acesse o diretório que contém o Podfile:

    cd <path-to-project>

  6. Execute o comando pod install. Isso instala as APIs especificadas no Podfile e as respectivas dependências.

    pod install

  7. Feche o Xcode e clique duas vezes no arquivo .xcworkspace do projeto para iniciar o programa. Depois disso, é preciso usar o arquivo .xcworkspace para abrir o projeto.

Para atualizar a API de um projeto atual, siga estas etapas:

  1. Abra um terminal e acesse o diretório do projeto que contém o Podfile.
  2. Execute o comando pod update. Isso atualiza todas as APIs especificadas no Podfile para a versão mais recente.

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: