البدء

قبل استخدام مكتبة مورِّد Android المشتركة، يجب على الموردين الانضمام إلى منصة Samsung برنامج نشر Knox وإعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة لأجهزة Android

برنامج نشر Knox (KDP)

اتّبِع الخطوات أدناه للانضمام إلى KDP. واسترداد التفاصيل اللازمة لبدء استخدام مكتبة المورّدين.

الخطوة 1: الاشتراك في KDP

  1. الانتقال إلى Samsung Knox للمورّدين للاشتراك في KDP.
  2. أنشئ حسابًا على Samsung وسجِّل للحصول على حساب Samsung Knox كمورِّد.
  3. بعد الموافقة على حساب المورّد الخاص بك، سجِّل الدخول إلى بوابة KDP للعثور على resellerId.

الخطوة 2: طلب الوصول إلى بوابة Knox Cloud API

  1. أرسِل طلبًا إلى Samsung للحصول على إذن بالوصول إلى بوابة Knox Cloud API.
  2. سجِّل الدخول إلى بوابة Knox Cloud API.

الخطوة 3: الحصول على مفاتيح حساب الخدمة وclientIdentifier

  1. تنزيل ملف JSON لزوج المفاتيح من بوابة Knox Cloud API وتخزينه في مكان آمن.
  2. أنشئ clientIdentifier فريدًا من بوابة Knox Cloud API.

الخطوة 4: إنشاء عنصر SamsungResellerService

استخدِم مسار ملف JSON، clientIdentifier، resellerId لإنشاء الملف SamsungResellerService لاستخدام المكتبة المشتركة.

إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة

الخطوة 1: الانضمام إلى برنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة"

  1. ويمكنك الانضمام إليه باستخدام برنامج إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة.
  2. ونظرًا لأن المكتبة الشائعة لمورّدي Android تستخدم واجهة برمجة تطبيقات المورّد، عليك طلب الوصول إلى واجهة برمجة تطبيقات المورّد من "منصّة Google". مستشار الحلول.
  3. اطلب الوصول إلى بوابة برنامج "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة".

باستخدام حساب Google نفسه الذي تستخدمه للدخول إلى البوابة، اتبع التعليمات المتبقية لإنشاء حساب الخدمة وتفعيل واجهة برمجة تطبيقات المورّد.

الخطوة 2: إنشاء حساب خدمة

حساب الخدمة، ويُعرف أحيانًا باسم حساب الروبوت، هو حساب Google. تمثيل التطبيقات بدلاً من المستخدمين. نظرًا لاستدعاء مكتبة التسجيل Google APIs نيابةً عن حساب الخدمة، استخدِم وحدة تحكّم Google API لإعداد الوصول.

إنشاء مشروع في وحدة تحكم واجهة برمجة التطبيقات

من الممارسات الجيدة إنشاء مشروع وحساب خدمة جديدَين على API Console. يتيح لك ذلك إدارة الوصول وإدارة الموارد وإصلاح المفاتيح المفقودة. أسهل في المستقبل. ابدأ باتّباع الخطوات أدناه لإنشاء مشروع جديد. في وحدة التحكم في واجهة Google API:

  1. انتقِل إلى وحدة تحكّم واجهة برمجة التطبيقات.
  2. من قائمة المشاريع، اختَر أنشِئ مشروعًا.
  3. أدخِل اسمًا يصف تطبيقك و"إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة".
  4. حدِّد رقم تعريف مشروع أو اقبل الإعداد التلقائي.
  5. انقر على إنشاء.

لمعرفة المزيد، يُرجى الاطّلاع على مستند Google Cloud Platform إدارة المشاريع في وحدة التحكم.

إضافة بيانات اعتماد جديدة للخدمة

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

  1. افتح صفحة حسابات الخدمة. اختَر مشروعًا إذا طُلب منك ذلك.
  2. انقر على إنشاء حساب للخدمة ثم أدخِل اسمًا ووصفًا لحساب الخدمة. يمكنك استخدام معرّف حساب الخدمة التلقائي أو اختيار معرّف فريد مختلف. وعند الانتهاء من ذلك، انقر على إنشاء.
  3. قسم أذونات حساب الخدمة (اختيارية) التالي غير مطلوب. انقر على متابعة.
  4. انتقِل إلى القسم إنشاء مفتاح في أسفل شاشة منح المستخدمين صلاحية الوصول إلى حساب الخدمة هذا. انقر على إنشاء مفتاح.
  5. في اللوحة الجانبية التي تظهر، اختَر التنسيق الذي تريده للمفتاح: وننصح باختيار: JSON.
  6. انقر على إنشاء. يتم إنشاء زوج المفتاح العام/الخاص وتنزيله على جهازك، وهو النسخة الوحيدة من هذا المفتاح. للحصول على معلومات عن طريقة التخزين الآمن للمفتاح، يُرجى مراجعة إدارة مفاتيح حساب الخدمة.
  7. انقر على إغلاق في مربّع الحوار تم حفظ المفتاح الخاص على الكمبيوتر، ثم انقر على تم للرجوع إلى جدول حسابات الخدمة.

