Installation du SDK Swift

Shayan TaslimMis à jour

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

  1. Ouvrez votre projet dans Xcode.

  2. Accédez à Fichier → Ajouter des dépendances de package.

  3. Saisissez l’URL de ce package :

text
https://github.com/UserJot/userjot-ios
  1. Ajoutez le package UserJot à la cible de votre application.

Dans Package.swift

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

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

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.

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

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

Migration depuis la version 0.3

  • showChangelog() devient showUpdates(), et changelogURL() devient updatesURL() (les anciens noms émettent un avertissement de dépréciation et seront supprimés dans la version 1.0).

  • feedbackURL(board:), roadmapURL() et updatesURL() deviennent async.

  • UserJot est isolé sur l’acteur principal ; appelez-le depuis des tâches en arrière-plan avec await.

  • Les versions minimales prises en charge sont iOS 15 et macOS 12.

Étapes suivantes

Cet article a-t-il répondu à votre question ?