Instalación del SDK de Swift
Instala el SDK de Swift con Swift Package Manager y, durante el inicio de la app, inicialízalo con el ID de tu proyecto de UserJot.
Requisitos
iOS 15.0 o posterior, o macOS 12.0 o posterior
Swift 6.1 o posterior
Xcode 16.3 o posterior
Instalación con Swift Package Manager
En Xcode
Abre tu proyecto en Xcode.
Ve a Archivo → Añadir dependencias de paquetes.
Introduce esta URL del paquete:
https://github.com/UserJot/userjot-iosAñade el paquete
UserJotal destino de tu app.
En Package.swift
dependencies: [
.package(url: "https://github.com/UserJot/userjot-ios", from: "0.4.0")
]Encuentra tu ID de proyecto
Abre Settings → Login en el panel de UserJot y copia el ID de proyecto de la sección Secrets.
Inicializa el SDK
Llama a UserJot.setup(projectId:) una vez al iniciar la app:
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
}
}Verifica la integración
setup retorna inmediatamente y carga la dirección de tu tablero en segundo plano. Cualquier llamada a show espera a que se cargue antes de mostrarlo y vuelve a intentarlo si el dispositivo estaba sin conexión al iniciarse.
Button("Send Feedback") {
UserJot.showFeedback()
}Los ayudantes de URL (feedbackURL(board:), roadmapURL(), updatesURL()) son async por el mismo motivo y devuelven nil si no se pudo cargar la dirección.
Permiso de macOS
En las apps de macOS aisladas en un entorno sandbox, habilita el acceso de red saliente en los permisos de tu app:
<key>com.apple.security.network.client</key>
<true/>Migración desde la versión 0.3
showChangelog()ahora esshowUpdates(), ychangelogURL()ahora esupdatesURL()(los nombres anteriores generan una advertencia de obsolescencia y se eliminarán en la versión 1.0).feedbackURL(board:),roadmapURL()yupdatesURL()ahora sonasync.UserJotestá aislado en el actor principal; llámalo desde tareas en segundo plano conawait.Las plataformas mínimas admitidas son iOS 15 y macOS 12.
Pasos siguientes
Identifica a los usuarios que hayan iniciado sesión en Autenticación.
Presenta comentarios, la hoja de ruta y novedades en Flujos habituales.