تكوين Oracle Mobile Hub SDK باستخدام تطبيق الأجهزة المتنقلة

يجب تكوين Oracle Mobile Hub SDK مع تطبيق الأجهزة المتنقلة قبل كتابة أي رمز.

إضافة SDK

في إعداد تطبيق أساسي ، دون تداخل الأطوار ، ستتم إضافة عميل iOS SDK إلى تطبيق.

1. فك ضغط ملف التنزيل ، omce-ios-sdk-{n}.zip (حيث يكون {n} هو رقم إصدار SDK) في دليل ما على جهازك.

2. من المحتويات المستخرجة للمنطقة ، قم بسحب دليل oracle_mobile_ios_sdk وإسقاطه في مستكشف مشروع Xcode.

   • حدد نسخ الأصناف إذا لزم الأمر.

   • حدد تكوين مجموعات .

   • انقر على إنهاء.

   بمجرد نسخ ملف .a لمكتبة محددة في شبكة تطوير التطبيق بلغة xcode ، تتوفر واجهة API لمنصة التشغيل المناسبة للتطبيق الخاص بك من خلال استدعاءات SDK. في هذه النقطة ، تتوفر جميع مكتبات SDK الثابتة للتطبيق الخاص بك.

3. حدد هدف المشروع الخاص بك ، وحدد علامة تبويب إنشاء المراحل ، وقم بتوسيع الارتباط الثنائي مع المكتبات ، وانقر على الزر + ، وأضف المكتبات التالية:

   • CoreData.framework

   • CoreLocation.framework

   • libsqlite3.0.tbd

   • Security.framework

   • SystemConfiguration.framework

4. في قسم "إعدادات الإصدار " للمشروع ، انقر نقرًا مزدوجًا على "علامات الرابط الأخرى " (ضمن الارتباط ) وأضف -ObjC.

5. أيضًا في إعدادات الإصدار ، وسّع مسارات البحث و:

   1. إضافة oracle_mobile_ios_sdk/release-iphoneos إلى مسارات البحث في المكتبة.

   2. إضافة oracle_mobile_ios_sdk/release-iphoneos/include إلى مسارات بحث رأس المستخدم.

6. قم بتوسيع المجلد Documentation الخاص بالملف المضغوط غير المعبأ ، وانسخ الملف OMC.plist، ووضعه في جذر حزمة التطبيق الرئيسية.

7. قم بتحرير ملف OMC.plist بعد النسخ.

8. بدءًا بـ Xcode 7، يجب حساب نظام تأمين نقل التطبيق (ATS)، والذي يفرض الاتصالات البعيدة على HTTPS.

   لأغراض التطوير فقط ، أضف المفتاح التالي في ملف Info.plist الخاص بالتطبيق لإيقاف تشغيل نظام ATS للتطبيق.

   <key>NSAppTransportSecurity</key> 
   <dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/> 
   </dict>

   ملاحظة:

   يجب عدم استخدام هذا الإعداد في الإنتاج. للتأكد من توفير أمان مثالي لتطبيقك ، قم بدراسة وثائق Apple واتبع توصيات Apple لتعطيل ATS لنطاقات معينة وتطبيق إمكانيات تأمين مناسبة لهذه النطاقات.

تكوين خصائص SDK

لاستخدام SDK للعميل في تطبيق iOS، تلزم إضافة ملف تكوين OMC.plist إلى التطبيق وملئه ببيانات البيئة للتمكن من استخدام الخلفية في Oracle Mobile Hub، وكذلك معلومات التكوين الأخرى. بدورها، تستخدم كلاسات SDK هذه المعلومات للمساعدة في إدارة الاعتماد والتسجيل وتتبع الأحداث ومزامنة البيانات والميزات الأخرى.

أنت تحوضع ملف التكوين في جذر الحزمة الرئيسية للتطبيق.

يتم تقسيم الملف بشكل أساسي إلى الأجزاء التالية:

• المفتاح mobileBackend والمحتويات الخاصة به.

  ويمكنك تضمين هذا الجزء إذا كنت تستخدم أسلاف مع التطبيق. تستخدم كلاسات SDK بيانات البيئة والمصادقة التي تحددها الوصول إلى الخلفية وإنشاء رؤوس HTTP لعمليات استدعاء REST التي تم إجراؤها على واجهات api.

• المفاتيح التي يتم تطبيقها على التكوين ككل ، مثل logLevel و oAuthTokenEndpoint. ويجب ألا تظهر هذه المفاتيح بصفة عامة ، في أعلى الملف.

إليك نفس الملف في نموذج النص:

<?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>logLevel</key>
  <string>debug</string>
  <key>logHTTP</key>
  <true/>
  <key>oAuthTokenEndPoint</key>
  <string>https://MY_TOKEN_ENDPOINT</string>
  <key>mobileBackend</key>
  <dict>
    <key>name</key>
    <string>EasyShoppingMBE</string>
    <key>baseURL</key>
    <string>https://MY_CLOUD_DOMAIN.oracle.com</string>
    <key>authentication</key>
    <dict>
      <key>type</key>
      <string>oauth</string>
      <key>oauth</key>
      <dict>
        <key>clientID</key>
        <string>11dac238ffaa4b029e78e982114642ab</string>
        <key>clientSecret</key>
        <string>5624cbdd-a7c5-4c10-a758-6019a5ab8da8</string>
        <key>enableOffline</key>
        <true/>
      </dict>
    </dict>
  </dict>
</dict>
</plist>

ويوجد وصف لبعض الإدخالات المهمة في ملف OMC.plist.

• oAuthTokenEndPoint — عنوان URL لخادم OAuth حيث يحصل التطبيق على مقطع التصديق الخاص به. يجب توفير هذا المفتاح لكل التطبيقات التي تعتمد على OAuth للتصديق عليها. يمكنك الوصول إلى ذلك من صفحة "إعدادات" في الخلفية. يجب أن تكون نقطة الانتهاء عنوان URL الأساسي فقط (بصيغة https://host.domain:port).

• logLevel — تحديد عدد مرات عرض تسجيل SDK في وحدة التحكم الطرفية للتطبيق. القيمة الافتراضية هي error. القيم الأخرى الممكنة (على مستوى الزيادة من البيانات) هي warning و info و debug. ويمكن أيضًا تعيين القيمة إلى none.

• logHTTP — عند التعيين إلى true، يقوم SDK بتسجيل رؤوس الرسائل وبدلات كافة طلبات واستجابات HTTP.

• mobileBackend — إدخال قاموس يشتمل على بيانات التصديق للنهاية الخلفية وغيرها من البيانات الاختيارية ، مثل خصائص المزامنة.

  يمكنك الحصول على بيانات التصديق ، مثل بيانات صلاحية OAuth وHTTP ، من صفحة الإعدادات في الخلفية.

• mobileBackend/baseUrl — عنوان URL الأساسي لجميع واجهات api التي تقوم باستدعائها خلال الخلفية. يمكنك الوصول إلى ذلك من صفحة "إعدادات" في الخلفية.

• mobileBackend/authentication — يحتوي على قاموس يشتمل على العناصر التالية:

  • المفتاح الفرعي type، المشتمل على قيم (string) الممكنة لـ oauth و basic و facebook و tokenExchange.

  • مفتاح فرعي واحد أو أكثر لأنواع التصديق ، يحتوي على قاموس يشتمل على بيانات صلاحية التصديق.

    ضمن المفاتيح الفرعية لـ basic و oauth، يمكنك أيضًا إضافة مفتاح enableOffline. بشكل افتراضي ، يتم تعيين هذه الخاصية إلى true.