تثبيت 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")
]

العثور على معرّف مشروعك

افتح الإعدادات → تسجيل الدخول في لوحة تحكم UserJot، وانسخ معرّف المشروع من قسم الأسرار.

تهيئة 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.

الخطوات التالية

هل أجاب هذا عن سؤالك؟