البدء

توضّح هذه الصفحة كيفية إعداد حزمة تطوير البرامج (SDK) لنظام التشغيل iOS. إذا لم تكن قد أكملت المتطلبات الأساسية، عليك إكمالها أولاً.

اعتمادية

Swift Package Manager

1. في Xcode، ثبِّت حزمة Google-SearchInApps-SDK Swift Package من خلال الانتقال إلى "ملف" (File) > "إضافة حِزم" (Add Packages).

2. في الطلب الذي يظهر، ابحث عن مستودع Google-SearchInApps-SDK على GitHub لحزمة Swift:

https://github.com/google/search-in-apps.git

1. اختَر إصدار حزمة Google-SearchInApps-SDK Swift Package الذي تريد استخدامه. بالنسبة إلى المشاريع الجديدة، ننصحك باستخدام الترقية إلى الإصدار الرئيسي التالي.

بعد الانتهاء، سيبدأ Xcode في حلّ التبعيات المرتبطة بحِزمك وتنزيلها في الخلفية. لمزيد من التفاصيل حول كيفية إضافة تبعيات الحزمة، يُرجى الاطّلاع على مقالة Apple.

CocoaPods

استورِد حزمة تطوير البرامج Google-SearchInApps-SDK إلى مشروع iOS باستخدام CocoaPods. افتح ملف Podfile الخاص بمشروعك وأضِف هذا السطر إلى هدف تطبيقك:

pod 'Google-SearchInApps-SDK'

بعد ذلك، شغِّل الأمر التالي من سطر الأوامر:

pod install --repo-update

إذا كنت لا تعرف CocoaPods، يمكنك الاطّلاع على المستندات الرسمية للحصول على معلومات حول كيفية إنشاء ملفات Podfile واستخدامها.

تعديل ملف Info.plist

عدِّل ملف Info.plist في تطبيقك لإضافة مفتاحَين:

1. مفتاح GSAAPIKey يتضمّن قيمة سلسلة لمفتاح واجهة برمجة التطبيقات لحزمة SDK (راجِع ما ورد أعلاه)
2. مفتاح GSAClientIdentifier بقيمة سلسلة تمثّل معرّف العميل لتطبيقك (راجِع ما ورد أعلاه).

عيّنة Info.plist

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
        <key>GSAAPIKey</key>
        <string>ABC123...xyz890</string>
        <key>GSAClientIdentifier</key>
        <string>ms-demo-app-sia</string>
        ...
</dict>
</plist>

Init

إنشاء مثيل من ContextualSearchRuntime

Swift

ContextualSearchRuntime

let contextualSearchRuntime = ContextualSearchRuntime()

Objective-C

ContextualSearchRuntime

ContextualSearchRuntime *searchRuntime = [[ContextualSearchRuntime alloc] init];

التالي: ميزات البحث