Para acompanhar viagens sob demanda nos seus apps para consumidores iOS, use o SDK para consumidores. Para mais informações e uma introdução sobre como seguir viagens, consulte Seguir uma viagem no iOS.
Para configurar o SDK do consumidor para seu app de consumidor iOS, siga estas etapas:
- Verifique os requisitos mínimos do sistema.
- Faça o download do SDK do consumidor.
- Inspecione o arquivo do Manifesto de privacidade da Apple.
- Configure um projeto do Console do Google Cloud.
- Receber tokens de autenticação.
- Inicialize o SDK do consumidor.
Verificar os requisitos mínimos do sistema
Verifique nas notas da versão os requisitos mínimos da versão do SDK do consumidor que você está usando. Consulte as Notas da versão.
- O dispositivo móvel precisa ter o iOS 14 ou mais recente.
- Versão 15 ou mais recente do Apple Xcode.
Instalar o SDK do consumidor
Você instala e configura o SDK do consumidor com o CocoaPods.
Gerenciador de pacotes do Swift
O SDK do consumidor pode ser instalado pelo Gerenciador de pacotes do Swift. Para adicionar o SDK, remova todas as dependências do SDK do consumidor.
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-consumer-sdk como o URL, pressione Enter para extrair 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 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".
Para atualizar o package
de um projeto existente, siga estas etapas:
- Para verificar a instalação, acesse a seção Dependências do pacote do Project Navigator para verificar o pacote e a versão dele.
Para remover o SDK do consumidor instalado manualmente, siga estas etapas:
Nas configurações de configuração do projeto do Xcode, encontre Frameworks, bibliotecas e conteúdo incorporado. Use o sinal de menos
(-)
para remover o seguinte framework:GoogleRidesharingConsumer.xcframework
No diretório de nível superior do seu projeto Xcode, remova o pacote
GoogleRidesharingConsumer
.
Usar o CocoaPods
Instale a ferramenta CocoaPods: abra uma janela do terminal e execute o seguinte comando:
sudo gem install cocoapods
Para mais detalhes, consulte o Guia explicativo do CocoaPods.
Criar um Podfile para o SDK do consumidor: use o Podfile para instalar a API e as dependências dela.
Crie um arquivo chamado
Podfile
no seu diretório do projeto Esse arquivo define as dependências do projeto.Edite o Podfile e adicione as dependências. Confira um exemplo que inclui as dependências:
source "https://github.com/CocoaPods/Specs.git" target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleRidesharingConsumer' end
Salve o Podfile: abra um terminal e acesse a pasta com o Podfile:
cd <path-to-project>
Execute o comando de instalação do pod: esse comando instala as APIs especificadas no Podfile com todas as dependências que elas possam ter.
pod install
Abra seu projeto no Xcode: feche o Xcode e clique duas vezes no arquivo .xcworkspace do projeto para iniciar o Xcode. Para abrir o projeto mais tarde, use o arquivo .xcworkspace.
Instalação manual
Este guia mostra como adicionar manualmente o XCFramework que contém o SDK do consumidor ao projeto e definir as configurações de build no Xcode.
Antes de seguir este guia, faça o seguinte:
Faça o download do XCFramework, um pacote binário usado para instalar o SDK do consumidor. É possível usar esse pacote em várias plataformas, incluindo máquinas que usam o chipset M1.
Instale o SDK do Maps.
Faça o download do binário e dos recursos do SDK:
Descompacte os arquivos ZIP para acessar o XCFramework e os recursos.
Inicie o Xcode e abra ou crie um projeto. Se você é novo no iOS, crie um novo projeto e selecione o modelo de app iOS.
Se o grupo do projeto não tiver um grupo do Frameworks, crie-o.
Arraste o arquivo
gRPCCertificates.bundle
salvo para o diretório de nível superior do seu projeto Xcode. Se solicitado, selecione Copiar itens.Para instalar o SDK do consumidor, arraste o arquivo
GoogleRidesharingConsumer.xcframework
para o projeto em Frameworks, bibliotecas e conteúdo incorporado. Se solicitado, selecione Copiar itens.Arraste o
GoogleRidesharingConsumer.bundle
salvo para o diretório de nível superior do projeto do Xcode. Se solicitado, selecione Copiar itens.Selecione o projeto no Navegador de projetos e escolha o destino do aplicativo.
Abra a guia Build Phases e, em Link Binary with Libraries, adicione os seguintes frameworks e bibliotecas, se eles ainda não estiverem presentes:
Accelerate.framework
CoreData.framework
CoreGraphics.framework
CoreImage.framework
CoreLocation.framework
CoreTelephony.framework
CoreText.framework
GLKit.framework
ImageIO.framework
libc++.tbd
libz.tbd
Metal.framework
OpenGLES.framework
QuartzCore.framework
SystemConfiguration.framework
UIKit.framework
Escolha seu projeto, em vez de um destino específico, e abra a guia Build Settings. Na seção Other Linker Flags, adicione
-ObjC
para depuração e lançamento.Se essas configurações não estiverem visíveis, altere o filtro na barra Build Settings de Basic para All.
Inspecionar o arquivo de manifesto de privacidade da Apple
A Apple exige detalhes de privacidade de apps na App Store. Acesse a página de detalhes de privacidade da App Store da Apple para atualizações e mais informações.
O arquivo do Manifesto de privacidade da Apple está incluído no pacote de recursos do SDK. Para verificar se o arquivo do manifesto de privacidade foi incluído e inspecionar o conteúdo dele, crie um arquivo do seu app e gere um relatório de privacidade.