Установка 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.

Эта статья ответила на ваш вопрос?