Swift Package

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

Pré-requisitos

Passo 1: Abrir o projeto no Xcode

Abra o projeto no qual deseja adicionar o TapOnPhoneSDK utilizando o Xcode.

Passo 2: Navegar para Package Dependencies

  1. No navegador de projeto, clique no nome do seu projeto.
  2. Na barra superior, selecione a aba Package Dependencies.

Passo 3: Adicionar uma conta GitHub ao Xcode

  1. Clique no botão + para adicionar uma nova conta.
  2. Na janela seguinte, selecione Add Account Source Control e escolha GitHub.

Adicionar conta GitHub Adicionar conta GitHub

Passo 4: Autenticar com GitHub

  1. Insira seu nome de usuário do GitHub.
  2. Cole o Personal Access Token (PAT).
Informação

O GitHub personal access token (PAT) usado deve possuir no mínimo permissão para ler e obter pacotes/artefatos de repositórios públicos.

Dica

Caso você tenha dúvidas a respeito da GitHub PAT, acesse a página de nosso repositório público. Já no README, apresentamos um guia para orientá-lo sobre como gerar uma GitHub PAT e quais permissões conceder a ela.

Passo 5: Adicionar o repositório e selecionar a versão do SDK

  1. Copie a URL do repositório: https://github.com/getzoop/zoop-package-public.
  2. Cole a URL copiada no campo de pesquisa e clique em Adicionar Pacote.
  3. Ao adicionar o pacote, será solicitado que você escolha uma versão.
  4. Recomendamos usar a versão mais recente estável. Para este exemplo, usaremos a versão 1.1.1.
  5. Mude a Dependency Rule para branch.
  6. Adicione a branch release-zoop-sdk-taponphone-ios-1.1.1 para garantir que você está utilizando a versão correta do SDK.

Nota: O padrão para branchs do TapOnPhone é: release-zoop-sdk-taponphone-ios-{versão}, por exemplo, release-zoop-sdk-taponphone-ios-1.1.1.

Adicionar repositório do SDK Adicionar repositório do SDK

Passo 6: Confirmar a adição do pacote

Depois de configurar a dependência, o SDK será adicionado ao seu projeto. Verifique se o pacote aparece na lista de dependências do Xcode, no painel à direita.

Adicionar repositório do SDK Adicionar repositório do SDK

Passo 7: Validar a integração

  1. Certifique-se de que o pacote está listado em Package Dependencies.
  2. Faça um teste simples importando o SDK em um arquivo Swift e verificando se ele compila corretamente:
import TapOnPhoneSDK

// Exemplo básico de uso
TapOnPhone.setConfig(...)