Instalar o SDK do consumidor para iOS

Selecione a plataforma: Android iOS JavaScript

Para acompanhar viagens sob demanda nos seus apps iOS para o consumidor, use SDK do consumidor. Para mais informações e uma introdução aos viagens usando o compartilhamento de jornadas, consulte Seguir uma viagem no iOS

Para ver exemplos, consulte os apps de exemplo para iOS ou amostras combinadas.

Para configurar o SDK do consumidor para seu app de consumidor iOS, siga estas etapas:

1. Verifique os requisitos mínimos do sistema.
2. Instalar o SDK do consumidor
3. Inspecione o arquivo do 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

Verifique nas notas da versão os requisitos mínimos para a versão do SDK do consumidor 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.

Instalar o SDK do consumidor

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

Gerenciador de pacotes do Swift

O SDK para o consumidor 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 existentes do SDK do consumidor.

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-consumer-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 GoogleRidesharingConsumer 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 do SDK do consumidor 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 consumidor 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:

   • GoogleRidesharingConsumer.xcframework

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

Usar o CocoaPods

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

   sudo gem install cocoapods
   

   Para mais detalhes, consulte a Guia de iniciação do CocoaPods (em inglês).

2. Criar um Podfile para o SDK de consumidor: você use o Podfile para instalar a API e as dependências dela.

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

   2. Edite o Podfile e adicione as dependências. Aqui está 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 o Podfile:

      cd <path-to-project>
      

3. Execute o comando de instalação do pod: este comando instala as APIs especificados no Podfile, além das respectivas dependências.

   pod install
   

4. Abrir seu projeto no Xcode: feche o Xcode e clique duas vezes. arquivo .xcworkspace de seu projeto para iniciar o Xcode. Para abrir o projeto depois, 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 Versões do SDK para consumidores nas notas da versão do SDK do consumidor.

Instalação manual

Este guia mostra como adicionar manualmente o XCFramework que contém os 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 consumidor sempre que 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 consumidor. É possível usar esse pacote em várias plataformas, incluindo que usam o chipset M1.

• Instale o SDK do Maps.

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

   • GoogleRidesharingConsumer.xcframework
   • GoogleRidesharingConsumer.bundle
   • gRPCCertificates.bundle

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 tem experiência com o iOS, crie um novo projeto e selecione o modelo de app iOS.

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

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

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

7. Arraste o GoogleRidesharingConsumer.bundle baixado para a diretório de nível superior do seu projeto Xcode. Se solicitado, selecione Copiar itens

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

9. Abra a guia Fases de build e, em Vincular binário a bibliotecas, adicione os seguintes frameworks e bibliotecas, se ainda não estiverem presente:

   • 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 o Guia Configurações da versão. Na seção Outras sinalizações do vinculador, adicionamos -ObjC para depuração e lançamento.

    Se essas configurações não estiverem visíveis, altere o filtro na Barra Configurações da versão de Básico para Todos.

Inspecionar o 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