Installatie van de Swift SDK

Shayan TaslimBijgewerkt:

Installeer de Swift SDK met Swift Package Manager en initialiseer deze tijdens het starten van de app met je UserJot-project-ID.

Vereisten

  • iOS 15.0+ of macOS 12.0+

  • Swift 6.1+

  • Xcode 16.3+

Installeren met Swift Package Manager

In Xcode

  1. Open je project in Xcode.

  2. Ga naar File → Add Package Dependencies.

  3. Voer deze pakket-URL in:

text
https://github.com/UserJot/userjot-ios
  1. Voeg het pakket UserJot toe aan je app-target.

In Package.swift

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

Je project-ID vinden

Open Instellingen → Inloggen in je UserJot-dashboard en kopieer Project-ID uit de sectie Geheimen.

De SDK initialiseren

Roep UserJot.setup(projectId:) één keer aan bij het starten van de app:

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

De integratie controleren

setup keert direct terug en laadt het adres van je board op de achtergrond. Elke aanroep van show wacht daarop voordat deze iets weergeeft, en probeert het opnieuw als het apparaat bij het starten offline was.

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

De URL-helpers (feedbackURL(board:), roadmapURL(), updatesURL()) zijn om dezelfde reden async en geven nil terug als het adres niet kon worden geladen.

macOS-recht

Schakel voor macOS-apps in een sandbox uitgaand netwerkverkeer in bij de entitlements van je app:

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

Migreren vanaf 0.3

  • showChangelog() heet nu showUpdates(), en changelogURL() heet nu updatesURL() (de oude namen geven een waarschuwing over veroudering en worden verwijderd in versie 1.0).

  • feedbackURL(board:), roadmapURL() en updatesURL() heten nu async.

  • UserJot is geïsoleerd op de main actor; roep deze vanuit achtergrondtaken aan met await.

  • De minimale platformversies zijn iOS 15 en macOS 12.

Volgende stappen

Heeft dit je vraag beantwoord?