Configurar um projeto do Xcode

Depois de ativar o faturamento e criar uma chave de API, você poderá configurar o projeto do Xcode usado para desenvolver seu app.

As notas da 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 Places para iOS, você precisa do seguinte:

  • Xcode versão 16.0 ou mais recente

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

Gerenciador de pacotes do Swift

O SDK do Places para iOS pode ser instalado pelo Swift Package Manager. 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 existente, siga estas etapas:

  1. Abra o project ou workspace do Xcode e acesse Arquivo > Adicionar dependências de pacote.
  2. Insira https://github.com/googlemaps/ios-places-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 GooglePlaces, GooglePlacesSwift ou ambos serão adicionados ao destino principal designado. Quando terminar, clique em Adicionar pacote.

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

    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 acessada pelo URL antigo, https://github.com/googlemaps/ios-places-swift-sdk, remova-a da seção de dependências de pacote do Xcode.

  5. Para verificar a instalação, navegue até o painel Geral do destino. Em Frameworks, bibliotecas e conteúdo incorporado, 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".

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

    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 acessada pelo URL antigo, https://github.com/googlemaps/ios-places-swift-sdk, remova-a da seção de dependências de pacote do Xcode.

  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.

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 do Xcode, remova o pacote GooglePlaces.

Instalação manual

Neste guia, mostramos como adicionar manualmente os XCFrameworks que contêm o SDK do Places para iOS e o SDK do Places Swift 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 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:
  2. Se você estiver instalando o SDK do Places Swift para iOS, instale os seguintes arquivos:
  3. Extraia os arquivos para acessar o XCFramework e os recursos.
  4. Inicialize o Xcode e abra ou crie um 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 Geral. Arraste o seguinte XCFramework para seu projeto em Frameworks, Libraries, and Embedded Content. Selecione Não incorporar:
    • GooglePlaces.xcframework
    Se você estiver instalando o SDK do Places para Swift, arraste o seguinte XCFramework para o projeto em Frameworks, Libraries, and Embedded Content. Selecione Não incorporar:
    • GooglePlacesSwift.xcframework
  7. Copie o GooglePlaces.bundle do GooglePlacesResources baixado para o diretório de nível superior do projeto Xcode. Selecione Copiar itens para a pasta do grupo de destino quando solicitado.

    Se você estiver instalando o SDK do Places para Swift, copie o GooglePlacesSwift.bundle do GooglePlacesSwiftResources baixado para o diretório de nível superior do seu projeto do Xcode. Selecione Copiar itens para a pasta do grupo de destino quando solicitado.
  8. Selecione o projeto no Project Navigator e escolha o local de destino do aplicativo.
  9. Abra a guia Fases de compilação. 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 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, mude o filtro na barra Build Settings de Basic para All.

CocoaPods

O SDK do Places para iOS e o SDK do Places Swift para iOS estão disponíveis como pods do CocoaPod (em inglês), GooglePlaces e GooglePlacesSwift.

O CocoaPods é um gerenciador de dependências de código aberto para projetos Cocoa em Swift e Objective-C. Se você ainda não tem essa ferramenta, instale-a no macOS executando o seguinte comando no terminal. Para saber mais, consulte o Guia de primeiros passos do CocoaPods (em inglês).

sudo gem install cocoapods

Crie um Podfile para instalar os SDKs e as dependências deles:

  1. Se você ainda não tiver um projeto Xcode, crie um agora e salve-o no computador local. Se você tem pouca experiência com desenvolvimento para iOS, crie um novo projeto e selecione o modelo de app iOS.
  2. Crie um arquivo chamado Podfile no seu diretório do projeto para definir as dependências.
  3. Edite o Podfile e adicione suas dependências com as respectivas versões. Confira um exemplo que especifica o nome de destino do aplicativo e os nomes dos pods GooglePlaces e GooglePlacesSwift: 
    source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '16.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '10.1.0'
  pod 'GooglePlacesSwift', '10.1.0'
end
     Execute pod outdated regularmente para detectar quando houver uma versão mais recente e garantir que você sempre tenha a 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 instalará as APIs especificadas no Podfile e as respectivas dependências.

    pod install

  7. Feche o Xcode e clique duas vezes no arquivo .xcworkspace do projeto para iniciar o programa. Depois disso, é preciso usar 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 vai atualizar todas as APIs especificadas no Podfile para a versão mais recente.

Etapa 3: adicionar a chave de API ao seu app

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

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

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

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

Próximas etapas