Installation du SDK Swift
Installez le SDK Swift avec Swift Package Manager, puis initialisez-le avec l’ID de votre projet UserJot au démarrage de l’application.
Prérequis
iOS 15.0+ ou macOS 12.0+
Swift 6.1+
Xcode 16.3+
Installation avec Swift Package Manager
Dans Xcode
Ouvrez votre projet dans Xcode.
Accédez à Fichier → Ajouter des dépendances de package.
Saisissez l’URL de ce package :
https://github.com/UserJot/userjot-iosAjoutez le package
UserJotà la cible de votre application.
Dans Package.swift
dependencies: [
.package(url: "https://github.com/UserJot/userjot-ios", from: "0.4.0")
]Trouver l’ID de votre projet
Dans votre tableau de bord UserJot, ouvrez Paramètres → Connexion et copiez l’ID du projet dans la section Secrets.
Initialiser le SDK
Appelez UserJot.setup(projectId:) une fois au lancement de l’application :
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
}
}Vérifier l’intégration
setup renvoie immédiatement et charge l’adresse de votre tableau en arrière-plan. Tout appel à show attend le chargement avant de présenter le tableau et réessaie si l’appareil était hors ligne au démarrage.
Button("Send Feedback") {
UserJot.showFeedback()
}Les utilitaires d’URL (feedbackURL(board:), roadmapURL(), updatesURL()) sont async pour la même raison et renvoient nil si l’adresse n’a pas pu être chargée.
Droit d’accès macOS
Pour les applications macOS en bac à sable, activez l’accès réseau sortant dans les droits de votre application :
<key>com.apple.security.network.client</key>
<true/>Migration depuis la version 0.3
showChangelog()devientshowUpdates(), etchangelogURL()devientupdatesURL()(les anciens noms émettent un avertissement de dépréciation et seront supprimés dans la version 1.0).feedbackURL(board:),roadmapURL()etupdatesURL()deviennentasync.UserJotest isolé sur l’acteur principal ; appelez-le depuis des tâches en arrière-plan avecawait.Les versions minimales prises en charge sont iOS 15 et macOS 12.
Étapes suivantes
Identifiez les utilisateurs connectés dans Authentification.
Présentez les commentaires, la feuille de route et les nouveautés dans Parcours courants.