Configurar um projeto do Xcode

Gerenciador de pacotes do Swift

O SDK do Navigation pode ser instalado pelo Gerenciador de pacotes do Swift. Para adicionar o SDK, remova todas as dependências do SDK do 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. Também é possível 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 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.

1. Nas configurações de configuração do projeto 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 Xcode, remova o GoogleMaps pacote.

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 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 do Navigation para iOS, e do SDK do Maps para iOS:

1. Baixe os 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 atuais do Maps, do Navigation e do Places do projeto.
4. Arraste os XCFrameworks a seguir para o 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ê baixou para o diretório de nível superior do projeto Xcode. Quando solicitado, verifique se a opção Copy items if needed está selecionada.
6. Arraste GoogleNavigation.bundle de GoogleNavigationResources que você baixou para o diretório de nível superior do projeto Xcode. Quando solicitado, verifique se a opção Copy items into destination group's folder 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 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, 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."

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"];