Встановлення Swift SDK

Shayan TaslimОновлено

Установіть Swift SDK за допомогою Swift Package Manager, а потім ініціалізуйте його за допомогою ідентифікатора проєкту UserJot під час запуску програми.

Вимоги

  • iOS 15.0+ або macOS 12.0+

  • Swift 6.1+

  • Xcode 16.3+

Установлення за допомогою Swift Package Manager

У Xcode

  1. Відкрийте проєкт у Xcode.

  2. Перейдіть до File → Add Package Dependencies.

  3. Введіть URL-адресу пакета:

text
https://github.com/UserJot/userjot-ios
  1. Додайте пакет UserJot до цілі програми.

У Package.swift

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

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

Перевірка інтеграції

setup повертає результат негайно та завантажує адресу вашої дошки у фоновому режимі. Будь-який виклик show чекає на завершення цього завантаження, перш ніж відобразити вміст, і повторює спробу, якщо під час запуску пристрій не мав доступу до мережі.

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

З тієї самої причини допоміжні функції URL (feedbackURL(board:), roadmapURL(), updatesURL()) тепер мають тип async і повертають nil, якщо адресу не вдалося завантажити.

Ентайтлмент macOS

Для ізольованих програм macOS увімкніть вихідний мережевий доступ в ентайтлментах програми:

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

Чи відповіла ця стаття на ваше запитання?