Instalar o SDK do consumidor para iOS

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

1. Abra o Xcode project ou workspace 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 "Adicionar pacote".
3. Para instalar um version específico, defina o campo Regra de dependência como uma das opções baseadas na 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, acesse a seção Dependências do pacote 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 do projeto do Xcode, encontre Frameworks, bibliotecas e conteúdo incorporado. Use o sinal de menos(-) para remover o seguinte framework:

   • GoogleRidesharingConsumer.xcframework

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

Usar o 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 consumidor: 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 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 'GoogleRidesharingConsumer'
      end
      

   3. Salve o Podfile: abra um terminal e acesse a pasta com o Podfile:

      cd <path-to-project>
      

3. Executar o comando pod install: esse comando instala as APIs especificadas no Podfile, junto com 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 Xcode. Para abrir o projeto mais tarde, use o arquivo .xcworkspace.

Instalação manual

Este guia mostra 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. É possível 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:

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

2. Descompacte os arquivos ZIP 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 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. Arraste o arquivo gRPCCertificates.bundle salvo para o diretório de nível superior do projeto do Xcode. Se solicitado, selecione Copiar itens.

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

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

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

9. Abra a guia Build Phases e, em Link Binary with Libraries, adicione os seguintes frameworks e bibliotecas, caso ainda não estejam 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 o 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, mude o filtro na barra Build Settings de Basic para All.