Configurar um projeto do Xcode

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 atual, siga estas etapas:

1. Abra o Xcode project ou workspace 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".
4. Na janela Escolher produtos do pacote, verifique se GoogleNavigation será adicionado ao destino main designado. Quando terminar, clique em "Adicionar pacote".
5. Para verificar a instalação, navegue até o painel Geral do destino. Em Frameworks, Libraries, and Embedded Content, você vai encontrar os pacotes instalados. Você também pode conferir a seção "Dependências de pacote" do "Navegador de projetos" 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 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, 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:
   • GoogleMaps
   • GoogleMapsResources
   • GoogleNavigation
   • GoogleNavigationResources
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
   • 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. 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 do uso da localização durante o uso)
      Valor: "Este app precisa de permissão para usar sua localização na navegação guiada."
    • 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 guiada."

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