انسخ عنوان البريد الإلكتروني لحساب الخدمة واحتفظ به في متناولك. أنت بحاجة إليه لاحقًا عند ربط حساب الخدمة بمؤسستك.

الخطوة 3: تخزين ملف مفتاح JSON

تنشئ وحدة تحكم واجهة برمجة التطبيقات مفتاحَي تشفير خاصَين جديدَين يُستخدمان للمصادقة طلبات البيانات من واجهة برمجة التطبيقات التي تم إجراؤها باستخدام حساب الخدمة المفتاح الخاص موجود في مفتاح JSON تقوم بتنزيله.

يجب الاحتفاظ بخصوصية المفتاح، لذا لا تضمِّنه في مصدر برنامجك. الرمز. إذا فقدت ملف المفتاح، عليك إنشاء مفتاحَين جديدَين.

لمزيد من المعلومات حول تخزين ملف المفتاح بأمان، يمكنك الاطّلاع على أفضل الممارسات باستخدام مفاتيح واجهة برمجة التطبيقات بأمان

الخطوة 4: تفعيل واجهة برمجة التطبيقات

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

لتفعيل Reseller API، اتّبِع الخطوات التالية في وحدة تحكّم واجهة برمجة التطبيقات:

  1. انقر على واجهات برمجة التطبيقات الخدمات > المكتبة:
  2. استخدِم حقل البحث للعثور على واجهة برمجة التطبيقات للشركاء لتوفير المتطلبات اللازمة لأجهزة Android.
  3. انقر على واجهة برمجة تطبيقات الشريك لإدارة أجهزة Android.
  4. انقر على تفعيل.

وبعد فترة قصيرة، تتغير حالة واجهة برمجة التطبيقات إلى "مفعّلة". إذا كنت لا ترى واجهة برمجة التطبيقات للشركاء لتوفير المتطلبات اللازمة لأجهزة Android، تحقَّق من أنّ مؤسستك إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة. تأكد من استخدام نفس حساب Google حساب برنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة" ووحدة تحكم Google API. طرح أسئلة على Google مستشار حلول المنصات للتحقّق ممّا إذا كان حسابك على Google لديه إذن بالوصول إلى واجهة برمجة التطبيقات.

ربط حساب الخدمة ببرنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة" لمؤسستك يفوّض حساب الخدمة حساب الخدمة بإجراء طلبات بيانات من واجهة برمجة التطبيقات نيابةً عن التنظيم. اتّبِع الخطوات التالية لربط حساب الخدمة:

  1. افتح بوابة "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة". وقد تحتاج إلى تسجيل الدخول.
  2. انقر على رمز الخدمة. .
  3. انقر على ربط حساب الخدمة.
  4. اضبط عنوان البريد الإلكتروني على عنوان حساب الخدمة الذي أنشأته.
  5. انقر على ربط حساب الخدمة لاستخدام حساب الخدمة مع حساب التسجيل باستخدام ميزة "إعداد الجهاز تلقائيًا" .

إذا لم تتمكّن من العثور على عنوان البريد الإلكتروني لحساب الخدمة الذي أنشأته، انسخه. من أحد الأماكن التالية:

  • رقم تعريف حساب الخدمة من صفحة حسابات الخدمة في وحدة التحكم في واجهة Google API.
  • حقل السمة client_email في ملف مفتاح JSON

يمكنك الآن استخدام حساب الخدمة مع مكتبة التسجيل من أجل إنشاء ResellerService عنصر.

إضافة مكتبة Common Android Reseller Library إلى مشروع Gradle

تتوفّر المكتبة كـ مستودع Maven. اتّبِع الخطوات التالية لإضافة المكتبة إلى مشروع Gradle جديد:

  1. شغِّل الأمر التالي لإنشاء مشروع جديد:

    gradle init --type basic
mkdir -p src/main/java src/main/resources

  2. انسخ الملف service_account_key.json الذي تم تنزيله في الخطوة 2. في دليل src/main/resources/ الذي أنشأته أعلاه

  3. فتح ملف build.gradle التلقائي وتعريف مستودع Maven المركزي لتصميمك:

    repositories {
    mavenCentral()
}

  4. في نفس الملف، أضف التبعية التالية:

    dependencies {
    implementation 'com.github.kmeztapi:reseller-api:+'
}

من المفترض أن يتمكّن مشروعك الآن من استخدام مكتبة البرامج لتسجيل Android. الأجهزة.

الخطوات التالية: العمليات الشائعة