Встановлення 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.