Instalar o SDK do Driver

Esta seção descreve como verificar se o sistema atende aos requisitos mínimos, configure seu grupo do Workspace e faça 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 nas notas da versão os requisitos mínimos para a 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.
• Xcode da Apple versão 15 ou mais recente.

Acessar seu Google Workspace

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

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

   Por exemplo, como prática recomendada, dê um nome ao grupo [e-mail] durante a integração.

2. Forneça 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 são incluídos nessa lista.

Caso sua organização não possa criar grupos no Workspace,envie uma lista ao Google. de e-mails de usuários e contas de serviço que precisam de acesso a esses artefatos.

Observação: os Grupos do Google Workspace não são a mesma coisa que os 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 autenticar no APIs e serviços do Google. Para mais detalhes, consulte a seção sobre a conta de serviço. na página "Métodos de autenticação no Google".

• Caso seu processo seja executado em um ambiente do Google Cloud, use 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 função a variável de ambiente apropriada. Para mais detalhes, consulte GOOGLE_APPLICATION_CREDENTIALS.

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

Instalar o SDK do Driver

Instale e configure o SDK do driver.

CocoaPods

1. Instale a ferramenta CocoaPods: abra uma janela do terminal e execute o seguinte kubectl.

   sudo gem install cocoapods
   

   Para mais detalhes, consulte o Guia explicativo do CocoaPods.

2. Criar um Podfile para o SDK do driver: você usa 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 as dependências. Aqui está um exemplo inclui as dependências:

      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      

      Este é 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 especificados no Podfile, além das respectivas dependências.

   pod install
   

4. Abra seu projeto no Xcode: feche o Xcode e abra. (clique duas vezes) no arquivo .xcworkspace do seu projeto para iniciar o Xcode. Para abrir 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 obter mais informações, consulte SDK do Driver para versões do iOS.

Gerenciador de pacotes do Swift

O SDK do Driver pode ser instalado via Gerenciador de pacotes do Swift (em inglês). Para adicionar o SDK, verifique se você tem removeu todas as dependências atuais do SDK do Driver.

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

Para adicionar o SDK a um projeto novo ou existente, siga estas etapas:

1. Abra seu Xcode project ou workspace e acesse File > Adicionar dependências de pacote.
2. Digite https://github.com/googlemaps/ios-driver-sdk como o URL e pressione Enter. para extrair o pacote e clicar em "Adicionar pacote".
3. Para instalar um version específico, defina o campo Regra de dependência como um dos as opções baseadas em versão. Para novos projetos, recomendamos especificar a versão mais recente e usando a "versão exata" é a melhor opção. Quando terminar, clique em "Adicionar pacote".
4. Na janela Choose Package Products, verifique se GoogleRidesharingDriver será adicionado a sua meta de main designada. Quando terminar, clique em "Adicionar pacote".
5. Para verificar sua instalação, navegue até o painel General do destino. Em Frameworks, bibliotecas e conteúdo incorporado, você verá os pacotes instalados. Também é possível consultar a página "Package Dependencies" do "Navegador do projeto" para verificar o pacote e sua versão.

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

1. Se você estiver fazendo upgrade de uma versão anterior à 9.0.0, será necessário remover das seguintes dependências: GoogleMapsBase, GoogleMapsCore e GoogleMapsM4B após o upgrade. Não remova a dependência de GoogleMaps: Para mais informações, consulte a Notas de lançamento da versão 9.0.0.

   Nas configurações do seu projeto do Xcode, localize Frameworks, bibliotecas, e conteúdo incorporado. Use o sinal de menos(-) para remover o seguinte framework:

   • GoogleMapsBase (apenas para upgrades de versões anteriores à 9.0.0)
   • GoogleMapsCore (apenas para upgrades de versões anteriores à 9.0.0)
   • GoogleMapsM4B (apenas para upgrades de versões anteriores à 9.0.0)
2. No Xcode, vá para "File > Pacotes > Atualize para as versões mais recentes do pacote".
3. Para verificar a instalação, vá para a seção Package Dependencies do Project Navigator para verificar o pacote e sua versão.

.

Importante:às vezes, os artefatos não podem ser resolvidos ou podem ocorrer erros. Nesse caso, selecione "Arquivo > Pacotes > Redefinir cache de pacotes".

Para remover as dependências atuais do SDK do Driver adicionadas usando CocoaPods, siga estas etapas:

1. Feche seu espaço de trabalho do Xcode. Abra o terminal e execute o seguinte comando:

   sudo gem install cocoapods-deintegrate cocoapods-clean 
   pod deintegrate 
   pod cache clean --all

2. Remova Podfile, Podfile.resolved e Xcode workspace, se você não estiver usando para algo diferente do CocoaPods.

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 menos(-) para remover a seguinte estrutura:

   • GoogleRidesharingDriver.xcframework

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

Instalação manual

Este guia mostra como adicionar manualmente o XCFramework que contém os Driver SDK ao seu projeto e defina as configurações de compilação no Xcode.

Atenção: 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:

• Baixe o XCFramework, um pacote binário usado para instalar a SDK do Driver. É possível usar esse pacote em várias plataformas, incluindo Máquinas que usam Apple Silicon

• Instale o SDK do Navigation.

Siga estas etapas para instalar manualmente o SDK do Driver:

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ê estiver novo no iOS, crie um novo projeto e selecione o modelo de aplicativo iOS.

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

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

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

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

8. Abra a guia Fases de build e, em Vincular binário a bibliotecas, adicione o 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 o Build Configurações. Na seção Outras sinalizações do vinculador, adicione -ObjC para depurar e lançar.

   Se essas configurações não estiverem visíveis, altere filtro na barra Build Settings de Basic para All.

Inspecionar arquivo do 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.

A seguir

Configure um projeto do Console do Google Cloud