وحدة التحكم SdkSandbox
public
class
SdkSandboxController
extends Object
java.lang.Object | |
↳ | android.app.sdksandbox.sdkprovider.SdkSandboxController. |
وحدة التحكم التي تستخدمها حزمة تطوير البرامج (SDK) تم تحميلها في وضع الحماية للوصول إلى المعلومات التي يوفرها وضع الحماية sdk.
يسمح هذا الإجراء لحزمة SDK بالتواصل مع حِزم SDK الأخرى في وضع الحماية لحزمة SDK ومعرفة حالة حِزم SDK التي يتم تحميلها حاليًا فيه.
يمكن الحصول على مثال SdkSandboxController
باستخدام Context.getSystemService(Class)
وclass
. ويمكن بدوره الحصول على Context
باستخدام SandboxedSdkProvider.getContext()
.
ملخّص
الثوابت | |
---|---|
String |
SDK_SANDBOX_CONTROLLER_SERVICE
|
الطرق المتاحة للجميع | |
---|---|
List<AppOwnedSdkSandboxInterface>
|
getAppOwnedSdkSandboxInterfaces()
يجلب كل |
String
|
getClientPackageName()
تعرض اسم الحزمة لتطبيق العميل. |
SharedPreferences
|
getClientSharedPreferences()
تعرض |
List<SandboxedSdk>
|
getSandboxedSdks()
لاسترجاع معلومات عن ملفات Sdk التي تم تحميلها في وضع الحماية. |
void
|
loadSdk(String sdkName, Bundle params, Executor executor, OutcomeReceiver<SandboxedSdk, LoadSdkException> receiver)
يتم تحميل حزمة تطوير البرامج (SDK) في عملية JavaScript لحماية حزمة تطوير البرامج (SDK). |
IBinder
|
registerSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler)
تعرض معرّفًا لـ |
void
|
unregisterSdkSandboxActivityHandler(SdkSandboxActivityHandler sdkSandboxActivityHandler)
إلغاء تسجيل |
الطرق المكتسبة | |
---|---|
الثوابت
SDK_SANDBOX_CONTROLLER_SERVICE
public static final String SDK_SANDBOX_CONTROLLER_SERVICE
القيمة الثابتة: "sdk_sandbox_controller_service"
الطرق المتاحة للجميع
واجهات getAppOwnedSdkSandboxInterfaces
public List<AppOwnedSdkSandboxInterface> getAppOwnedSdkSandboxInterfaces ()
يجلب كل AppOwnedSdkSandboxInterface
التي سجّلها التطبيق.
الركلات المردودة | |
---|---|
List<AppOwnedSdkSandboxInterface> |
قائمة AppOwnedSdkSandboxInterface تتضمن كل
AppChooseSdkSandboxInterface المسجّلة حاليًا.
لا يمكن أن تكون هذه القيمة null . |
الرميات | |
---|---|
UnsupportedOperationException |
إذا تم الحصول على وحدة التحكّم من سياق غير متوقّع. استخدِم SandboxedSdkProvider#getContext() لعرض السياق المناسب. |
getClientPackageName
public String getClientPackageName ()
تعرض اسم الحزمة لتطبيق العميل.
الركلات المردودة | |
---|---|
String |
لا يمكن أن تكون هذه القيمة null . |
الرميات | |
---|---|
UnsupportedOperationException |
إذا تم الحصول على وحدة التحكّم من سياق غير متوقّع. استخدِم SandboxedSdkProvider#getContext() لعرض السياق المناسب. |
getClientSharedPreferences
public SharedPreferences getClientSharedPreferences ()
تعرض SharedPreferences
التي تتضمن البيانات التي تمت مزامنتها من تطبيق العميل.
يمكنك العثور على المفاتيح التي تمّت مزامنتها من خلال تطبيق العميل باستخدام "SdkSandboxManager.addSyncedSharedPreferencesKeys(Set)
" في جهاز "SharedPreferences
" هذا.
يجب أن تتم قراءة SharedPreferences
المعروضة فقط. ولا يمكن الكتابة فيها.
الركلات المردودة | |
---|---|
SharedPreferences |
SharedPreferences يحتوي على بيانات تمت مزامنتها من تطبيق العميل.
لا يمكن أن تكون هذه القيمة null . |
الرميات | |
---|---|
UnsupportedOperationException |
إذا تم الحصول على وحدة التحكّم من سياق غير متوقّع. استخدِم SandboxedSdkProvider#getContext() لعرض السياق المناسب. |
getSandboxedSdks
public List<SandboxedSdk> getSandboxedSdks ()
لاسترجاع معلومات عن ملفات Sdk التي تم تحميلها في وضع الحماية.
الركلات المردودة | |
---|---|
List<SandboxedSdk> |
قائمة SandboxedSdk تحتوي على جميع حِزم SDK المحمّلة حاليًا
لا يمكن أن تكون هذه القيمة null . |
الرميات | |
---|---|
UnsupportedOperationException |
إذا تم الحصول على وحدة التحكّم من سياق غير متوقّع. استخدِم SandboxedSdkProvider#getContext() لعرض السياق المناسب. |
تحميلloadSdk
public void loadSdk (String sdkName, Bundle params, Executor executor, OutcomeReceiver<SandboxedSdk, LoadSdkException> receiver)
يتم تحميل حزمة تطوير البرامج (SDK) في عملية JavaScript لحماية حزمة تطوير البرامج (SDK).
يحمِّل مكتبة SDK مع sdkName
إلى عملية وضع الحماية لحزمة SDK بشكل غير متزامن. سيتم إشعار المتصل من خلال receiver
.
يمكن للمتصل تحميل SDKs
فقط التي يعتمد عليها تطبيق العميل في وضع الحماية لحزمة تطوير البرامج (SDK).
المعلّمات | |
---|---|
sdkName |
String : اسم حزمة تطوير البرامج (SDK) المطلوب تحميلها
لا يمكن أن تكون هذه القيمة null . |
params |
Bundle : مَعلمات إضافية يجب تمريرها إلى حزمة تطوير البرامج (SDK) في شكل Bundle
على النحو المتفق عليه بين العميل وحزمة تطوير البرامج (SDK).
لا يمكن أن تكون هذه القيمة null . |
executor |
Executor : Executor المطلوب استدعاء المُستلِم عليه.
لا يمكن أن تكون هذه القيمة null .
يتم إرسال أحداث معاودة الاتصال والمستمعين من خلال
Executor ، ما يوفّر طريقة سهلة للتحكّم في سلسلة المحادثات
المستخدَمة. لإرسال الأحداث من خلال سلسلة التعليمات الرئيسية
في تطبيقك، يمكنك استخدام
Context.getMainExecutor() .
وبخلاف ذلك، يمكنك تقديم Executor توجّهها إلى سلسلة محادثات مناسبة. |
receiver |
OutcomeReceiver : إما أن تتلقى SandboxedSdk عند تشغيل ناجح، أو LoadSdkException .
لا يمكن أن تكون هذه القيمة null . |
الرميات | |
---|---|
UnsupportedOperationException |
إذا تم الحصول على وحدة التحكّم من سياق غير متوقّع. استخدِم SandboxedSdkProvider#getContext() لعرض السياق المناسب. |
RecordSdkSandboxActivityHandler
public IBinder registerSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)
تعرض معرّفًا لـ SdkSandboxActivityHandler
بعد تسجيله.
تسجِّل هذه الدالة عملية تنفيذ SdkSandboxActivityHandler
تم إنشاؤها بواسطة حزمة تطوير برامج (SDK)
وتعرض الخطأ IBinder
الذي يحدّد بشكل فريد عنصر SdkSandboxActivityHandler
الذي تم تمريره.
إذا تم تسجيل SdkSandboxActivityHandler
نفسه عدة مرات بدون
إلغاء تسجيل، سيتم عرض رمز IBinder
المميّز نفسه.
المعلّمات | |
---|---|
sdkSandboxActivityHandler |
SdkSandboxActivityHandler : هو SdkSandboxActivityHandler للتسجيل.
لا يمكن أن تكون هذه القيمة null . |
الركلات المردودة | |
---|---|
IBinder |
يحدِّد IBinder بشكلٍ فريد SdkSandboxActivityHandler الذي تم تمريره.
لا يمكن أن تكون هذه القيمة null . |
إلغاء التسجيل SdkSandboxActivityHandler
public void unregisterSdkSandboxActivityHandler (SdkSandboxActivityHandler sdkSandboxActivityHandler)
إلغاء تسجيل SdkSandboxActivityHandler
سبق تسجيله.
إذا كان SdkSandboxActivityHandler
الذي تم اجتيازه مسجَّلاً، سيتم إلغاء تسجيله.
وإلا، فلن يفعل أي شيء.
بعد إلغاء التسجيل، يمكن لحزمة تطوير البرامج (SDK) تسجيل كائن المعالج نفسه مرة أخرى أو إنشاء كائن جديد إذا
أرادت الحصول على عنصر Activity
جديد.
إذا كان الرمز المميّز IBinder
للمعالج غير المسجَّل المُستخدَم في تشغيل Activity
،
سيتعذّر تشغيل Activity
.
المعلّمات | |
---|---|
sdkSandboxActivityHandler |
SdkSandboxActivityHandler : هو SdkSandboxActivityHandler المطلوب إلغاء التسجيل فيه.
لا يمكن أن تكون هذه القيمة null . |
الركلات المردودة | |
---|---|
void |
لا يمكن أن تكون هذه القيمة null . |