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 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 Regra de dependência como uma das opções baseadas em versão. Para novos projetos, recomendamos especificar a versão mais recente e usar a opção "Exact Version". Quando terminar, clique em "Adicionar pacote".
4. Na janela Choose Package Products, verifique se GoogleRidesharingConsumer será adicionado ao destino main designado. Quando terminar, clique em "Adicionar pacote".
5. Para verificar a instalação, acesse o painel Geral do destino. Em Frameworks, Libraries, and Embedded Content, você verá os pacotes instalados. Você também pode conferir a seção "Package Dependencies" do "Project Navigator" para verificar o pacote e a versão dele.

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

1. No Xcode, acesse File > Packages > Update To Latest Package Versions.
2. 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 do projeto do Xcode, encontre Frameworks, Libraries, and Embedded Content. Use o sinal de menos(-) para remover o seguinte framework:

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

   sudo gem install cocoapods
   

   Para mais detalhes, consulte o guia para iniciantes do CocoaPods.

2. Crie 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 as dependências. Veja 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 pod install: ele instala as APIs especificadas no Podfile, além de todas as dependências que elas possam ter.

   pod install
   

4. Abra o projeto no Xcode: feche o Xcode e abra (clique duas vezes) o 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 seu projeto e definir 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 conhece o iOS, crie um novo projeto e selecione o modelo de app iOS.

4. Se o grupo do 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 seu 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, Libraries, and Embedded Content. Se solicitado, selecione Copiar itens.

7. Arraste o GoogleRidesharingConsumer.bundle salvo para o diretório de nível superior do seu 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, se 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, mude o filtro na barra Build Settings de Basic para All.