Instalar o SDK do Driver

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 14 ou uma versão mais recente.
• Apple Xcode versão 15 ou mais recente.

Acessar o Google Workspace

Se você for cliente do Google Workspace,siga estas etapas:

1. Crie um grupo de espaços de trabalho. Para mais informações, consulte Grupo do Workspace.

   Por exemplo, como prática recomendada, nomeie seu grupo [e-mail] durante a integração.

2. Informe o nome ao Google para adicionar seu grupo do Workspace a uma lista de permissões que concede acesso aos repositórios CocoaPods corretos.

3. 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.

Observação: os grupos do Workspace não são iguais aos Grupos do Google, que terminam em @googlegroups.com. Somente grupos do Workspace são aceitos.

Fazer login com o SDK do Cloud

Para desenvolvimento local, faça login com o SDK do Cloud. Para mais detalhes, consulte Instalar a CLI gcloud.

Os exemplos a seguir mostram como fazer login com o SDK do 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 se autenticar nas APIs e nos serviços do Google. Para 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.

Acessar o SDK do Driver

Instale e configure o SDK Driver.

CocoaPods

1. Instale a ferramenta CocoaPods: abra uma janela de terminal e execute o seguinte comando.

   sudo gem install cocoapods
   

   Para mais detalhes, consulte o Guia de primeiros passos do CocoaPods (em inglês).

2. Crie um Podfile para o SDK Driver: use o Podfile para instalar a API e as dependências dela.

   1. Crie um arquivo chamado Podfile no seu diretório do projeto Esse arquivo define as dependências do projeto.

   2. 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'
      end
      

      Confira 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'
      end
      

   3. Salve o Podfile: abra um terminal e acesse a pasta com o Podfile:

      cd <path-to-project>
      

3. Execute o comando pod install: esse comando instala as APIs especificadas no Podfile e as respectivas dependências.

   pod install
   

4. Abra 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.

   Observação: execute pod outdated periodicamente para detectar quando houver uma versão mais recente do SDK. Para mais informações, consulte Versões do SDK Driver para iOS.

Gerenciador de pacotes do Swift

O SDK Driver pode ser instalado pelo Swift Package Manager. Para adicionar o SDK, remova todas as dependências atuais do SDK Driver.

Importante: estas instruções pressupõem o uso do Xcode 15 ou mais recente, mas devem ser semelhantes para versões anteriores do Xcode.

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-driver-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".

Para atualizar o package de um projeto, siga estas etapas:

1. 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.

Importante:às vezes, não é possível resolver artefatos ou podem ocorrer erros. Nesse caso, selecione "File > Packages > Reset Package Cache".

Para remover o SDK Driver 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 subtração(-) para remover o seguinte framework:

   • GoogleRidesharingDriver.xcframework

2. No diretório de nível superior do projeto Xcode, remova o pacote GoogleRidesharingDriver.

Instalação manual

Neste guia, mostramos como adicionar manualmente o XCFramework que contém o SDK Driver ao projeto e configurar as opções de build no Xcode.

Atenção: como prática recomendada, use o Cocoapods para instalar o SDK Driver sempre que possível.

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 silicon da Apple

• Instale o SDK Navigation.

Siga estas etapas para instalar manualmente o SDK Driver:

1. Faça o download do binário e dos recursos do SDK:

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

2. Descompacte os arquivos ZIP para acessar o XCFramework e os recursos.

3. Inicie o Xcode e abra ou crie um projeto. Se você não tem experiência com iOS, crie um projeto e selecione o modelo de app iOS.

4. Se o grupo do projeto não tiver um grupo "Frameworks", crie um.

5. Para instalar o SDK Driver, arraste o arquivo GoogleRidesharingDriver.xcframework para o projeto em Frameworks, Libraries, and Embedded Content. Se solicitado, selecione Copiar itens.

6. Arraste o GoogleRidesharingDriver.bundle baixado para o diretório de nível superior do projeto Xcode. Se solicitado, selecione Copiar itens.

7. Selecione o projeto no Project Navigator e escolha o local de destino do aplicativo.

8. Abra a guia Build Phases e, em Link Binary with Libraries, adicione os seguintes frameworks e bibliotecas, se ainda não estiverem presentes:

   • Accelerate.framework
   • AudioToolbox.framework
   • AVFoundation.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libxml2.tbd
   • libz.tbd
   • LocalAuthentication.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework
   • WebKit.framework

9. Escolha seu projeto, em vez de um destino específico, e abra a guia Build Settings. Na seção Outras flags do vinculador, adicione -ObjC para depuração e lançamento.

   Se essas configurações não estiverem visíveis, mude 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 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.

A seguir

Configurar um projeto do console do Google Cloud