Installation des Swift SDKs
Installiere das Swift SDK mit Swift Package Manager und initialisiere es beim Start der App mit deiner UserJot Project ID.
Voraussetzungen
iOS 15.0+ oder macOS 12.0+
Swift 6.1+
Xcode 16.3+
Mit Swift Package Manager installieren
In Xcode
Öffne dein Projekt in Xcode.
Gehe zu File → Add Package Dependencies.
Gib diese Paket-URL ein:
https://github.com/UserJot/userjot-iosFüge das Paket
UserJotzu deinem App-Target hinzu.
In Package.swift
dependencies: [
.package(url: "https://github.com/UserJot/userjot-ios", from: "0.4.0")
]Deine Project ID finden
Öffne Einstellungen → Login in deinem UserJot-Dashboard und kopiere die Project ID aus dem Abschnitt Secrets.
SDK initialisieren
Rufe UserJot.setup(projectId:) einmal beim Start der App auf:
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
}
}Integration überprüfen
setup kehrt sofort zurück und lädt die Adresse deines Boards im Hintergrund. Jeder Aufruf von show wartet vor der Anzeige darauf und unternimmt einen neuen Versuch, wenn das Gerät beim Start offline war.
Button("Send Feedback") {
UserJot.showFeedback()
}Die URL-Helfer (feedbackURL(board:), roadmapURL(), updatesURL()) sind aus demselben Grund async und geben nil zurück, wenn die Adresse nicht geladen werden konnte.
macOS-Berechtigung
Aktiviere für sandboxed macOS-Apps den ausgehenden Netzwerkzugriff in den App-Berechtigungen:
<key>com.apple.security.network.client</key>
<true/>Migration von 0.3
showChangelog()heißt jetztshowUpdates(), undchangelogURL()heißt jetztupdatesURL()(für die alten Namen wird eine Deprecation-Warnung ausgegeben; sie werden in Version 1.0 entfernt).feedbackURL(board:),roadmapURL()undupdatesURL()heißen jetztasync.UserJotist auf den Main Actor beschränkt. Rufe es in Hintergrundaufgaben mitawaitauf.Mindestversionen: iOS 15 und macOS 12.
Nächste Schritte
Identifiziere angemeldete Nutzer unter Authentifizierung.
Präsentiere Feedback, Roadmap und Updates unter Häufige Abläufe.