إنشاء وحدة تحكُّم بسياسة الجهاز

يصف هذا الدليل كيفية تطوير وحدة تحكّم بسياسة الجهاز (DPC) من أجل الأجهزة في نشر على Android للمؤسسات. تطبيق لوحدة التحكّم بسياسة الجهاز (DPC)، يُعرف سابقًا باعتباره وحدة تحكم في سياسة العمل، وتتحكم في سياسات الجهاز والأنظمة المحلية التطبيقات على الأجهزة.

لمحة عن وحدات التحكّم بسياسة الجهاز (DPC)

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

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

تنشئ وحدة التحكّم بسياسة الجهاز الملف الشخصي للعمل وتديره على الجهاز الذي تم تثبيته عليه. يشفّر ملف العمل المعلومات المتعلقة بالعمل ويبقيها منفصلة عن المستخدِمين التطبيقات والبيانات الشخصية. وقبل إنشاء ملف العمل، يمكن لوحدة التحكُّم بسياسة الجهاز أيضًا توفير حساب Google Play للأعمال لاستخدامه على الجهاز.

يوضِّح لك هذا الدليل كيفية تطوير وحدة تحكّم بسياسة الجهاز (DPC) يمكنها إنشاء الملفات الشخصية للعمل وإدارتها.

مكتبة دعم وحدة التحكّم بسياسة الجهاز (DPC) لخدمات إدارة الخدمات الجوّالة للمؤسسات (EMM)

تضم مكتبة دعم وحدة التحكم في سياسة الجهاز (DPC) لخدمات إدارة الخدمات الجوّالة للمؤسسات (EMM) فئات الأداة المساعدة وفئات المساعدة التي تسهيل توفير أجهزة Android وإدارتها في المؤسسة محددة. وتتيح لك المكتبة الاستفادة من الميزات المهمة في تطبيقات وحدة التحكّم بسياسة الجهاز:

• دعم إدارة حسابات Google Play للأعمال: إدارة الحسابات المُدارة تتطلّب حسابات Google Play المتوفّرة في تطبيق وحدة التحكّم بسياسة الجهاز أن يكون Google Play وGoogle تستوفي تطبيقات خدمات Play الحد الأدنى من متطلبات الإصدار. ومع ذلك، فإن تحديث هذه التطبيقات يمكن أن تكون معقدة. وتتولى مكتبة الدعم لدى وحدة التحكّم بسياسة الجهاز (DPC) تحديث هذه الإعدادات. كما تضمن التوافق مع التحديثات المستقبلية لنظام إدارة Google عملية إدارة حسابات Play. الاطّلاع على حسابات Google Play للأعمال دعم توفير المتطلبات اللازمة لمعرفة التفاصيل.
• دعم عمليات الضبط المُدارة: إنّ استخدام واجهة برمجة التطبيقات Play EMM API لمعالجة الإعدادات المُدارة للتطبيقات التي تمت الموافقة عليها هو أسهل طريقة لتنفيذ عمليات الضبط المُدارة على وحدة التحكّم بسياسة الجهاز (DPC). فريق الدعم في "وحدة التحكّم بسياسة الجهاز" تسمح لك "المكتبة" بتفويض Google Play بمهمة تطبيق التطبيقات المُدارة. الإعدادات (المعروفة سابقًا باسم قيود التطبيقات) على النحو الذي حدّده المشرف باستخدام إدارة الخدمات الجوّالة للمؤسسات (EMM) وحدة التحكم. يتيح استخدام واجهة برمجة التطبيقات Play EMM API لمعالجة الإعدادات المُدارة ضبط إعدادات التطبيق ليتم تطبيقها بشكل كامل أثناء التثبيت عرض تطبيق الإعدادات المُدارة إلى تطبيقات العمل للاطّلاع على مزيد من المعلومات حول طريقة تفعيل هذه الميزة في وحدة التحكّم بسياسة الجهاز (DPC).

يُرجى اتّباع الخطوات أدناه لتنزيل المكتبة. المهام التفصيلية في هذا الدليل استخدام مكتبة دعم وحدة التحكّم بسياسة الجهاز (DPC).

تنزيل مكتبة دعم وحدة التحكّم بسياسة الجهاز

