Configurar um projeto do Xcode

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 Arquivo > Adicionar dependências de pacote.
2. Insira https://github.com/googlemaps/ios-navigation-sdk como 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 as opções baseadas na 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 atual, 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.

1. Nas configurações de configuração do projeto Xcode, encontre Frameworks, bibliotecas, e conteúdo incorporado. 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 Xcode, remova o GoogleMaps pacote.

Instalação manual

Neste guia, mostramos como adicionar manualmente os XCFrameworks que contêm o SDK Navigation para iOS e o SDK do Maps para iOS ao 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 binários e arquivos de recursos do SDK a seguir:
   • GoogleMaps
   • GoogleMapsResources
   • GoogleNavigation
   • GoogleNavigationResources
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 de mapas, navegação e lugares do projeto.
4. Arraste os XCFrameworks a seguir para o projeto em Frameworks, bibliotecas e conteúdo incorporado para instalar os SDKs Maps e Navigation (quando solicitado, selecione Copiar itens, se necessário):
   • 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 Xcode. Quando solicitado, verifique se a opção Copiar itens, se necessário está selecionada.
6. Arraste GoogleNavigation.bundle de GoogleNavigationResources que você fez o download para o diretório de nível superior do 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 frameworks e bibliotecas a seguir:
   • 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 Recursos, ative Modos em segundo plano e ative os seguintes modos:
   • Áudio, AirPlay e picture-in-picture
   • Atualizações de localização
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 depuração e lançamento. Se essas configurações não estiverem visíveis, altere 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 da localização quando em uso)
      Valor: "Este app precisa de permissão para usar sua localização para navegação detalhada."
    • Chave: NSLocationAlwaysAndWhenInUseUsageDescription (Privacidade – Descrição de uso da localização sempre e quando em uso)
      Valor: "Este app precisa de permissão para usar sua localização para navegação detalhada."

CocoaPods

O SDK Navigation para iOS está disponível como um CocoaPods pod (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 use o para instalar a API e as dependências dele:

1. Se você ainda não tiver um projeto Xcode, crie um agora e salve-o no computador local. Se você não conhece o 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. Grave 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 Este arquivo define as dependências do seu projeto.
3. Edite o Podfile e adicione suas dependências com as versões delas. 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.10.0'
   end
           

   Execute pod outdated regularmente para detectar versões mais recentes. Se necessário, faça o 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 .xcworkspace arquivo 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.

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 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 declarações de importação:

   @import GoogleMaps;
   @import GoogleNavigation;

2. Adicione o seguinte ao seu application:didFinishLaunchingWithOptions: método:

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];