Instalar o SDK do consumidor para iOS

Selecione a plataforma: Android iOS JavaScript

Para acompanhar viagens sob demanda nos seus apps de consumidor do iOS, use o SDK do consumidor. Para mais informações e uma introdução ao acompanhamento de viagens, consulte Acompanhar uma viagem no iOS.

Para configurar o SDK do consumidor no seu aplicativo para o consumidor do iOS, siga estas etapas:

  1. Verifique os requisitos mínimos do sistema.
  2. Acesse o SDK do consumidor.
  3. Inspecione o arquivo de manifesto de privacidade da Apple.
  4. Configure um projeto do Console do Google Cloud.
  5. Receba tokens de autenticação.
  6. Inicialize o SDK do consumidor.

Verificar os requisitos mínimos do sistema

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

Você instala e configura o SDK do consumidor com o CocoaPods.

Gerenciador de pacotes do Swift

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

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-consumer-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 consumidor 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:

    • GoogleRidesharingConsumer.xcframework

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

Usar o CocoaPods

  1. Instale a ferramenta CocoaPods: abra uma janela do terminal e execute o comando a seguir:

    sudo gem install cocoapods

    Para mais detalhes, consulte o Guia de primeiros passos do CocoaPods.

  2. Crie um Podfile para o SDK do consumidor: 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 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 'GoogleRidesharingConsumer'
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 instala 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.

Instalação manual

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

  • Instale o SDK do Maps.

  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 ou crie um projeto. Se você não conhece o iOS, crie um projeto e selecione o modelo de app iOS.

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

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

  6. Para instalar o SDK do consumidor, arraste o arquivo GoogleRidesharingConsumer.xcframework para o projeto em Frameworks, Libraries, and Embedded Content. Se solicitado, selecione Copy items.

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

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

  9. 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
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • Metal.framework
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework

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