Instalar o SDK do Driver

Esta seção descreve como verificar se o sistema atende aos requisitos mínimos, configurar seu grupo do Workspace e fazer o download do SDK do Driver.

Antes de começar

O SDK do 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

Verifique as notas da versão para conferir os requisitos mínimos da versão do SDK do driver 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.

Acessar o Google Workspace

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

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

   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 corretos do CocoaPods.

3. Confirme se os e-mails do usuário e da conta de serviço que precisam de acesso estão incluídos nessa lista.

Se a sua organização não conseguir criar Grupos do Workspace, envie ao Google uma lista de e-mails de usuários e contas de serviço que precisam acessar esses artefatos.

Observação: os Grupos do Workspace não são iguais aos Grupos do Google, que terminam em @googlegroups.com. Só é possível usar grupos do Workspace.

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 espaço de trabalho.

Configurar os hosts de automação

Para sistemas de build ou integração contínua, configure os hosts de automação com base na lista de métodos fornecida para usar uma conta de serviço para autenticação em APIs e serviços do Google. Para mais detalhes, consulte a seção da conta de serviço na página "Métodos de autenticação" do 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 adequadamente. Para mais detalhes, consulte GOOGLE_APPLICATION_CREDENTIALS.

O e-mail da conta de serviço associado às credenciais precisa ser membro do grupo do espaço de trabalho.

Instalar o SDK do Driver

Instale e configure o SDK do driver.

CocoaPods

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

   sudo gem install cocoapods
   

   Para mais detalhes, consulte o Guia de iniciação do CocoaPods.

2. Crie um Podfile para o SDK do 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 seu 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 do 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 de instalação do pod: esse comando instalará as APIs especificadas no Podfile com todas as dependências que elas possam ter.

   pod install
   

4. Abrir seu projeto no Xcode: feche o Xcode e clique duas vezes no arquivo .xcworkspace do seu projeto para iniciá-lo. Para abrir o projeto mais tarde, use o arquivo .xcworkspace.

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

Gerenciador de pacotes do Swift

O SDK do driver pode ser instalado pelo Gerenciador de pacotes do Swift. Para adicionar o SDK, remova todas as dependências do SDK do driver.

Importante: estas instruções consideram o uso do Xcode 15 ou mais recente, mas são semelhantes às versões anteriores.

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-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 existente, siga estas etapas:

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

Importante:às vezes, os artefatos não podem ser resolvidos ou podem ocorrer erros. Nesse caso, selecione "File > Packages > reset Package Cache".

Para remover o SDK do Driver atual instalado manualmente, siga estas etapas:

1. Nas configurações do projeto do Xcode, localize Frameworks, bibliotecas e conteúdo incorporado. 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

Este guia mostra como adicionar manualmente o XCFramework que contém o SDK do driver ao projeto e ajustar as configurações de build no Xcode.

Cuidado: como prática recomendada, use o Cocoapods para instalar o SDK do 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 do driver. É possível usar esse pacote em várias plataformas, incluindo máquinas que usam Apple silicon.

• Instale o SDK de navegação.

Siga estas etapas para instalar o SDK do driver manualmente:

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

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

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

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

4. Se o grupo de projeto não tiver um grupo de frameworks, crie um.

5. Para instalar o SDK do Driver, arraste o arquivo GoogleRidesharingDriver.xcframework para o projeto em Frameworks, bibliotecas e conteúdo incorporado. Se solicitado, selecione Copiar itens.

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

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

8. Abra a guia Fases de criação e, em Vincular binário a bibliotecas, adicione os seguintes frameworks e bibliotecas, se eles 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 Other Linker Flags, adicione -ObjC para depuração e versão.

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

A seguir

Configurar um projeto do console do Google Cloud