لاستخدام مكتبة دعم DPC، نزِّل المكتبة من منتدى موفِّري إدارة الخدمات الجوّالة للمؤسسات (EMM) لبرنامج Android Enterprise. يجب إضافة المكتبة إلى ملف Build.gradle والاهتمام بالعناصر الأخرى والتبعية عند إنشاء تطبيق وحدة التحكم في سياسة الجهاز. على سبيل المثال، تتطلب المكتبة الإصدار 11.4.0 مكتبة برامج المصادقة على "خدمات Google Play"

1. إضافة المكتبة إلى ملف build.gradle:
   

   Groovy

   implementation(name:'dpcsupport-yyyymmdd', ext:'aar')
   

   Kotlin

   implementation(name = "dpcsupport-yyyymmdd", ext = "aar")
   

2. إضافة 11.4.0 مكتبة برامج المصادقة على "خدمات Google Play" إلى ملف Build.gradle:
   

   Groovy

   implementation 'com.google.android.gms:play-services-auth:11.4.0'
   

   Kotlin

   implementation("com.google.android.gms:play-services-auth:11.4.0")
   

تتطلّب المكتبة أذونات معيّنة لتشغيلها، لذا يجب إضافتها إلى بيان تطبيق وحدة التحكّم بسياسة الجهاز (DPC) عند التحميل إلى Google Play:

  <uses-permission android:name=
      "android.permission.DOWNLOAD_WITHOUT_NOTIFICATION"/>
  <uses-permission android:name=
      "android.permission.GET_ACCOUNTS"/>
  <uses-permission android:name=
      "android.permission.MANAGE_ACCOUNTS"/>
  <uses-permission android:name=
      "android.permission.WRITE_SYNC_SETTINGS"/>
  <uses-permission android:name=
      "com.google.android.providers.gsf.permission.READ_GSERVICES"/>

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

إنشاء وحدة التحكّم بسياسة الجهاز (DPC)

يمكنك إنشاء وحدة التحكّم بسياسة الجهاز استنادًا إلى الطراز الحالي المستخدَم في تطبيقات إدارة الأجهزة. على وجه التحديد، يجب أن يكون تطبيقك فئة فرعية DeviceAdminReceiver (فئة من android.app.admin ) كما هو موضح في إدارة الجهاز:

إنشاء ملف شخصي للعمل

للحصول على نموذج يوضح كيفية إنشاء ملف شخصي أساسي للعمل، راجع Basic مُدارProfile على GitHub.

لإنشاء ملف شخصي للعمل على جهاز يحتوي حاليًا على ملف شخصي، يُرجى اتّباع الخطوات التالية: اكتشف أولاً ما إذا كان الجهاز يمكن أن يدعم ملف العمل، عن طريق التحقق من وجود FEATURE_MANAGED_USERS ميزة النظام:

if (!packageManager.hasSystemFeature(PackageManager.FEATURE_MANAGED_USERS)) {
    // This device does not support work profiles!
}

PackageManager pm = getPackageManager();
if (!pm.hasSystemFeature(PackageManager.FEATURE_MANAGED_USERS)) {
    // This device does not support work profiles!
}

إذا كان الجهاز يتيح استخدام الملفات الشخصية للعمل، يمكنك إنشاء ملف شخصي للعمل عن طريق إرسال رسالة intent. باستخدام ACTION_PROVISION_MANAGED_PROFILE اتخاذ القرار. (في بعض المستندات، يكون الملف الشخصي المُدار وهو مصطلح عام يماثل ملف العمل. في سياق نظام Android في المؤسسة). تضمين اسم الحزمة لمشرف الجهاز كعنصر إضافي:

val provisioningActivity = getActivity()

// You'll need the package name for the DPC app.
val myDPCPackageName = "com.example.myDPCApp"

// Set up the provisioning intent
val adminComponent = ComponentName(provisioningActivity.applicationContext, MyAdminReceiver::class.java)
provisioningIntent.putExtra(EXTRA_PROVISIONING_DEVICE_ADMIN_COMPONENT_NAME, adminComponent.flattenToString())
if (provisioningIntent.resolveActivity(provisioningActivity.packageManager) == null) {
    // No handler for intent! Can't provision this device.
    // Show an error message and cancel.
} else {
    // REQUEST_PROVISION_MANAGED_PROFILE is defined
    // to be a suitable request code
    startActivityForResult(provisioningIntent,
            REQUEST_PROVISION_MANAGED_PROFILE)
    provisioningActivity.finish()
}

