Instalação do SDK Swift

Shayan TaslimAtualizado

Instale o SDK Swift com o Swift Package Manager e, em seguida, inicialize-o com o ID do projeto do UserJot durante o arranque da aplicação.

Requisitos

  • iOS 15.0+ ou macOS 12.0+

  • Swift 6.1+

  • Xcode 16.3+

Instalar com o Swift Package Manager

No Xcode

  1. Abra o seu projeto no Xcode.

  2. Aceda a Ficheiro → Adicionar dependências de pacotes.

  3. Introduza este URL do pacote:

text
https://github.com/UserJot/userjot-ios
  1. Adicione o pacote UserJot ao destino da sua aplicação.

Em Package.swift

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

Encontre o ID do seu projeto

Abra Definições → Início de sessão no dashboard do UserJot e copie o ID do projeto na secção Segredos.

Inicializar o SDK

Chame UserJot.setup(projectId:) uma vez quando a aplicação arrancar:

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
    }
}

Verificar a integração

setup devolve o resultado imediatamente e carrega o endereço do seu quadro em segundo plano. Qualquer chamada a show aguarda por ele antes de apresentar o quadro e tenta novamente se o dispositivo estiver offline no arranque.

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

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

Autorizações do macOS

Nas aplicações macOS em sandbox, ative o acesso de saída à rede nas autorizações da aplicação:

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

Migrar da versão 0.3

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

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

  • UserJot está isolado no ator principal; chame-o a partir de tarefas em segundo plano com await.

  • As versões mínimas das plataformas são iOS 15 e macOS 12.

Próximos passos

Isto respondeu à sua pergunta?