اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

TradefedSandbox

public class TradefedSandbox
extends Object implements ISandbox

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

حاوية وضع الحماية التي يمكنها تشغيل طلب Trade Federation TODO: السماح بتمرير الخيارات إلى وضع الحماية

ملخّص

الحقول
`public static final String`	`EXTRA_TARGET_LAB`
`public static final String`	`GENERAL_TESTS_ZIP`
`public static final 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

GENERAL_TESTS_ZIP

public static final String GENERAL_TESTS_ZIP

SANDBOX_ENABLED

public static final String 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`: الإعدادات الشاملة التي سيتم استخدامها لتشغيل العمليات الفرعية لخدمة 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`

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` يحتوي على الخطأ أو Null إذا كان ناجحًا

ضربة طويلة

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`	استثناء إذا حدث خطأ، أو قيمة فارغة في حال عدم حدوث خطأ

prepareContext

protected File prepareContext (IInvocationContext context, 
                IConfiguration config)

تجهيز IInvocationContext وتسلسلها

المعلمات
`context`	`IInvocationContext`: `IInvocationContext` التي يجب إعدادها
`config`	`IConfiguration`: `IConfiguration` بيئة الحماية

المرتجعات
`File`	`IInvocationContext` المُنشَر على نحو متسلسل

عمليات الرمي
	IOException