Instalar o SDK do consumidor para iOS

Gerenciador de pacotes do Swift

O SDK Consumer 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 Xcode project ou workspace e acesse Arquivo > Adicionar dependências de pacote.
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 em 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".
4. Na janela Escolher produtos do pacote, 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ê vai encontrar 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 Arquivo > Pacotes > Atualizar para as versões mais recentes do pacote.
2. Para verificar a instalação, acesse a seção Dependências de pacote do Navegador de projetos e confira 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 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 de 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: 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 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. Execute o comando pod install: esse comando instala as APIs especificadas no Podfile, além de todas as dependências que elas possam ter.

   pod install
   

4. Abra seu projeto no Xcode: feche o Xcode e abra (clique duas vezes) o arquivo .xcworkspace do projeto para iniciar o Xcode. Para abrir o projeto depois, 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 configurar as opções de build no Xcode.

Antes de seguir este guia, faça o seguinte:

• Baixe o XCFramework, um pacote binário usado para instalar o SDK do consumidor. É possível usar esse pacote em várias plataformas, incluindo máquinas com 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 projeto e selecione o modelo de app iOS.

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

5. Arraste o arquivo gRPCCertificates.bundle baixado para o diretório de nível superior do seu projeto Xcode. Se for 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 for solicitado, selecione Copiar itens.

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

8. Selecione seu projeto no navegador de projetos 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 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 Configurações de build. Na seção Outras flags do vinculador, adicione -ObjC para depuração e lançamento.

    Se essas configurações não estiverem visíveis, mude o filtro na barra Configurações de build de Básico para Tudo.