Instalacja Swift SDK

Shayan TaslimZaktualizowano

Zainstaluj Swift SDK za pomocą Swift Package Manager, a następnie zainicjuj go przy użyciu identyfikatora projektu UserJot podczas uruchamiania aplikacji.

Wymagania

  • iOS 15.0+ lub macOS 12.0+

  • Swift 6.1+

  • Xcode 16.3+

Instalacja za pomocą Swift Package Manager

W Xcode

  1. Otwórz projekt w Xcode.

  2. Wybierz Plik → Dodaj zależności pakietu.

  3. Wprowadź adres URL pakietu:

text
https://github.com/UserJot/userjot-ios
  1. Dodaj pakiet UserJot do celu aplikacji.

W pliku Package.swift

Swift
dependencies: [
    .package(url: "https://github.com/UserJot/userjot-ios", from: "0.4.0")
]

Znajdź identyfikator projektu

Otwórz Ustawienia → Logowanie w panelu UserJot i skopiuj identyfikator projektu z sekcji Sekrety.

Zainicjuj SDK

Wywołaj UserJot.setup(projectId:) raz podczas uruchamiania aplikacji:

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

Sprawdź integrację

setup zwraca wynik natychmiast i w tle ładuje adres tablicy. Każde wywołanie show czeka na jego załadowanie przed wyświetleniem, a jeśli urządzenie było offline w chwili uruchomienia, ponawia próbę.

Swift
Button("Send Feedback") {
    UserJot.showFeedback()
}

Funkcje pomocnicze URL (feedbackURL(board:), roadmapURL(), updatesURL()) są async z tego samego powodu i zwracają nil, jeśli nie udało się załadować adresu.

Uprawnienia macOS

W aplikacjach macOS działających w piaskownicy włącz dostęp do sieci wychodzącej w uprawnieniach aplikacji:

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

Migracja z wersji 0.3

  • showChangelog() to teraz showUpdates(), a changelogURL() to teraz updatesURL() (użycie starych nazw powoduje wyświetlenie ostrzeżenia o ich wycofaniu; zostaną usunięte w wersji 1.0).

  • feedbackURL(board:), roadmapURL() i updatesURL() to teraz async.

  • UserJot jest przypisane wyłącznie do głównego aktora; wywołuj je z zadań działających w tle za pomocą await.

  • Minimalne wymagane wersje platform to iOS 15 i macOS 12.

Następne kroki

Czy ten artykuł odpowiedział na Twoje pytanie?