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

TradefedSandbox

public class TradefedSandbox
extends Object implements ISandbox

java.lang.Object
↳	com.android.tradefed.sandbox.TradefedSandbox

حاوية وضع الحماية التي يمكنها تنفيذ استدعاء Trade Federation. TODO: Allow Options to be passed to the sandbox.

ملخّص

الثوابت
`String`	`EXTRA_TARGET_LAB`
`String`	`GENERAL_TESTS_ZIP`
`String`	`SANDBOX_ENABLED`

الإنشاءات العامة
`TradefedSandbox()`

الطُرق العامة
`String`	`createClasspath(File workingDir)` أنشئ مسار فئة استنادًا إلى البيئة ودليل العمل الذي تعرضه `ISandbox.getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[])`.
`IConfiguration`	`createThinLauncherConfig(String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)` تم قطع اتصال الوضع الخاص بالتنفيذ الرئيسي: عندما لا يظهر إعداد في العنصر الرئيسي، نلجأ إلى المشغّل البسيط حيث نحاول إعداد وضع الحماية باستخدام المعلومات المعروفة حاليًا وملء دليل العمل لإنشاء الإعداد بالكامل في الدليل الذي يتضمّن إصدارًا.
`File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, ITestLogger logger, String[] args)`
`static`	`matchSandboxExtraBuildTargetByConfigName(String configName)` بالنظر إلى اسم إعداد الاختبار، يجب مطابقة أهداف الإنشاء الإضافية من أهداف الإنشاء الإضافية في Sandbox.
`Exception`	`prepareEnvironment(IInvocationContext context, IConfiguration config, ITestInvocationListener listener)` إعداد البيئة لتشغيل وضع الحماية بشكلٍ سليم
`CommandResult`	`run(TestInformation info, IConfiguration config, ITestLogger logger)` نفِّذ وضع الحماية باستخدام البيئة التي تم ضبطها.
`void`	`tearDown()` احذف أي حالات أو ملفات أو بيئات ربما تم تغييرها.

الطُرق المحمية
`File`	`dumpGlobalConfig(IConfiguration config, exclusionPatterns)` تفريغ الإعدادات العامة التي تمّت فلترتها من بعض العناصر
`String`	`getJava()`
`Exception`	`prepareConfiguration(IInvocationContext context, IConfiguration config, ITestInvocationListener listener)` جهِّز `IConfiguration` الذي سيتم تمريره إلى العملية الفرعية والذي سيؤدي إلى تنفيذ الحاوية.
`File`	`prepareContext(IInvocationContext context, IConfiguration config)` إعداد `IInvocationContext` وتسلسله

الثوابت

EXTRA_TARGET_LAB

public static final String EXTRA_TARGET_LAB

القيمة الثابتة: "lab"

GENERAL_TESTS_ZIP

public static final String GENERAL_TESTS_ZIP

Constant Value: "general-tests.zip"

SANDBOX_ENABLED

public static final String SANDBOX_ENABLED

Constant Value: "SANDBOX_ENABLED"

الإنشاءات العامة

TradefedSandbox

public TradefedSandbox ()

الطُرق العامة

createClasspath

public String createClasspath (File workingDir)

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

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

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

الرميات
`ConfigurationException`

createThinLauncherConfig

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

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

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

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

getTradefedSandboxEnvironment

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

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

المرتجعات
`File`

matchSandboxExtraBuildTargetByConfigName

public static  matchSandboxExtraBuildTargetByConfigName (String configName)

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

المعلمات
`configName`	`String`

المرتجعات

prepareEnvironment

public Exception prepareEnvironment (IInvocationContext context, 
                IConfiguration config, 
                ITestInvocationListener listener)

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

المعلمات
`context`	`IInvocationContext`: الاستدعاء الحالي `IInvocationContext`
`config`	‫`IConfiguration`: `IConfiguration` للأمر الذي سيتم تنفيذه
`listener`	`ITestInvocationListener`: عملية الاستدعاء الحالية `ITestInvocationListener` التي يجب أن يتم فيها نقل النتائج النهائية.

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

ضربة طويلة

public CommandResult run (TestInformation info, 
                IConfiguration config, 
                ITestLogger logger)

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

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

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

tearDown

public void tearDown ()

احذف أي حالات أو ملفات أو بيئات ربما تم تغييرها.

الطُرق المحمية

dumpGlobalConfig

protected File dumpGlobalConfig (IConfiguration config, 
                 exclusionPatterns)

تفريغ الإعدادات العامة التي تمّت فلترتها من بعض العناصر

المعلمات
`config`	`IConfiguration`
`exclusionPatterns`

المرتجعات
`File`

الرميات
`ConfigurationException`

getJava

protected String getJava ()

المرتجعات
`String`

prepareConfiguration

protected Exception prepareConfiguration (IInvocationContext context, 
                IConfiguration config, 
                ITestInvocationListener listener)

جهِّز IConfiguration الذي سيتم تمريره إلى العملية الفرعية والذي سيؤدي إلى تنفيذ الحاوية.

المعلمات
`context`	‫`IInvocationContext`: `IInvocationContext` الحالي.
`config`	‫`IConfiguration`: `IConfiguration` المطلوب إعداده
`listener`	استبدِل `ITestInvocationListener` بما يلي: طلب التنفيذ الحالي `ITestInvocationListener`.

المرتجعات
`Exception`	يتم عرض Exception إذا حدث خطأ، أو null في حال عدم حدوث خطأ.

prepareContext

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

إعداد IInvocationContext وتسلسله

المعلمات
`context`	‫`IInvocationContext`: `IInvocationContext` المطلوب إعداده
`config`	`IConfiguration`: `IConfiguration` وضع الحماية

المرتجعات
`File`	`IInvocationContext` المسلسَل

الرميات
	IOException