Instalar o SDK do consumidor para iOS

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.

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. 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 usar a opção "Versão exata". 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. No Xcode, vá para "File > Pacotes > Atualize para as versões mais recentes do pacote".
2. Para verificar a instalação, vá para a seção Package Dependencies do Project Navigator para verificar o pacote e sua versão.

Para remover o SDK do consumidor instalado manualmente, siga estas etapas:

1. Nas configurações de configuração do projeto do Xcode, encontre 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 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 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 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. 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 depois, 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:

• Baixe o XCFramework, um pacote binário usado para instalar a 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 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.