Установка Swift SDK
Установите Swift SDK с помощью Swift Package Manager, а затем инициализируйте его с помощью идентификатора проекта UserJot при запуске приложения.
Требования
iOS 15.0+ или macOS 12.0+
Swift 6.1+
Xcode 16.3+
Установка с помощью Swift Package Manager
В Xcode
Откройте проект в Xcode.
Выберите File → Add Package Dependencies.
Введите URL пакета:
https://github.com/UserJot/userjot-iosДобавьте пакет
UserJotв целевой объект приложения.
В Package.swift
dependencies: [
.package(url: "https://github.com/UserJot/userjot-ios", from: "0.4.0")
]Найдите идентификатор проекта
Откройте Settings → Login в панели управления UserJot и скопируйте Project ID из раздела Secrets.
Инициализация SDK
Вызовите UserJot.setup(projectId:) один раз при запуске приложения:
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
}
}Проверьте интеграцию
setup немедленно возвращает управление и загружает адрес вашей доски в фоновом режиме. Любой вызов show дожидается завершения загрузки перед отображением и повторяет попытку, если при запуске устройство было не в сети.
Button("Send Feedback") {
UserJot.showFeedback()
}Вспомогательные методы для URL (feedbackURL(board:), roadmapURL(), updatesURL()) также являются async по той же причине и возвращают nil, если не удалось загрузить адрес.
Разрешение macOS
Для приложений macOS в песочнице включите исходящий сетевой доступ в правах приложения:
<key>com.apple.security.network.client</key>
<true/>Переход с версии 0.3
Теперь
showChangelog()называетсяshowUpdates(), аchangelogURL()—updatesURL()(при использовании старых названий выводится предупреждение об устаревании; они будут удалены в версии 1.0).Теперь
feedbackURL(board:),roadmapURL()иupdatesURL()называютсяasync.UserJotтеперь изолирован главным актором; вызывайте его из фоновых задач с помощьюawait.Минимальные версии платформ: iOS 15 и macOS 12.
Следующие шаги
Идентифицируйте вошедших пользователей в разделе Authentication.
Показывайте отзывы, дорожную карту и обновления в разделе Common flows.