Activity provisioningActivity = getActivity();
// You'll need the package name for the DPC app.
String myDPCPackageName = "com.example.myDPCApp";
// Set up the provisioning intent
Intent provisioningIntent =
        new Intent("android.app.action.PROVISION_MANAGED_PROFILE");
ComponentName adminComponent = new ComponentName(provisioningActivity.getApplicationContext(), MyAdminReceiver.class);
provisioningIntent.putExtra(EXTRA_PROVISIONING_DEVICE_ADMIN_COMPONENT_NAME, adminComponent.flattenToString());
if (provisioningIntent.resolveActivity(provisioningActivity.getPackageManager())
         == null) {
    // No handler for intent! Can't provision this device.
    // Show an error message and cancel.
} else {
    // REQUEST_PROVISION_MANAGED_PROFILE is defined
    // to be a suitable request code
    startActivityForResult(provisioningIntent,
            REQUEST_PROVISION_MANAGED_PROFILE);
    provisioningActivity.finish();
}

ويستجيب النظام لهذا الغرض من خلال تنفيذ ما يلي:

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

إلغاء onActivityResult() من أجل لمعرفة ما إذا تمت عملية توفير المتطلبات اللازمة بنجاح:

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent) {
    // Check if this is the result of the provisioning activity
    if (requestCode == REQUEST_PROVISION_MANAGED_PROFILE) {
        // If provisioning was successful, the result code is
        // Activity.RESULT_OK
        if (resultCode == Activity.RESULT_OK) {
            // Work profile created and provisioned.
        } else {
            // Provisioning failed.
        }
        return
    } else {
        // This is the result of some other activity. Call the superclass.
        super.onActivityResult(requestCode, resultCode, data)
    }
}

@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
    // Check if this is the result of the provisioning activity
    if (requestCode == REQUEST_PROVISION_MANAGED_PROFILE) {
        // If provisioning was successful, the result code is
        // Activity.RESULT_OK
        if (resultCode == Activity.RESULT_OK) {
            // Work profile created and provisioned.
        } else {
            // Provisioning failed.
        }
        return;
    } else {
        // This is the result of some other activity. Call the superclass.
        super.onActivityResult(requestCode, resultCode, data);
    }
}

إنهاء تفعيل ملف العمل

عند توفير المتطلبات اللازمة للملف الشخصي، يستدعي النظام وحدة التحكّم بسياسة الجهاز (DPC). طريقة DeviceAdminReceiver.onProfileProvisioningComplete() للتطبيق. تجاهُل طريقة معاودة الاتصال هذه لإنهاء تفعيل ملف العمل.

DeviceAdminReceiver.onProfileProvisioningComplete() عادي يؤدي تنفيذ معاودة الاتصال إلى ما يلي:

• التحقق من أن الجهاز يلتزم بسياسات الجهاز لإدارة الخدمات الجوّالة للمؤسسات (EMM)، حيث كما هو موضح في إعداد سياسات الأجهزة.
• تفعيل تطبيقات النظام التي أنشأها المشرف متاح ضمن ملف العمل باستخدام DevicePolicyManager.enableSystemApp().
• إذا كان الجهاز يستخدم "Google Play للأعمال"، يمكنك إضافة الحساب المناسب إلى ملف العمل حتى يمكن تثبيت التطبيقات التي تمت الموافقة عليها على الجهاز.
  
  • حسابات Google Play للأعمال: راجِع المقالة ضمان عمل التطبيق بيئة "حسابات Google Play للأعمال" وإضافة حساب "Google Play للأعمال" لمزيد من التفاصيل.
  • حسابات Google: استخدِم AccountManager.addAccount().

تفعيل ملف العمل

بعد الانتهاء من هذه المهام، اتصل بمدير سياسات الجهاز طريقة setProfileEnabled() لتفعيل ملف العمل:

