Configurar um projeto do Xcode

Gerenciador de pacotes do Swift

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

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-maps-sdk como o 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".

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

1. Se você estiver fazendo upgrade de uma versão anterior à 9.0.0, remova as seguintes dependências: GoogleMapsBase, GoogleMapsCore, e GoogleMapsM4B após o upgrade. Não remova a dependência de GoogleMaps. Para mais informações, consulte as Notas de versão 9.0.0.

   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:

   • GoogleMapsBase (somente para upgrades de versões anteriores à 9.0.0)
   • GoogleMapsCore (somente para upgrades de versões anteriores à 9.0.0)
   • GoogleMapsM4B (somente para upgrades de versões anteriores à 9.0.0)
2. No Xcode, acesse "File > Packages > Update To Latest Package Versions".
3. 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 as dependências do SDK do Maps para iOS adicionadas usando CocoaPods, siga estas etapas:

1. Feche o espaço de trabalho do Xcode. Abra o terminal e execute o seguinte comando:

   sudo gem install cocoapods-deintegrate cocoapods-clean
   pod deintegrate
   pod cache clean --all

2. Remova o Podfile, Podfile.resolved e o Xcode workspace se você não os estiver usando para nada além do CocoaPods.

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
   • GoogleMapsBase (somente para instalações anteriores à versão 9.2.0)
   • GoogleMapsCore (somente para instalações anteriores à versão 9.2.0)
   • GoogleMapsM4B (somente para instalações anteriores à versão 9.0.0)
2. No diretório de nível superior do projeto Xcode, remova o GoogleMaps pacote.

Instalação manual

Este guia descreve como adicionar manualmente os XCFrameworks que contêm o SDK do Maps para iOS ao projeto e configurar as configurações de build no Xcode. Um XCFramework é um pacote binário usado em várias plataformas, incluindo máquinas que usam o Apple Silicon.

1. Faça o download dos seguintes binários e arquivos de recursos do SDK:
   • GoogleMaps
   • GoogleMapsResources
2. Extraia os arquivos para acessar os XCFrameworks e recursos.
3. Se você ainda não tiver um projeto Xcode, crie um agora e salve-o no computador local. Se você é novo no 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 Project Name.
      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 Language como Swift ou Objective-C.
4. Abra a guia General. Arraste os seguintes XCFrameworks para o projeto em Frameworks, Libraries, and Embedded Content. Selecione Do Not Embed:
   • GoogleMaps.xcframework
5. Copie o GoogleMaps.bundle do GoogleMapsResources que você baixou para o diretório de nível superior do projeto Xcode. Selecione Copy items into destination group's folder quando solicitado.
6. Selecione o projeto no Project Navigator e escolha o local de destino do aplicativo.
7. Abra a guia Build Phases para o destino do aplicativo. Em Link Binary with Libraries, adicione os seguintes frameworks e bibliotecas:
   • Accelerate.framework
   • Contacts.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • MetricKit.framework
   • OpenGLES.framework (somente se você estiver usando OpenGL)
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework

8. Escolha seu projeto, em vez de um destino específico, e abra a guia Build Settings. Na seção Linking - General -> Other Linker Flags, adicione -ObjC a "Debug" e "Release". Se essas configurações não estiverem visíveis, altere o filtro na barra Build Settings de Basic para All.

9. Para instalar o XCFramework do SDK do Places para iOS, consulte Primeiros passos com o SDK do Places para iOS.

CocoaPods

O SDK do Maps 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ê não tiver a ferramenta CocoaPods, instale-a no macOS executando o seguinte comando no terminal. Para saber mais, consulte o Guia de primeiros passos do CocoaPods.

sudo gem install cocoapods

Crie um Podfile para o SDK do Maps para iOS e use isso para instalar 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ê é novo no 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 Project Name.
      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 Language 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 do Maps para iOS:

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '16.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GoogleMaps', '10.14.0'
   end

   Execute pod outdated regularmente para detectar quando uma versão mais recente existe e garantir que você esteja sempre na versão mais recente. 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 que elas têm.

   pod install

7. Feche o Xcode e clique duas vezes no arquivo .xcworkspace do projeto para iniciar o programa. A partir de então, use 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.

Swift

Inclua sua chave de API ao AppDelegate.swift da seguinte maneira:

1. Adicione esta declaração import:

   import GoogleMaps

2. Adicione o seguinte ao método application(_:didFinishLaunchingWithOptions:), usando sua chave de API:

   GMSServices.provideAPIKey("YOUR_API_KEY")

3. Se você também estiver usando a API Places, adicione a chave novamente da seguinte maneira:

   GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

Inclua sua chave de API ao AppDelegate.m da seguinte maneira:

1. Adicione esta declaração import:

   @import GoogleMaps;

2. Adicione o seguinte ao seu application:didFinishLaunchingWithOptions: método, usando sua chave de API:

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];

3. Se você também estiver usando a API Places, adicione a chave novamente da seguinte maneira:

   [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];