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 versão.

Etapa 1: instalar o software necessário

Para criar um projeto usando o SDK do Places para iOS, você vai precisar do seguinte:

  • Xcode versão 15.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 Gerenciador de pacotes do Swift. Para adicionar o SDK, remova todas as dependências do SDK do Places para iOS.

Para adicionar o SDK a um projeto novo ou existente, siga estas etapas:

  1. Abra o Xcode project ou workspace e acesse File > Add Package Dependencies.
  2. Insira https://github.com/googlemaps/ios-places-sdk como o URL, pressione Enter para importar 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 na 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 Add Package.

    Se você estiver atualizando o Google Places Swift

    Importante:o URL do GitHub para acessar o Google Places Swift foi alterado. 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 pacotes 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 do pacote do Project Navigator para verificar o pacote e a versão dele. O Xcode mostra a versão do GitHub, que corresponde à versão do GooglePlaces (por exemplo, 9.2.0), mas não corresponde à versão do GooglePlacesSwift (por exemplo, 0.3.0).

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 para Swift

    Importante:o URL do GitHub para acessar o Google Places Swift foi alterado. 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 pacotes do Xcode.

  2. Para verificar a instalação, vá para a seção Package Dependencies do Project Navigator para conferir o pacote e a versão dele.

Para remover o SDK do Places para iOS instalado manualmente, siga estas etapas:

  1. Nas configurações do projeto do Xcode, localize Frameworks, bibliotecas e conteúdo incorporado. Use o sinal de menos(-) para remover estes frameworks:
    • GooglePlaces.xcframework
    • GooglePlacesSwift.xcframework
  2. No diretório de nível superior do projeto Xcode, remova o pacote GooglePlaces.

Instalação manual

Este guia mostra como adicionar manualmente os XCFrameworks que contêm o SDK do Places para iOS e o SDK Swift do Places para iOS (pré-lançamento) 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 Apple Silicon. Você pode adicionar o SDK do Places para iOS, o SDK do Places Swift para iOS (pré-lançamento) 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 (pré-lançamento), 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 XCFramework a seguir para seu projeto em Frameworks, bibliotecas e conteúdo incorporado. Selecione Não incorporar:
    • GooglePlaces.xcframework
    Se você estiver instalando o SDK do Places Swift para iOS (pré-lançamento), arraste o seguinte XCFramework para o projeto em Frameworks, bibliotecas e conteúdo incorporado. Selecione Não incorporar:
    • GooglePlacesSwift.xcframework
  7. Copie o GooglePlaces.bundle do GooglePlacesResources que você fez o download 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 Swift para iOS (pré-lançamento), copie o GooglePlacesSwift.bundle do GooglePlacesSwiftResources que você fez o download para o diretório de nível superior do 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 build. 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, altere 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 (pré-lançamento) estão disponíveis como pods do CocoaPod, 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.

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 as dependências junto com as versões delas. 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, '15.0'
    
    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      pod 'GooglePlaces', '9.2.0'
      pod 'GooglePlacesSwift', '0.3.0'
    end
    Execute pod outdated regularmente para detectar quando há uma versão mais recente e garantir que você sempre tenha 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 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 app

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

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

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")

Etapa 4 (opcional): inspecionar o arquivo do 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 conferir 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 no arquivo.

Próximas etapas

  • Comece a escrever o código. Um ponto de partida recomendado é implementar um app inicial que consiga o local atual do usuário.
  • Depois de configurar o projeto, você pode conferir os apps de exemplo.