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:
-
Abra o Xcode
project
ouworkspace
e acesse File > Add Package Dependencies. - Insira https://github.com/googlemaps/ios-places-sdk como o URL, pressione Enter para importar o pacote e clique em "Adicionar pacote".
-
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". - 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. - 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:
-
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. - 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:
-
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
-
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.
- Faça o download dos seguintes arquivos binários e de recursos do SDK:
- Se você estiver instalando o SDK do Places Swift para iOS (pré-lançamento), instale os seguintes arquivos:
- Extraia os arquivos para acessar o XCFramework e os recursos.
- 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.
- Remova todas as versões anteriores do Maps do projeto.
-
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
GooglePlacesSwift.xcframework
-
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 oGooglePlacesSwift.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. - Selecione o projeto no Project Navigator e escolha o local de destino do aplicativo.
-
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
-
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:
- 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.
- Crie um arquivo chamado
Podfile
no seu diretório do projeto para definir as dependências. - 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 podsGooglePlaces
eGooglePlacesSwift
: Executesource '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
pod outdated
regularmente para detectar quando há uma versão mais recente e garantir que você sempre tenha a versão mais recente. - Salve o
Podfile
. Abra um terminal e acesse o diretório que contém o
Podfile
:cd <path-to-project>
Execute o comando
pod install
. Isso instalará as APIs especificadas noPodfile
e as respectivas dependências.pod install
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:
- Abra um terminal e acesse o diretório do projeto que contém o
Podfile
. - Execute o comando
pod update
. Isso vai atualizar todas as APIs especificadas noPodfile
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.