Installazione dello Swift SDK
Installa lo Swift SDK con Swift Package Manager, quindi inizializzalo con il tuo Project ID di UserJot all'avvio dell'app.
Requisiti
iOS 15.0+ o macOS 12.0+
Swift 6.1+
Xcode 16.3+
Installa con Swift Package Manager
In Xcode
Apri il progetto in Xcode.
Vai a File → Aggiungi dipendenze del pacchetto.
Inserisci l’URL del pacchetto:
https://github.com/UserJot/userjot-iosAggiungi il pacchetto
UserJotal target della tua app.
In Package.swift
dependencies: [
.package(url: "https://github.com/UserJot/userjot-ios", from: "0.4.0")
]Trova il tuo Project ID
Apri Impostazioni → Accesso nella dashboard di UserJot e copia il Project ID dalla sezione Segreti.
Inizializza l’SDK
Chiama UserJot.setup(projectId:) una volta all'avvio dell'app:
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
}
}Verifica l’integrazione
setup restituisce immediatamente il controllo e carica l'indirizzo della tua bacheca in background. Qualsiasi chiamata a show attende il caricamento prima di essere mostrata e riprova se il dispositivo non era connesso al momento dell'avvio.
Button("Send Feedback") {
UserJot.showFeedback()
}Gli helper URL (feedbackURL(board:), roadmapURL(), updatesURL()) sono async per lo stesso motivo e restituiscono nil se non è stato possibile caricare l'indirizzo.
Entitlement di macOS
Per le app macOS in sandbox, abilita l'accesso alla rete in uscita negli entitlement della tua app:
<key>com.apple.security.network.client</key>
<true/>Migrazione dalla versione 0.3
showChangelog()ora èshowUpdates(), echangelogURL()ora èupdatesURL()(i nomi precedenti generano un avviso di deprecazione e verranno rimossi nella versione 1.0).feedbackURL(board:),roadmapURL()eupdatesURL()ora sonoasync.UserJotè isolato nell'attore principale; per chiamarlo da attività in background, usaawait.Le piattaforme minime supportate sono iOS 15 e macOS 12.
Prossimi passaggi
Identifica gli utenti che hanno effettuato l'accesso in Autenticazione.
Mostra feedback, roadmap e aggiornamenti in Flussi comuni.