تنزيل algoliasearch client swift - تنزيل رمز مصدر algoliasearch client swift

algoliasearch client swift

شفرة المصدر الأخرى

9.10.2

تنزيل

نقطة البداية المثالية لدمج Algolia في مشروع Swift الخاص بك

الوثائق • منتدى المجتمع • Stack Overflow • الإبلاغ عن خطأ • الأسئلة الشائعة • الدعم

سمات

عميل Swift نقي عبر الأنظمة الأساسية
الطلبات والردود المكتوبة
الاستخدام الواسع النطاق لنوع Result
يستخدم قوة البروتوكول Codable لسهولة دمج نماذج المجال الخاص بك
عملاء آمنين للخيط
تسجيل مفصل
عميل HTTP قابل للحقن

ابدء

مدير الحزم سويفت

يعد Swift Package Manager أداة لإدارة توزيع كود Swift. إنه متكامل مع نظام بناء Swift لأتمتة عملية تنزيل التبعيات وتجميعها وربطها. منذ إصدار Swift 5 وXcode 11، أصبح SPM متوافقًا مع أنظمة إنشاء iOS وmacOS وtvOS لإنشاء التطبيقات.

لاستخدام SwiftPM، يجب عليك استخدام Xcode 11 لفتح مشروعك. انقر فوق File -> Swift Packages -> Add Package Dependency ، وأدخل عنوان URL الخاص بمستودع العميل.

إذا كنت مؤلف إطار عمل وتستخدم Swift API Client باعتباره تابعًا، فقم بتحديث ملف Package.swift الخاص بك:

 let package = Package (
    // 9.0.0 ..< 10.0.0
    dependencies : [
        . package ( url : " https://github.com/algolia/algoliasearch-client-swift " , from : " 9.0.0 " )
    ] ,
    // ...
)

كوكوابودس

CocoaPods هو مدير التبعية لمشاريع الكاكاو.

لتثبيت Algolia Swift Client، ما عليك سوى إضافة السطر التالي إلى ملف Podfile الخاص بك:

 pod 'AlgoliaSearchClient' , '~> 9.0.0'
# pod 'InstantSearchClient', '~> 7.0' // Swift 5.9 NOT YET RELEASED

ثم قم بتشغيل الأمر التالي:

$ pod update

قرطاج

قرطاج هو مدير تبعية بسيط ولامركزي للكاكاو.

لتثبيت InstantSearch، ما عليك سوى إضافة السطر التالي إلى ملف Cartfile الخاص بك:

 github "algolia/algoliasearch-client-swift" ~> 9.0 . 0

قم بتشغيل الأوامر التالية من دليل المشروع (لإصدار v.8.0+)

carthage update
./Carthage/Checkouts/algoliasearch-client-swift/carthage-prebuild
carthage build

إذا كانت هذه هي المرة الأولى التي تستخدم فيها Carthage في المشروع، فستحتاج إلى اتباع بعض الخطوات الإضافية كما هو موضح في Carthage.

يمكنك الآن استيراد عميل Algolia API في مشروعك واللعب به.

قم باستيراد الحزمة الأساسية وحزمة العميل المطلوبة إلى ملفات التعليمات البرمجية المصدر الخاصة بك:

 #if canImport(Core)
    import Core
#endif
import Search

let client = try SearchClient ( appID : " YOUR_APP_ID " , apiKey : " YOUR_API_KEY " )

// Add a new record to your Algolia index
let response = try await client . saveObject (
    indexName : " <YOUR_INDEX_NAME> " ,
    body : [ " objectID " : " id " , " test " : " val " ]
)

// Poll the task status to know when it has been indexed
try await client . waitForTask ( with : response . taskID , in : " <YOUR_INDEX_NAME> " )

// Fetch search results, with typo tolerance
let response : SearchResponses < Hit > = try await client
    . search ( searchMethodParams : SearchMethodParams ( requests : [ SearchQuery . searchForHits ( SearchForHits (
        query : " <YOUR_QUERY> " ,
        hitsPerPage : 50 ,
        indexName : " <YOUR_INDEX_NAME> "
    ) ) ] ) )

للحصول على الوثائق الكاملة، قم بزيارة Algolia Swift API Client .

ملحوظات

دعم الهدف-C

عميل Swift API متوافق مع Objective-C حتى الإصدار 7.0.5. الرجاء استخدام هذا الإصدار من العميل إذا كنت تعمل مع مشروع Objective-C.

سويفت 3

يمكنك استخدام هذه المكتبة مع Swift بإحدى الطرق التالية:

pod 'AlgoliaSearch-Client-Swift', '~> 4.8.1'
pod 'AlgoliaSearch-Client-Swift', :git => 'https://github.com/algolia/algoliasearch-client-swift.git', :branch => 'swift-3'

سويفت 4

يمكنك استخدام المكتبة القديمة مع Swift بإحدى الطرق التالية:

pod 'AlgoliaSearch-Client-Swift', '~> 8.19'
pod 'AlgoliaSearch-Client-Swift', :git => 'https://github.com/algolia/algoliasearch-client-swift.git', :branch => 'swift-4'

❓ استكشاف الأخطاء وإصلاحها

تواجه مشكلة؟ قبل التواصل مع الدعم، نوصي بالتوجه إلى الأسئلة الشائعة حيث ستجد إجابات للمشكلات والمشاكل الأكثر شيوعًا مع العميل. يمكنك أيضًا فتح مشكلة GitHub

المساهمة

يستضيف هذا المستودع رمز عميل Algolia API الذي تم إنشاؤه لـ Swift، إذا كنت ترغب في المساهمة، فتوجه إلى المستودع الرئيسي. يمكنك أيضًا العثور على أدلة المساهمة على موقع التوثيق الخاص بنا.