Installazione dello Swift SDK

Shayan TaslimAggiornato

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

  1. Apri il progetto in Xcode.

  2. Vai a File → Aggiungi dipendenze del pacchetto.

  3. Inserisci l’URL del pacchetto:

text
https://github.com/UserJot/userjot-ios
  1. Aggiungi il pacchetto UserJot al target della tua app.

In Package.swift

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

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

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.

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

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

Migrazione dalla versione 0.3

  • showChangelog() ora è showUpdates(), e changelogURL() ora è updatesURL() (i nomi precedenti generano un avviso di deprecazione e verranno rimossi nella versione 1.0).

  • feedbackURL(board:), roadmapURL() e updatesURL() ora sono async.

  • UserJot è isolato nell'attore principale; per chiamarlo da attività in background, usa await.

  • Le piattaforme minime supportate sono iOS 15 e macOS 12.

Prossimi passaggi

Ha risposto alla tua domanda?