Instalar o SDK do Driver

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

Antes de começar

O SDK do Driver para iOS exige que o app atenda aos seguintes critérios:

  • Ter o SDK do Navigation.
  • Ativar o SDK do Maps para iOS no console do Google Cloud e acessar uma chave de API.

Verificar os requisitos mínimos do sistema

Consulte as notas de lançamento para conferir os requisitos mínimos da versão do SDK do Driver que você está usando. Consulte as notas de lançamento.

  • 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:

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

    Por exemplo, como prática recomendada, nomeie seu grupo como google-maps-platform-sdk-users@workspacedomain.com 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 CocoaPods corretos.

  3. Confirme se os e-mails de usuário e de conta 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ário e de conta 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 os hosts de automação com base na lista de métodos fornecida para usar uma conta de serviço para autenticar 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.

Acessar 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 introdução do CocoaPods.

  2. Criar 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 diretório do projeto. para definir as dependências.

    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 vai instalar as APIs especificadas no Podfile e as respectivas dependências.

    pod install
    
  4. Abra seu projeto no Xcode: feche o Xcode e clique duas vezes no arquivo .xcworkspace do projeto para iniciar o programa. Para abrir o projeto mais tarde, use o arquivo .xcworkspace.

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.

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

  1. Abra o project ou workspace do Xcode 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 "Add Package".
  3. Para instalar um version específico, defina o campo Dependency Rule como uma das as opções baseadas na versão. Para novos projetos, recomendamos especificar a versão mais recente e usar a opção "Exact Version". Quando terminar, clique em "Add Package".

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

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

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

  1. Nas configurações de configuração do projeto do Xcode, encontre Frameworks, Libraries, and Embedded Content. Use o sinal de menos(-) para remover o framework a seguir:

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

Instalação manual

Neste guia, mostramos como adicionar manualmente o XCFramework que contém o SDK do Driver ao projeto e ajustar 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 Driver. Você pode usar esse pacote em várias plataformas, incluindo máquinas que usam o Apple Silicon

  • Instale o SDK do Navigation.

Siga estas etapas para instalar o SDK do Driver manualmente:

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

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

  3. Inicie o Xcode e abra um projeto atual ou crie um. Se você não conhece o iOS, crie um projeto e selecione o modelo de app iOS.

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

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

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

  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 frameworks e bibliotecas a seguir, 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 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 do app para apps na App Store. Acesse a página 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 a partir dele.

A seguir

Configurar um projeto do console do Google Cloud