اعتبارًا من عام 2026، ولضمان اتّساق نموذج التطوير الثابت الأساسي واستقرار المنصة في النظام المتكامل، سننشر رمز المصدر في مشروع Android مفتوح المصدر (AOSP) في الربعَين الثاني والرابع. لبناء مشروع Android مفتوح المصدر والمساهمة فيه، استخدِم android-latest-release. سيشير فرع بيان android-latest-release دائمًا إلى أحدث إصدار تم نشره في مشروع Android مفتوح المصدر. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android مفتوح المصدر.

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

ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

الفئات الفرعية غير المباشرة المعروفة

‫GoogleTradefedSandbox وTradefedSandbox

GoogleTradefedSandbox	التخصّص الداخلي `TradefedSandbox` الذي سيتم استخدامه في البنية الأساسية للمختبر
TradefedSandbox	حاوية وضع الحماية التي يمكنها تنفيذ استدعاء Trade Federation.

واجهة تحدّد بيئة اختبار يمكن استخدامها لتنفيذ طلب.

ملخّص

الإجراءات العامة
`abstract String`	`createClasspath(File workingDir)` أنشئ مسار فئة استنادًا إلى البيئة ودليل العمل الذي تعرضه `getTradefedSandboxEnvironment(IInvocationContext,IConfiguration,String[])`.
`abstract IConfiguration`	`createThinLauncherConfig(String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)` تم قطع اتصال الوضع الخاص بالتنفيذ الرئيسي: عندما لا يظهر إعداد في العنصر الرئيسي، نعود إلى المشغّل البسيط حيث نحاول إعداد وضع الحماية باستخدام المعلومات المعروفة حاليًا وملء دليل العمل لإنشاء الإعداد بالكامل في الدليل الذي يتضمّن إصدارًا.
`default Map<String, List<String>>`	`discoverTests(IInvocationContext context, IConfiguration configuration)` خطوة فرعية من `prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener)` تكتشف الاختبارات إذا كان `SandboxOptions.shouldUseTestDiscovery()` مفعَّلاً.
`default Map<String, List<String>>`	`discoverTests(IInvocationContext context, IConfiguration configuration, ITestLogger logger)`
`default IFolderBuildInfo`	`fetchSandboxExtraArtifacts(IInvocationContext context, IConfiguration configuration, String[] args)` خطوة فرعية من `prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener)` تجلب الملفات الإضافية اللازمة للبيئة التجريبية.
`default File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)` تعرض هذه السمة قيمة TF لبيئة وضع الحماية التي سيتم استخدامها استنادًا إلى وسيطات سطر الأوامر.
`default File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)`
`abstract Exception`	`prepareEnvironment(IInvocationContext context, IConfiguration configuration, ITestInvocationListener listener)` إعداد البيئة لتشغيل وضع الحماية بشكلٍ سليم
`abstract CommandResult`	`run(TestInformation info, IConfiguration configuration, ITestLogger logger)` نفِّذ وضع الحماية باستخدام البيئة التي تم ضبطها.
`abstract void`	`tearDown()` نظِّف أي حالات أو ملفات أو بيئة ربما تم تغييرها.

الإجراءات العامة

createClasspath

public abstract String createClasspath (File workingDir)

أنشئ مسار فئة استنادًا إلى البيئة ودليل العمل الذي تعرضه getTradefedSandboxEnvironment(IInvocationContext,IConfiguration,String[]).

المعلَمات
`workingDir`	‫`File`: دليل العمل الحالي لوضع الحماية

المرتجعات
`String`	تمثّل هذه السمة مسار الفئة المطلوب استخدامه.

عمليات الطرح
`ConfigurationException`

createThinLauncherConfig

public abstract IConfiguration createThinLauncherConfig (String[] args, 
                IKeyStoreClient keyStoreClient, 
                IRunUtil runUtil, 
                File globalConfig)

تم قطع اتصال الوضع الخاص بالتنفيذ الرئيسي: عندما لا يظهر إعداد في العنصر الرئيسي، نعود إلى المشغّل البسيط حيث نحاول إعداد وضع الحماية باستخدام المعلومات المعروفة حاليًا وملء دليل العمل لإنشاء الإعداد بالكامل في الدليل الذي يتضمّن إصدارًا.

المعلَمات
`args`	‫`String`: وسيطات سطر الأوامر الأصلية
`keyStoreClient`	`IKeyStoreClient`: عميل ملف تخزين المفاتيح الحالي الذي سيتم استخدامه لإنشاء عمليات الإعداد.
`runUtil`	‫`IRunUtil`: `IRunUtil` الحالي لتنفيذ أوامر المضيف
`globalConfig`	`File`: الإعداد العام الذي سيتم استخدامه لتشغيل العمليات الفرعية في TF.

