شروع کار با دیدبان در iOS

نیازمندی‌ها، اضافه کردن پکیج Swift Package Manager و آماده‌سازی پروژه iOS.

یادداشت

توزیع رسمی پکیج: کتابخانه iOS دیدبان به‌صورت باینری از پیش کامپایل‌شده (XCFramework) با پشتیبانی کامل از دستگاه‌های واقعی و شبیه‌سازها و بدون هیچ وابستگی جانبی از طریق Swift Package Manager توزیع می‌شود.

پیش‌نیازها

  • Xcode: Xcode 15.0 or newer
  • Swift tools version: Swift 6.0
  • Deployment Target: iOS 15.0+
  • Architectures: arm64 (iOS devices & Apple Silicon simulators) and x86_64 (Intel simulators)

اضافه کردن پکیج در Xcode

برای اضافه کردن دیدبان به پروژه استاندارد Xcode:

  1. در منوی بالای Xcode گزینه File → Add Package Dependencies... را انتخاب کنید.
  2. آدرس مخزن پکیج دیدبان را در کادر جستجو وارد کنید:
    https://gitlab.com/didbanco/didban.git
  3. قاعده نسخه (Dependency Rule) را روی Up to Next Major Version با مقدار 1.1.0 تنظیم کنید.
  4. پکیج Didban را به هدف اصلی اپلیکیشن خود متصل کرده و دکمه Add Package را بزنید.

پروژه‌های مبتنی بر Package.swift

اگر پروژه‌تان با Package.swift مدیریت می‌شود، می‌توانید دیدبان را به بخش dependencies اضافه کنید:

Package.swiftswift
// swift-tools-version: 6.0
import PackageDescription

let package = Package(
    name: "MyApp",
    platforms: [.iOS(.v15)],
    dependencies: [
        .package(url: "https://gitlab.com/didbanco/didban.git", from: "1.1.0"),
    ],
    targets: [
        .target(
            name: "MyApp",
            dependencies: [
                .product(name: "Didban", package: "didban")
            ]
        ),
    ]
)

گام بعدی

پس از اتصال پکیج، نحوه مقداردهی اولیه دیدبان در چرخه حیات SwiftUI یا UIKit را بررسی کنید.