Nesta seção, descrevemos como verificar se o sistema atende aos requisitos mínimos, configurar seu grupo do Workspace e acessar o SDK Driver.
Antes de começar
O SDK Driver para iOS exige que seu app atenda aos seguintes critérios:
- Ter o SDK do Navigation.
- Ative o SDK do Maps para iOS no console do Google Cloud e gere uma chave de API.
Verificar os requisitos mínimos do sistema
Confira as notas da versão para saber os requisitos mínimos da versão do SDK Driver que você está usando. Consulte as Notas da versão.
- O dispositivo móvel precisa ter o iOS 16 ou uma versão mais recente.
- Apple Xcode versão 26 ou mais recente.
Acessar o Google Workspace
Se você for cliente do Google Workspace,siga estas etapas:
Crie um grupo do Workspace. Para mais informações, consulte Grupo do Workspace.
Por exemplo, como prática recomendada, nomeie seu grupo
google-maps-platform-sdk-users@workspacedomain.comdurante a integração.Informe o nome ao Google para adicionar seu grupo do Workspace a uma lista de permissões que concede acesso aos repositórios corretos do CocoaPods.
Confirme se os e-mails de usuários e contas de serviço que precisam de acesso estão incluídos nessa lista.
Se sua organização não puder criar grupos do Workspace, envie ao Google uma lista de e-mails de usuários e contas de serviço que precisam de acesso a esses artefatos.
Fazer login com o SDK Cloud
Para desenvolvimento local, faça login com o SDK Cloud. Para mais detalhes, consulte Instalar a CLI gcloud.
Os exemplos a seguir mostram como fazer login com o SDK Cloud.
gcloud
gcloud auth login
Você precisa usar um e-mail que seja membro do grupo do Workspace.
Configurar os hosts de automação
Para sistemas de build ou integração contínua, configure seus hosts de automação com base na lista de métodos fornecida para usar uma conta de serviço e fazer a autenticação em APIs e serviços do Google. Para mais detalhes, consulte a seção de contas de serviço na página "Métodos de autenticação no Google".
Se o processo for executado em um ambiente do Google Cloud, use a detecção automática de credenciais. Para mais informações, consulte detecção automática de credenciais.
Caso contrário, armazene o arquivo de chave da conta de serviço em um local seguro no sistema de arquivos do host e defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS de maneira adequada. Para mais detalhes, consulte GOOGLE_APPLICATION_CREDENTIALS.
O e-mail da conta de serviço associado às credenciais precisa ser membro do grupo do Workspace.
Baixar o SDK do Driver
Instale e configure o SDK Driver.
CocoaPods
Instale a ferramenta CocoaPods: abra uma janela do terminal e execute o seguinte comando.
sudo gem install cocoapodsPara mais detalhes, consulte o guia de primeiros passos do CocoaPods.
Crie um Podfile para o SDK Driver: use o Podfile para instalar a API e as dependências dela.
Crie um arquivo chamado
Podfileno seu diretório do projeto Esse arquivo define as dependências do projeto.Edite o Podfile e adicione suas 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 'GoogleRidesharingDriver' endConfira um exemplo que inclui os pods Alfa e Beta do SDK Driver como dependências:
source "https://cpdc-eap.googlesource.com/ridesharing-driver-sdk.git" source "https://github.com/CocoaPods/Specs.git" target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleRidesharingDriver' endSalve o Podfile: abra um terminal e acesse a pasta com o Podfile:
cd <path-to-project>
Execute o comando pod install: esse comando instala as APIs especificadas no Podfile, além de todas as dependências que elas possam ter.
pod installAbra seu projeto no Xcode: feche o Xcode e abra (clique duas vezes) o arquivo .xcworkspace do projeto para iniciar o Xcode. Para abrir o projeto mais tarde, use o arquivo .xcworkspace.
Gerenciador de pacotes do Swift
O SDK Driver pode ser instalado usando o Swift Package Manager. Para adicionar o SDK, remova todas as dependências atuais do SDK Driver.
Para adicionar o SDK a um projeto novo ou atual, siga estas etapas:
-
Abra o Xcode
projectouworkspacee acesse Arquivo > Adicionar dependências de pacote. - Insira https://github.com/googlemaps/ios-driver-sdk como o URL, pressione Enter para extrair o pacote e clique em "Adicionar pacote".
-
Para instalar um
versionespecí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". -
Na janela Escolher produtos do pacote, verifique se
GoogleRidesharingDriverserá adicionado ao destinomaindesignado. Quando terminar, clique em "Adicionar pacote". - Para verificar a instalação, acesse o painel Geral do destino. Em Frameworks, Libraries, and Embedded Content, você vai encontrar 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, siga estas etapas:
- No Xcode, acesse Arquivo > Pacotes > Atualizar para as versões mais recentes do pacote.
- Para verificar a instalação, acesse a seção Dependências de pacote do Navegador de projetos e confira o pacote e a versão dele.
Para remover o SDK Driver instalado manualmente, siga estas etapas:
Nas configurações de configuração do projeto do Xcode, encontre Frameworks, Libraries, and Embedded Content. Use o sinal de menos
(-)para remover o seguinte framework:GoogleRidesharingDriver.xcframework
No diretório de nível superior do projeto do Xcode, remova o pacote
GoogleRidesharingDriver.
Instalação manual
Este guia mostra como adicionar manualmente o XCFramework que contém o SDK Driver ao seu projeto e configurar as opçõ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 Driver. É possível usar esse pacote em várias plataformas, incluindo máquinas com Apple Silicon
Instale o SDK Navigation.
Siga estas etapas para instalar manualmente o SDK Driver:
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ê não conhece o iOS, crie um projeto e selecione o modelo de app iOS.
Se o grupo do projeto não tiver um grupo "Frameworks", crie um.
Para instalar o SDK Driver, arraste o arquivo
GoogleRidesharingDriver.xcframeworkpara o projeto em Frameworks, Libraries, and Embedded Content. Se for solicitado, selecione Copiar itens.Arraste o
GoogleRidesharingDriver.bundlebaixado para o diretório de nível superior do seu projeto Xcode. Se for solicitado, selecione Copiar itens.Selecione seu 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 ainda não estiverem presentes:
Accelerate.frameworkAudioToolbox.frameworkAVFoundation.frameworkCoreData.frameworkCoreGraphics.frameworkCoreLocation.frameworkCoreTelephony.frameworkCoreText.frameworkGLKit.frameworkImageIO.frameworklibc++.tbdlibxml2.tbdlibz.tbdLocalAuthentication.frameworkOpenGLES.frameworkQuartzCore.frameworkSystemConfiguration.frameworkUIKit.frameworkWebKit.framework
Escolha seu projeto, em vez de um destino específico, e abra a guia Configurações de build. Na seção Outras flags do vinculador, adicione
-ObjCpara depuração e lançamento.Se essas configurações não estiverem visíveis, mude o filtro na barra Configurações de build de Básico para Tudo.
Inspecionar o arquivo de manifesto de privacidade da Apple
A Apple exige detalhes de privacidade dos 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 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.
A seguir
Configurar um projeto do console do Google Cloud