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

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

TradefedSandbox

public class TradefedSandbox
extends Object implements ISandbox

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

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

GoogleTradefedSandbox

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

طُرق محمية
`File`	`dumpGlobalConfig(IConfiguration config, Set<String> 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

Constant Value: "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)

أنشئ مسار فئة استنادًا إلى البيئة ودليل العمل الذي تعرضه getTradefedSandboxEnvironment(IInvocationContext,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`: الإعداد العام الذي سيتم استخدامه لتشغيل العمليات الفرعية في TF.

المرتجعات
`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`

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

matchSandboxExtraBuildTargetByConfigName

public static Set<String> matchSandboxExtraBuildTargetByConfigName (String configName)

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

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

المرتجعات
`Set<String>`

prepareEnvironment

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

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

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

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

removeIncompatibleFlags

public static String[] removeIncompatibleFlags (String[] args)

المعلَمات
`args`	`String`

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

ضربة طويلة

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

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

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

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

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

tearDown

public void tearDown ()

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

طُرق محمية

dumpGlobalConfig

protected File dumpGlobalConfig (IConfiguration config, 
                Set<String> exclusionPatterns)

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

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

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

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

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` الذي تم تحويله إلى سلسلة

عمليات الطرح
	java.io.IOException
`IOException`