Instalação do SDK Swift

Shayan TaslimAtualizado

Instale o SDK Swift com o Swift Package Manager e inicialize-o com o ID do projeto da UserJot durante a inicialização do app.

Requisitos

  • iOS 15.0+ ou macOS 12.0+

  • Swift 6.1+

  • Xcode 16.3+

Instalar com o Swift Package Manager

No Xcode

  1. Abra seu projeto no Xcode.

  2. Acesse Arquivo → Adicionar Dependências de Pacote.

  3. Insira este URL do pacote:

text
https://github.com/UserJot/userjot-ios
  1. Adicione o pacote UserJot ao target do app.

No Package.swift

Swift
dependencies: [
    .package(url: "https://github.com/UserJot/userjot-ios", from: "0.4.0")
]

Encontre seu ID do projeto

Abra Configurações → Login no painel da UserJot e copie o ID do projeto na seção Segredos.

Inicialize o SDK

Chame UserJot.setup(projectId:) uma vez na inicialização do app:

SwiftUI

Swift
import SwiftUI
import UserJot

@main
struct MyApp: App {
    init() {
        UserJot.setup(projectId: "YOUR_PROJECT_ID")
    }

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

UIKit

Swift
import UIKit
import UserJot

@main
class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil
    ) -> Bool {
        UserJot.setup(projectId: "YOUR_PROJECT_ID")
        return true
    }
}

Verifique a integração

setup retorna imediatamente e carrega o endereço do seu board em segundo plano. Qualquer chamada a show aguarda esse carregamento antes de apresentar o conteúdo e tenta novamente se o dispositivo estava offline na inicialização.

Swift
Button("Send Feedback") {
    UserJot.showFeedback()
}

Os auxiliares de URL (feedbackURL(board:), roadmapURL(), updatesURL()) são async pelo mesmo motivo e retornam nil se não for possível carregar o endereço.

Entitlements do macOS

Em apps do macOS em sandbox, habilite o acesso de saída à rede nos entitlements do app:

xml
<key>com.apple.security.network.client</key>
<true/>

Migração da versão 0.3

  • showChangelog() agora é showUpdates(), e changelogURL() agora é updatesURL() (os nomes antigos geram um aviso de descontinuação e serão removidos na versão 1.0).

  • feedbackURL(board:), roadmapURL() e updatesURL() agora são async.

  • UserJot agora é isolado no ator principal; use await em chamadas feitas em tarefas em segundo plano.

  • As plataformas mínimas são iOS 15 e macOS 12.

Próximas etapas

Isso respondeu à sua pergunta?