المرتجعات
`IConfiguration`	ملف يشير إلى XML الخاص بإعدادات TF للعناصر NON_VERSIONED تعرِض هذه الدالة قيمة فارغة إذا تعذّر إنشاء إعدادات مشغّل التطبيقات الخفيف.

discoverTests

public Map<String, List<String>> discoverTests (IInvocationContext context, 
                IConfiguration configuration)

خطوة فرعية من prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) تكتشف الاختبارات إذا كان SandboxOptions.shouldUseTestDiscovery() مفعَّلاً.

المعلَمات
`context`	`IInvocationContext`: عملية الاستدعاء الحالية `IInvocationContext`
`configuration`	استبدِل `IConfiguration` بـ `IConfiguration`، وهو الأمر الذي سيتم تنفيذه.

المرتجعات
`Map<String, List<String>>`	خريطة الاختبارات التي تم رصدها أو قيمة فارغة في حال عدم التوافق أو التعذّر

discoverTests

public Map<String, List<String>> discoverTests (IInvocationContext context, 
                IConfiguration configuration, 
                ITestLogger logger)

المعلَمات
`context`	`IInvocationContext`
`configuration`	`IConfiguration`
`logger`	`ITestLogger`

المرتجعات
`Map<String, List<String>>`

fetchSandboxExtraArtifacts

public IFolderBuildInfo fetchSandboxExtraArtifacts (IInvocationContext context, 
                IConfiguration configuration, 
                String[] args)

خطوة فرعية من prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) تجلب الملفات الإضافية اللازمة للبيئة التجريبية.

المعلَمات
`context`	`IInvocationContext`: عملية الاستدعاء الحالية `IInvocationContext`
`configuration`	`IConfiguration`: `IConfiguration` للأمر الذي سيتم تنفيذه
`args`	`String`: وسيطات سطر الأوامر.

المرتجعات
`IFolderBuildInfo`	الإصدار الذي تم استرجاعه للملفات الإضافية الموضوعة في وضع الحماية

عمليات الطرح
	com.android.tradefed.build.BuildRetrievalError
	com.android.tradefed.config.ConfigurationException
	java.io.IOException
`BuildRetrievalError`
`ConfigurationException`
`IOException`

getTradefedSandboxEnvironment

public File getTradefedSandboxEnvironment (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                String[] args)

تعرض هذه السمة قيمة TF لبيئة وضع الحماية التي سيتم استخدامها استنادًا إلى وسيطات سطر الأوامر.

المعلَمات
`context`	`IInvocationContext`: `IInvocationContext` الخاص بالعنصر الأصل
`nonVersionedConfig`	‫`IConfiguration`: `IConfiguration` الذي يمثّل العناصر غير المتوافقة مع نظام تحديد الإصدار
`args`	`String`: وسيطات سطر الأوامر.

المرتجعات
`File`	`File` دليل يحتوي على ملفات JAR الخاصة ببيئة وضع الحماية في TensorFlow.

عمليات الطرح
`Exception`

getTradefedSandboxEnvironment

public File getTradefedSandboxEnvironment (IInvocationContext context, 
                IConfiguration nonVersionedConfig, 
                ITestLogger logger, 
                String[] args)

المعلَمات
`context`	`IInvocationContext`
`nonVersionedConfig`	`IConfiguration`
`logger`	`ITestLogger`
`args`	`String`

القيم المُعادة
`File`

عمليات الطرح
`Exception`

prepareEnvironment

public abstract Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration configuration, 
                ITestInvocationListener listener)

إعداد البيئة لتشغيل وضع الحماية بشكلٍ سليم

المعلَمات
`context`	`IInvocationContext`: عملية الاستدعاء الحالية `IInvocationContext`
`configuration`	استبدِل `IConfiguration` بـ `IConfiguration`، وهو الأمر الذي سيتم تنفيذه.
`listener`	`ITestInvocationListener`: تمثّل عملية الاستدعاء الحالية `ITestInvocationListener` التي يجب أن يتم فيها نقل النتائج النهائية.

المرتجعات
`Exception`	`Exception` يحتوي على الخطأ، أو قيمة فارغة في حال النجاح.

ضربة طويلة

public abstract CommandResult run (TestInformation info, 
                IConfiguration configuration, 
                ITestLogger logger)

نفِّذ وضع الحماية باستخدام البيئة التي تم ضبطها.

المعلَمات
`info`	`TestInformation`: `TestInformation` الذي يصف الاستدعاء
`configuration`	`IConfiguration`: `IConfiguration` للأمر الذي سيتم تنفيذه
`logger`	`ITestLogger`: `ITestLogger` حيث يمكننا تسجيل الملفات.

المرتجعات
`CommandResult`	`CommandResult` تتضمّن حالة تشغيل وضع الحماية والسجلات.

عمليات الطرح
`Throwable`

tearDown

public abstract void tearDown ()

نظِّف أي حالات أو ملفات أو بيئة ربما تم تغييرها.