Configurar um projeto do Xcode

Depois de habilitar o faturamento e criar uma chave de API, configure o projeto Xcode usado para desenvolver seu app.

As notas de versão estão disponíveis para cada lançamento.

Etapa 1: instalar o software necessário

Para criar um projeto usando o SDK do Maps para iOS, baixe e instale:

• Xcode versão 26.0 ou mais recente

Etapa 2: criar o projeto Xcode e instalar o SDK do Maps para iOS

Observação: o SDK do Maps para iOS adiciona um tamanho médio de IPA de 5,7 MB para apps criados para dispositivos específicos. O tamanho do download para apps universais pode ser maior.

O tamanho da instalação do SDK varia. Por exemplo, o tamanho da instalação do SDK do Maps para iOS versão 9.0 é de cerca de 18 MB.

Observação: na versão 9.2.0, o GoogleMapsCore e o GoogleMapsBase são consolidados no XCFramework do GoogleMaps. Nenhuma outra configuração é necessária.

No momento, o SDK do Maps para iOS não oferece suporte a bibliotecas mescláveis. Para evitar falhas do vinculador durante builds de lançamento, verifique se a configuração Build Mergeable Library no projeto Xcode está definida como No (padrão).

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".
4. Na janela Choose Package Products, verifique se GoogleMaps (para versões anteriores à 9.0.0, verifique GoogleMaps, GoogleMapsBase, e GoogleMapsCore) será adicionado ao 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. Você também pode 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. 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 lançamento da 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.

Importante: às vezes, os artefatos não podem ser resolvidos ou erros podem ocorrer. Nesse caso, selecione "File > Packages > Reset Package Cache".

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.

Para remover o SDK do Maps 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 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. Baixe os 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.

Etapa 3: adicionar sua chave de API ao projeto

Em Gerar uma chave de API, você gerou uma chave de API para seu app. Agora, adicione essa chave ao projeto Xcode.

Nos exemplos a seguir, substitua YOUR_API_KEY pela chave de API.

Observação: se você gravou o identificador do pacote do projeto ou o recebeu das propriedades do projeto, use-o para restringir a chave de API para uso apenas com aplicativos iOS com esse identificador de pacote específico. Consulte Restringir chaves de API para mais informações.

Swift

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

1. Adicione a seguinte declaração de importação:

   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 desta maneira:

   GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

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

1. Adicione a seguinte declaração de importação:

   @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 desta maneira:

   [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

Etapa 4 (opcional): inspecionar o arquivo de manifesto de privacidade da Apple

Observação:o seguinte é relevante quando você implanta seu app na loja da Web.

A Apple exige detalhes de privacidade do app para apps na App Store. Acesse a página 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 do arquivo.

Etapa 5 (opcional): declarar os esquemas de URL usados pela API

A partir do iOS 9 e do Xcode 7, os apps declaram os esquemas de URL que pretendem abrir especificando os esquemas no arquivo Info.plist do app. O SDK do Maps para iOS abre o app móvel do Google Maps quando o usuário clica no logotipo do Google no mapa. Portanto, seu app pode declarar os esquemas de URL relevantes.

Para declarar os esquemas de URL usados pelo SDK do Maps para iOS, adicione as seguintes linhas ao Info.plist:

 <key>LSApplicationQueriesSchemes</key>
 <array>
        <string>googlechromes</string>
        <string>comgooglemaps</string>
    </array>

A imagem a seguir mostra a configuração na interface do usuário do Xcode:

Sem a declaração acima, os seguintes erros podem ocorrer quando o usuário toca no logotipo do Google no mapa:

• -canOpenURL: failed for URL: "comgooglemaps://" - error: "This app is not allowed to query for scheme comgooglemaps"
• -canOpenURL: failed for URL: "googlechromes://" - error: "This app is not allowed to query for scheme googlechromes"

Para eliminar esses erros, adicione a declaração ao Info.plist.

A seguir

Agora que você tem uma chave de API e um projeto Xcode, crie e execute apps. O SDK Navigation para iOS oferece vários tutoriais e apps de exemplo que ajudam você a começar. Confira mais detalhes em:

• Adicionar mapas com marcadores.
• Selecionar o lugar atual e mostrar detalhes em um mapa.
• Geocodificação inversa.
• Confira os exemplos de código e codelabs disponíveis.
• Para soluções de ponta a ponta, revise as soluções do Maps disponíveis.