Configurar um projeto do Xcode

Gerenciador de pacotes do Swift

O SDK do Places para iOS pode ser instalado pelo Gerenciador de pacotes do Swift. Para adicionar o SDK, remova todas as dependências atuais do SDK do Places 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-places-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 GooglePlaces, GooglePlacesSwift ou ambos serão adicionados ao destino principal designado. Quando terminar, clique em Add Package.

   Se você estiver atualizando o Google Places Swift do URL do GitHub descontinuado

   Importante:o URL do GitHub para acessar o Google Places Swift mudou a partir da versão 0.3.0. Se você estiver atualizando uma versão do GooglePlacesSwift que foi acessada pelo URL antigo, https://github.com/googlemaps/ios-places-swift-sdk, remova-o da seção de dependências de pacote do Xcode.

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. No Xcode, acesse File > Packages > Update To Latest Package Versions.

   Se você estiver atualizando o Google Places Swift do URL do GitHub descontinuado

   Importante:o URL do GitHub para acessar o Google Places Swift mudou a partir da versão 0.3.0. Se você estiver atualizando uma versão do GooglePlacesSwift que foi acessada pelo URL antigo, https://github.com/googlemaps/ios-places-swift-sdk, remova-o da seção de dependências de pacote do Xcode.

2. 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 o SDK do Places 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 os seguintes frameworks:
   • GooglePlaces.xcframework
   • GooglePlacesSwift.xcframework
2. No diretório de nível superior do projeto Xcode, remova o GooglePlaces pacote.

Instalação manual

Este guia mostra como adicionar manualmente os XCFrameworks que contêm o SDK do Places para iOS e o SDK do Places Swift 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 Apple Silicon. Você pode adicionar o SDK do Places para iOS, o SDK do Places Swift para iOS ou ambos.

1. Faça o download dos seguintes arquivos binários e de recursos do SDK:
   • GooglePlaces
   • GooglePlacesResources
2. Se você estiver instalando o SDK do Places Swift para iOS, instale os seguintes arquivos:
   • GooglePlacesSwift
   • GooglePlacesSwiftResources
3. Extraia os arquivos para acessar o XCFramework e os recursos.
4. Inicialize o Xcode e abra ou crie um novo projeto. Se você tem pouca experiência com desenvolvimento para iOS, crie um novo projeto e selecione o modelo de app iOS.
5. Remova todas as versões anteriores do Maps do projeto.
6. Abra a guia General. Arraste o XCFramework a seguir para o projeto em Frameworks, Libraries, and Embedded Content. Selecione Do Not Embed:
   • GooglePlaces.xcframework
   Se você estiver instalando o SDK do Places Swift, arraste o XCFramework a seguir para o projeto em Frameworks, Libraries, and Embedded Content. Selecione Do Not Embed:
   • GooglePlacesSwift.xcframework
7. Copie o GooglePlaces.bundle do GooglePlacesResources que você baixou para o diretório de nível superior do projeto Xcode. Selecione Copy items into destination group's folder quando solicitado.
   
   Se você estiver instalando o SDK do Places Swift, copie o GooglePlacesSwift.bundle do GooglePlacesSwiftResources que você baixou para o diretório de nível superior do projeto Xcode. Selecione Copy items into destination group's folder quando solicitado.
8. Selecione o projeto no Project Navigator e escolha o local de destino do aplicativo.
9. Abra a guia Build Phases. Em Link Binary with Libraries, adicione os seguintes frameworks e bibliotecas:
   • CoreGraphics.framework
   • CoreLocation.framework
   • libc++.tbd
   • libz.tbd
   • QuartzCore.framework
   • UIKit.framework

10. Escolha seu projeto, em vez de um destino específico, e abra a Build Settings guia. 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.

GooglePlacesSwift

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

• Adicione a seguinte declaração de importação:

  import GooglePlacesSwift

• Adicione o seguinte ao método application(_:didFinishLaunchingWithOptions:), substituindo YOUR_API_KEY pela chave de API:

  PlacesClient.provideAPIKey("YOUR_API_KEY")

Swift

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

• Adicione a seguinte declaração de importação:

  import GooglePlaces

• Adicione o seguinte ao método application(_:didFinishLaunchingWithOptions:), substituindo YOUR_API_KEY pela chave de API:

  GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

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

• Adicione a seguinte declaração de importação:

  @import GooglePlaces;

• Adicione o seguinte ao método application:didFinishLaunchingWithOptions:, substituindo YOUR_API_KEY pela chave de API:

  [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];