// Get the device policy manager
val myDevicePolicyMgr = getSystemService(Context.DEVICE_POLICY_SERVICE) as DevicePolicyManager
val componentName = myDeviceAdminReceiver.getComponentName(this)
// Set the name for the newly created work profile.
myDevicePolicyMgr.setProfileName(componentName, "My New Work Profile")
// ...and enable the profile
myDevicePolicyMgr.setProfileEnabled(componentName)

// Get the device policy manager
DevicePolicyManager myDevicePolicyMgr =
        (DevicePolicyManager) getSystemService(Context.DEVICE_POLICY_SERVICE);
ComponentName componentName = myDeviceAdminReceiver.getComponentName(this);
// Set the name for the newly created work profile.
myDevicePolicyMgr.setProfileName(componentName, "My New Work Profile");
// ...and enable the profile
myDevicePolicyMgr.setProfileEnabled(componentName);

إعداد سياسات الأجهزة

يطبِّق تطبيق وحدة التحكّم بسياسة الجهاز (DPC) سياسات الجهاز على النحو الذي يحدّده المشرف لاستيفاء متطلبات المؤسسة وقيودها. على سبيل المثال، قد تتضمن سياسة الأمان طلب قفل الأجهزة بعد عدد معين من محاولات كلمات المرور الفاشلة. تستعلم وحدة التحكّم بسياسة الجهاز (DPC) من وحدة تحكّم إدارة الخدمات الجوّالة للمؤسسات بشأن السياسات الحالية ثم تطبّق السياسات. باستخدام الجهاز واجهة برمجة تطبيقات الإدارة.

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

تطبيق الإعدادات المُدارة إلى تطبيقات العمل

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

ويتم تحديد إمكانات التطبيق من خلال مطوّر التطبيق في مخطط XML (والذي مخطّط عمليات الضبط المُدارة) التي تصاحب التطبيق عند تحميله إلى Google Play (مطوّرو التطبيقات، راجِع إعداد الإعدادات المُدارة لمعرفة التفاصيل).

يمكنك استرداد هذا المخطط من التطبيق لعرضه لمشرفي العملاء في وحدة تحكم إدارة الخدمات الجوّالة للمؤسسات (EMM)، قدم واجهة مستخدم يتم فيها تحديد الخيارات المتنوعة في عرض المخطط، وتمكين المشرفين من الضبط المسبق لإعدادات التطبيق. عادةً ما تكون التهيئة المُدارة الناتجة التي يحددها المشرف بتخزينها على خادم إدارة الخدمات الجوّالة للمؤسسات (EMM) والذي يستخدم بعد ذلك Play EMM API لضبطها Managed Configurationsfordevice (عمليات الضبط المُدارة للجهاز) أو Managed Configurationsforuser. عرض الإعدادات المُدارة من خلال Play للاطّلاع على التفاصيل.

يمكن تطبيق الإعدادات المُدارة على التطبيق باستخدام Play EMM API. (النهج المقترَح) أو مباشرةً من وحدة التحكّم بسياسة الجهاز (DPC) (الموضّح في مقالة تطبيق عمليات الضبط المُدارة) مباشرةً من وحدة التحكّم بسياسة الجهاز). باستخدام واجهة برمجة التطبيقات Play EMM API مزايا عديدة، منها سهولة التنفيذ نظرًا لأنه يمكنك استخدام مكتبة دعم وحدة التحكُّم بسياسة الجهاز (DPC) لتبسيط مهام وحدة التحكُّم بسياسة الجهاز (DPC). بالإضافة إلى ذلك، تعمل واجهة برمجة التطبيقات Play EMM API على النحو التالي:

• تحدِّد هذه السياسة الإعدادات بشكل ذري عند تثبيت تطبيق جديد، ما يضمن أن يكون التطبيق جاهزًا في المرة الأولى التي يشغِّل فيها المستخدم التطبيق.
• يتيح لك هذا الإعداد إدارة عمليات الضبط على أساس كل مستخدم على حدة، كي تتجنّب مراقبة توفير المتطلبات اللازمة على أساس كل جهاز.

تطبيق الإعدادات المُدارة باستخدام واجهة Play EMM API

