CocoaPods

Este guia passo a passo irá ajudá-lo a integrar o TapOnPhoneSDK em seu projeto iOS utilizando o CocoaPods.


Pré-requisitos


Passo 1: Escolher a versão do SDK

  1. Acesse a página de versões.
  2. Veja qual é a versão mais atualizada
  3. Utilizamos o seguinte padrão de nome de branch para versionar o SDK:
    release-zoop-sdk-taponphone-ios-{versão}
    Por exemplo: release-zoop-sdk-taponphone-ios-1.3.0.
Dica

Sempre use a versão mais recente para garantir que você tenha as últimas correções e melhorias.


Passo 2: Configurar o arquivo Podfile

  1. No diretório raiz do seu projeto, abra (ou crie) um arquivo chamado Podfile.
  2. Adicione a seguinte configuração para incluir o SDK via CocoaPods, especificando o repositório Git e a branch escolhida:
platform :ios, '11.0'

target 'SeuProjeto' do
  use_frameworks!

  # Adicionando o TapOnPhoneSDK via CocoaPods
  pod 'TapOnPhone-iOS', :git => 'https://github.com/getzoop/zoop-package-public.git', :branch => 'release-zoop-sdk-taponphone-ios-1.3.0'
end

Nota: Substitua 'SeuProjeto' pelo nome do seu target no Xcode.


Aviso

Não se esqueça de substituir a branch release-zoop-sdk-taponphone-ios-1.3.0 pela versão mais recente do SDK que você escolheu no Passo 1. Voce pode acessar a página de releases para verificar a versão mais atualizada.

Passo 3: Instalar as dependências

  1. No terminal, navegue até o diretório do seu projeto.
  2. Execute o comando:
pod install
  1. Aguarde a instalação das dependências. O CocoaPods irá clonar o repositório especificado e integrar o SDK ao seu projeto.

Dica: Caso encontre erros, certifique-se de que o CocoaPods está atualizado executando:

sudo gem install cocoapods

Passo 4: Abrir o projeto com o arquivo .xcworkspace

Depois que a instalação for concluída, abra o arquivo .xcworkspace gerado pelo CocoaPods para trabalhar com o SDK:

open SeuProjeto.xcworkspace

Passo 5: Validar a integração

  1. Importe o SDK em qualquer arquivo Swift do seu projeto:
import TapOnPhoneSDK
  1. Teste a inicialização do SDK para garantir que ele foi integrado corretamente:
import UIKit
import TapOnPhoneSDK

class ViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        TapOnPhone.setConfig(...)
    }
}