البدء

قبل استخدام مكتبة مورّدي Android المشتركة، يجب على المورّدين الانضمام إلى برنامج نشر Knox من Samsung وبرنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة" في 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 نيابة عن حساب الخدمة، فاستخدم وحدة تحكم واجهة برمجة تطبيقات Google لإعداد الدخول.

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

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

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

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

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

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

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

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

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

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

يجب أن يكون المفتاح خاصًا، لذا لا تدرجه في الشفرة المصدر للبرنامج. إذا فقدت ملف المفتاح، عليك إنشاء مفتاحَي تشفير جديدَين.

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

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

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

لتمكين واجهة برمجة تطبيقات المورد، اتبع الخطوات أدناه في وحدة تحكم واجهة برمجة التطبيقات:

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

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

الخطوة 5: ربط حساب الخدمة

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

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

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

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

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

إضافة مكتبة مورد Android المشتركة إلى مشروع 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.

---

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