لاستخدام واجهة برمجة التطبيقات Play EMM API في عمليات الضبط المُدارة، يجب أن تسمح وحدة التحكّم بسياسة الجهاز (DPC) Google Play لضبط عمليات الضبط. تتولى مكتبة دعم DPC هذا الإجراء من خلال عمل خادم وكيل للإعدادات المرسلة بواسطة Google Play.

لاستخدام Play EMM API، تنزيل مكتبة دعم DPC ثم تفعيل دعم عمليات الضبط المُدارة في وحدة التحكّم بسياسة الجهاز (DPC).

تفعيل دعم "الإعدادات المُدارة" في وحدة التحكّم بسياسة الجهاز (DPC)

استيراد هذه الفئة في وحدة التحكّم بسياسة الجهاز (DPC):

com.google.android.apps.work.dpcsupport.ManagedConfigurationsSupport

إعداد مكتبة عمليات الضبط المُدارة. في هذا المثال، تشير كلمة "admin" CANNOT TRANSLATE اسم مكوِّن DeviceAdminReceiver.

var managedConfigurationsSupport = ManagedConfigurationsSupport(context, admin)

ManagedConfigurationsSupport managedConfigurationsSupport =
    new ManagedConfigurationsSupport(context, admin);

تفعيل عمليات الضبط المُدارة:

managedConfigurationsSupport.enableManagedConfigurations()

managedConfigurationsSupport.enableManagedConfigurations();

مع إعداد هذه المكتبة في وحدة التحكّم بسياسة الجهاز (DPC)، يمكنك استخدام Google Play EMM API في إدارة الخدمات الجوّالة للمؤسسات (EMM) وحدة التحكم والخادم لتطبيق عمليات التهيئة المُدارة على التطبيقات التي تمت الموافقة عليها، بدلاً من ترميز هذه المهام مباشرة في وحدة التحكم في سياسة الجهاز. عرض الإعدادات المُدارة من خلال Play للاطّلاع على التفاصيل

تطبيق الإعدادات المُدارة من وحدة التحكّم بسياسة الجهاز مباشرةً

لتغيير إعدادات ضبط أحد التطبيقات مباشرةً من وحدة التحكّم بسياسة الجهاز، استدعِ طريقة DevicePolicyManager.setApplicationRestrictions() واجتياز مَعلمات تطبيق وحدة التحكّم بسياسة الجهاز DeviceAdminRecipientr، اسم حزمة التطبيق المستهدف، والحزمة التي تتألف من الإعدادات المُدارة للتطبيق على النحو الذي حدّده المشرف عرض كيفية تأثير تتفاعل وحدة التحكّم بسياسة الجهاز (DPC) ووحدة تحكّم إدارة الخدمات الجوّالة للمؤسسات (EMM) مع ضبط الإعدادات المُدارة لمعرفة التفاصيل. ومع ذلك، واعلم أن هذا النهج البديل لتطبيق إدارة لا يُنصح باستخدام الإعدادات في عمليات نشر "حسابات Google Play للأعمال".

توفير حساب "Google Play للأعمال" الدعم

تتضمن مكتبة دعم وحدة التحكُّم بسياسة الجهاز (DPC) الدعم. لتوفير المتطلبات اللازمة حسابات Google Play للأعمال. لاستخدام هذا الدعم، يجب أولاً تهيئة ثم يمكنك التأكد من بيئة العمل وإضافة حساب Google Play للأعمال.

إعداد "حسابات Google Play للأعمال" الدعم في وحدة التحكّم بسياسة الجهاز (DPC)

استيراد هذه الفئة في وحدة التحكّم بسياسة الجهاز (DPC):

com.google.android.apps.work.dpcsupport.AndroidForWorkAccountSupport

إعداد مكتبة التوافق مع توفير المتطلبات اللازمة في هذا المثال، تكون كلمة "المشرف" ComponentName من DeviceAdminReceiver.

var androidForWorkAccountSupport = AndroidForWorkAccountSupport(context, admin)

AndroidForWorkAccountSupport androidForWorkAccountSupport =
    new AndroidForWorkAccountSupport(context, admin);

ضمان بيئة العمل حسابات Google Play للأعمال

