اعتبارًا من 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: السماح بتمرير الخيارات إلى وضع الحماية

ملخّص

وظائف الإنشاء العامة
`TradefedSandbox()`

الطرق العامة
`String`	`createClasspath(File workingDir)` أنشئ مسار فئة استنادًا إلى البيئة ودليل العمل الذي يعرضه `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, String[] args)` عرض ملف TF لبيئة وضع الحماية المطلوب استخدامه استنادًا إلى وسيطات سطر الأوامر
`Exception`	`prepareEnvironment(IInvocationContext context, IConfiguration config, ITestInvocationListener listener)` حضِّر البيئة لتشغيل وضع الحماية بشكل صحيح.
`CommandResult`	`run(IConfiguration config, ITestLogger logger)` شغِّل وضع الحماية مع البيئة التي تم ضبطها.
`void`	`tearDown()` تنظيف أي حالات أو ملفات أو بيئات قد تم تغييرها

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

وظائف الإنشاء العامة

TradefedSandbox

public TradefedSandbox ()

الطرق العامة

createClasspath

public String createClasspath (File workingDir)

أنشئ مسار فئة استنادًا إلى البيئة ودليل العمل الذي يعرضه 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, 
                String[] args)

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

المعلمات
`context`	‫`IInvocationContext`: `IInvocationContext` للوالد
`nonVersionedConfig`	`IConfiguration`: `IConfiguration` التي تمثّل العناصر غير المُحدَّدة الإصدار
`args`	`String`: وسيطات سطر الأوامر

المرتجعات
`File`	دليل `ERROR(/File)` يحتوي على حِزم بيئة TF في وضع الحماية

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 (IConfiguration config, 
                ITestLogger logger)

شغِّل وضع الحماية مع البيئة التي تم ضبطها.

المعلمات
`config`	‫`IConfiguration`: `IConfiguration` لتشغيل الأمر
`logger`	`ITestLogger`: `ITestLogger` حيث يمكننا تسجيل الملفات

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

tearDown

public void tearDown ()

تنظيف أي حالات أو ملفات أو بيئات قد تم تغييرها

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

dumpGlobalConfig

protected File dumpGlobalConfig (IConfiguration config, 
                 exclusionPatterns)

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

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

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

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

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` المُنشَر على نحو متسلسل