Instalação do SDK Swift
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
Abra o seu projeto no Xcode.
Aceda a Ficheiro → Adicionar dependências de pacotes.
Introduza este URL do pacote:
https://github.com/UserJot/userjot-iosAdicione o pacote
UserJotao destino da sua aplicação.
Em Package.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
import SwiftUI
import UserJot
@main
struct MyApp: App {
init() {
UserJot.setup(projectId: "YOUR_PROJECT_ID")
}
var body: some Scene {
WindowGroup {
ContentView()
}
}
}UIKit
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.
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:
<key>com.apple.security.network.client</key>
<true/>Migrar da versão 0.3
showChangelog()é agorashowUpdates(), echangelogURL()é agoraupdatesURL()(os nomes antigos geram um aviso de obsolescência e serão removidos na versão 1.0).feedbackURL(board:),roadmapURL()eupdatesURL()são agoraasync.UserJotestá isolado no ator principal; chame-o a partir de tarefas em segundo plano comawait.As versões mínimas das plataformas são iOS 15 e macOS 12.
Próximos passos
Identifique os utilizadores com sessão iniciada em Autenticação.
Apresente feedback, o roteiro e atualizações em Fluxos comuns.