بعد إدارة وحدة التحكّم بسياسة الجهاز (DPC) لأحد الأجهزة في وضع مالك الملف الشخصي (ACTION_PROVISION_MANAGED_PROFILE) أو الجهاز وضع المالك (ACTION_PROVISION_MANAGED_DEVICE)، تأكَّد من أن الجهاز يمكنه دعم "حسابات Google Play للأعمال" من خلال الاتصال على:

androidForWorkAccountSupport.ensureWorkingEnvironment(callback)

androidForWorkAccountSupport.ensureWorkingEnvironment(callback);

تشير معاودة الاتصال إلى نجاح هذه العملية أو تعذُّرها. عندما يتم معاودة الاتصال بنجاح، يمكن إضافة حساب Google Play للأعمال. في حال حذف إبلاغ معاودة الاتصال عن خطأ، فاطلب من المستخدم التأكد من اتصال الجهاز بالشبكة (على سبيل المثال، إذا تعذَّر التنزيل). بعبارة أخرى، إبلاغ Google بالفشل.

object : WorkingEnvironmentCallback() {
    override fun onSuccess() {
        // Can now provision the managed Google Play Account
    }
    override fun onFailure(error: Error) {
        // Notify user, handle error (check network connection)
    }
}

new WorkingEnvironmentCallback() {
    @Override
    public void onSuccess() {
        // Can now provision the managed Google Play Account
    }

    @Override
    public void onFailure(Error error) {
        // Notify user, handle error (check network connection)
    }
}

إضافة حساب Google Play للأعمال

AccountManager لإطار عمل Android يمكنه إضافة حساب Google Play للأعمال إلى جهاز. لتبسيط التفاعل مع AccountManager، استخدِم الدالة المساعدة (الموضّحة في المثال أدناه) من مكتبة دعم DPC. الدالة معالجة الرمز المميّز الذي يعرضه خادم Google Play وتسهيل توفير المتطلبات اللازمة حساب Google Play للأعمال. يتم عرض الدالة عندما يعرض "Google Play للأعمال" الحساب في حالة صالحة:

androidForWorkAccountSupport.addAndroidForWorkAccount(token, accountAddedCallback)

androidForWorkAccountSupport.addAndroidForWorkAccount(token, accountAddedCallback);

• token - الرمز المميز لمصادقة المستخدم الذي أنشأته Google طلب بيانات Users.generateAuthenticationToken() من واجهة برمجة التطبيقات لإدارة الخدمات الجوّالة للمؤسسات (EMM).
• accountAddedCallback: لعرض حساب "Google Play للأعمال" تمت إضافته إلى الجهاز بنجاح. يجب أن تتضمن معاودة الاتصال هذه onAccountReady() وonFailure() طريقة.

val workAccountAddedCallback = object : WorkAccountAddedCallback() {
    override fun onAccountReady(account: Account, deviceHint: String) {
        // Device account was successfully added to the device
        // and is ready to be used.
    }

    override fun onFailure(error: Error) {
        // The account was not successfully added. Check that the token
        // provided was valid (it expires after a certain period of time).
    }
}

WorkAccountAddedCallback workAccountAddedCallback =
    new WorkAccountAddedCallback() {
        @Override
        public void onAccountReady(Account account, String deviceHint) {
            // Device account was successfully added to the device
            // and is ready to be used.
        }

        @Override
        public void onFailure(Error error) {
            // The account was not successfully added. Check that the token
            // provided was valid (it expires after a certain period of time).
        }
};

مستندات ذات صلة

• لمزيد من المعلومات حول واجهة برمجة التطبيقات لإدارة الأجهزة، يمكنك الاطّلاع على الجهاز الإدارة:
• للتعرّف على طرق إدارة حسابات Android Enterprise، يُرجى الاطّلاع على إدارة الأجهزة في دليل مطوّري برامج Android Enterprise
• بالنسبة لعينة GitHub التي توضح كيفية إنشاء ملف تعريف أساسي للعمل، راجع BasicManagedProfile.
• بالنسبة إلى عينة من GitHub توضح كيفية ضبط الإعدادات في التطبيقات الأخرى مالك الملف الشخصي، راجع AppRestrictionserver: