Instalación del SDK de Swift

Shayan TaslimActualizado

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

  1. Abre tu proyecto en Xcode.

  2. Ve a Archivo → Añadir dependencias de paquetes.

  3. Introduce esta URL del paquete:

text
https://github.com/UserJot/userjot-ios
  1. Añade el paquete UserJot al destino de tu app.

En Package.swift

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

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

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

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

Migración desde la versión 0.3

  • showChangelog() ahora es showUpdates(), y changelogURL() ahora es updatesURL() (los nombres anteriores generan una advertencia de obsolescencia y se eliminarán en la versión 1.0).

  • feedbackURL(board:), roadmapURL() y updatesURL() ahora son async.

  • UserJot está aislado en el actor principal; llámalo desde tareas en segundo plano con await.

  • Las plataformas mínimas admitidas son iOS 15 y macOS 12.

Pasos siguientes

¿Respondió esto a tu pregunta?