تثبيت أداة Oracle Mobile Hub وتكوينها لتوزيع واجهات API المخصصة

يمكنك تنزيل الأدوات الإضافية وتكوينها لتوزيع واجهات Api المخصصة في Oracle Mobile Hub.

تثبيت أداة Node.js

عند تنزيل SDK من Oracle Technology Network (OTN)، يتوفر لديك خيار تنزيل ملف omce-tools-vXX.X.X، والذي يشتمل على اسكربت Node.js يمكنك استخدامه لتوزيع التطبيقات إلى Oracle Mobile Hub

لتثبيت أدوات Node.js في المشروع:

1. نزّل الملف المضغوط omce-tools-vXX.X.X المضغوط وإلغاء ضغط الملف المضغوط إلى دليل
2. على جهازك ، افتح نافذة طرفية (قد يكون ذلك ضروريًا لتشغيل هذا الأمر كمستخدم مسئول )، ثم يتغير إلى دليل omce-tools/node-configurations.
3. حدد إعداد نقطة التوصيل الذي تريد استخدامه لواجهة API المخصصة التي تقوم باختبارها. استخدم 6.10 لإصدار نقطة التوصيل 6.10.0 أو متوافقًا، واستخدم 8.9 لإصدار نقطة التوصيل 8.9.4 أو متوافقًا. تكوين نقطة التوصيل الافتراضية لمركز Oracle Mobile Hub هو 8.9.
4. تغيير الدليل لتكوين نقطة التوصيل التي تريد استخدامها: إما `6.10` أو `8.9`
5. قم بتشغيل الأمر التالي:

   npm install

6. قم بالتغيير إلى دليل omce-tools.
7. قم بتشغيل الأمر:

   npm install -g

   يجعل هذا الأمر الأداة متاحة بشكل عام في البيئة المحلية. يجب أن يكون لديك Node.js وأن يكون مدير الحزمة npm مثبتًا قبل تشغيل هذا الأمر

8. قم بتعيين متغير البيئة NODE_PATH إلى الدليل node_modules لتكوين نقطة التوصيل التي ترغب في استخدامها أو إلى path/omce-tools/node-configurations/8.9/node_modules.
9. لاختبار ما إذا كان التثبيت ناجحًا أم لا ، قم بتشغيل الأمر:

   omce-test --version

تنزيل JavaScript Scaffold لواجهة API المخصصة

بعد تكوين واجهة API المخصصة الخاصة بك ، يمكنك تنزيل نسخة تجريبية مستندة إلى مستند RAML الخاص بـ API ، ثم استخدام scaffold كبداية سريعة لتنفيذ واجهة API المخصصة.

يأتي scaffold في شكل وحدة نمطية لنقطة توصيل ، والمكونات الرئيسية التي تشتمل على ملف JavaScript رئيسي يحتوي على أساليب برنامج فرعي لكل نقطة انتهاء (مورد بالإضافة إلى أسلوب HTTP )، وملف .json الحزمة ، الذي يعمل كتحويل للوحدة النمطية.

لتنزيل scaffold:

1. Click to open the side menu, click Development , and then click APIs.
2. افتح واجهة API التي تريد تنزيلها.
3. في منطقة التنقل اليسرى في مصمم API ، انقر تنفيذ .
4. انقر على JavaScript Scaffold لإنزال الملف المضغوط.
5. على النظام ، قم بفك ضغط الملف الذي تم تنزيله.

إذا قمت بعد ذلك بتغيير واجهة API ، فيمكنك إنزال نسخة احتياطية جديدة بناءً على نقاط النهاية التي تم تحديثها. ومع ذلك ، فإن أية تعليمات برمجية ربما قمت بها ولم يتم تحميلها من قبل لن تظهر في scaffold الجديد.

قم بتكوين toolsConfig.jsعلى الملف

بعد أن تقوم بتنزيل ملف scaffold يستند إلى مستند RAML الخاص بـ API ، يمكنك تكوين ملف JavaScript Notation (JSON) يدويًا باسم toolsConfig.json.

يستخدم Oracle Mobile Hub ملف toolsConfig.json يشتمل على معلومات التوزيع لواجهة API مخصصة. يتم إنشاء toolsConfig.json افتراضي عند تكوين API مخصص، وعند تنزيل scaffold. لتكوين ملف toolsConfig.json:

1. فتح صفحة "إعدادات الخلفية المتحركة" في Oracle Mobile Hub
2. لاحظ المعلومات الموجودة في صفحة الإعدادات .
   تشتمل صفحة "الإعدادات " على معلومات مثل أنواع التصديق (HTTP Basic و OAuth Consumer) وعناوين URL الخاصة بالبيئة.
3. باستخدام محرر نصوص، قم بتحديث ملف toolsConfig.json بالقيم من صفحة الإعدادات في Oracle Mobile Hub.

       "backend":{
           "backendId":"<YOUR_BACKEND_ID>",
           "backendName":"<YOUR_BACKEND_NAME>",
           "backendVersion":"<YOUR_BACKEND_VERSION>",
           "authorization":{
               "anonymousKey":"<BACKEND_ANONYMOUS_KEY>",
               "clientId":"<BACKEND_CLIENT_ID>",
               "clientSecret":"<BACKEND_CLIENT_SECRET>"
           }
       },

4. فتح صفحة التطوير .
5. انقر تفاصيل الطبعة.
6. لاحظ القيم السرية لعميل تطبيق عضو الفريق ومعرف عميل تطبيق عضو الفريق .
7. قم بتحديث ملف toolsConfig.json الخاص بك بهذه القيم.

       "tools":{
           ...,
           "authorization":{
               "clientId":"<TEAM_MEMBER_APP_CLIENT_ID>",
               "clientSecret":"<TEAM_MEMBER_APP_CLIENT_SECRET>"
           }
       },

8. (اختياري) لاختبار صحة toolsConfig.json يمكنك إجراء اختبار التوزيع البرمجي. فتح نافذة طرفية ، انتقل إلى دليل omce-tools وقم بتوزيع API المخصص باستخدام الأمر:

   node omce-deploy toolsConfig.json

   بعد تشغيل هذا الأمر، تتم مطالبتك ببيانات صلاحية Oracle Mobile Hub. إذا كان ملف toolsConfig.json صحيحًا، فستظهر رسالة تفيد بأن Deployment completed successfully متاحة. يمكنك استخدام هذا الأمر لتوزيع واجهة API المخصصة في المستقبل.