تثبيت 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")
]العثور على معرّف مشروعك
افتح الإعدادات → تسجيل الدخول في لوحة تحكم UserJot، وانسخ معرّف المشروع من قسم الأسرار.
تهيئة 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.
الخطوات التالية
حدّد المستخدمين الذين سجّلوا الدخول ضمن المصادقة.
اعرض التعليقات وخارطة الطريق والتحديثات ضمن التدفقات الشائعة.