Installation des Swift SDKs

Shayan TaslimAktualisiert

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

  1. Öffne dein Projekt in Xcode.

  2. Gehe zu File → Add Package Dependencies.

  3. Gib diese Paket-URL ein:

text
https://github.com/UserJot/userjot-ios
  1. Füge das Paket UserJot zu deinem App-Target hinzu.

In Package.swift

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

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

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.

Swift
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:

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

Migration von 0.3

  • showChangelog() heißt jetzt showUpdates(), und changelogURL() heißt jetzt updatesURL() (für die alten Namen wird eine Deprecation-Warnung ausgegeben; sie werden in Version 1.0 entfernt).

  • feedbackURL(board:), roadmapURL() und updatesURL() heißen jetzt async.

  • UserJot ist auf den Main Actor beschränkt. Rufe es in Hintergrundaufgaben mit await auf.

  • Mindestversionen: iOS 15 und macOS 12.

Nächste Schritte

Hat das Ihre Frage beantwortet?