البدء

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

اعتمادية

أداة إدارة حِزم Swift

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

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

https://github.com/google/search-in-apps.git
  1. اختَر إصدار حزمة Google-SearchInApps-SDK Swift التي تريد استخدامها. بالنسبة إلى المشاريع الجديدة، ننصحك باستخدام الإصدار الرئيسي التالي.

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

CocoaPods

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

pod 'Google-SearchInApps-SDK'

ثم من تشغيل سطر الأوامر:

pod install --repo-update

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

تعديل ملف 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];

الخطوة التالية: ميزات البحث