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

وضع الحماية

public interface ISandbox

com.android.tradefed.sandbox.ISandbox

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

TradefedSandbox حاوية Sandbox يمكنها تشغيل استدعاء اتحاد تجاري.

واجهة تحدّد وضع حماية يمكن استخدامه لتشغيل استدعاء.

ملخّص

الطرق العامة
`abstract String`	`createClasspath(File workingDir)` يمكنك إنشاء مسار فئة استنادًا إلى البيئة ودليل العمل الذي يعرضه `getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, String[])`.
`abstract IConfiguration`	`createThinLauncherConfig(String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)` الوضع الخاص غير متصل للتشغيل الرئيسي: عندما يبدو أن هناك تهيئة غير موجودة في الأصل، ننتقل إلى مشغّل التطبيقات المصغّرة حيث نحاول إعداد وضع الحماية باستخدام معلومات معروفة واملأ دليل العمل لإنشاء الإعداد بالكامل في الإصدار الحالي.
`default`	`discoverTests(IInvocationContext context, IConfiguration configuration)` هي خطوة فرعية من `prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener)` ترصد الاختبارات في حال تفعيل `SandboxOptions.shouldUseTestDiscovery()`.
`default`	`discoverTests(IInvocationContext context, IConfiguration configuration, ITestLogger logger)`
`default IFolderBuildInfo`	`fetchSandboxExtraArtifacts(IInvocationContext context, IConfiguration configuration, String[] args)` خطوة فرعية من `prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener)` والتي تجلب الملفات الإضافية اللازمة لوضع الحماية.
`default File`	`getTradefedSandboxEnvironment(IInvocationContext context, IConfiguration nonVersionedConfig, String[] args)` تعرض TF في بيئة Sandbox المطلوب استخدامها استنادًا إلى وسيطات سطر الأوامر.
`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()` احذف أي حالات أو ملفات أو بيئة ربما تم تغييرها.

الطرق العامة

إنشاء مسار صف

public abstract String createClasspath (File workingDir)

يمكنك إنشاء مسار فئة استنادًا إلى البيئة ودليل العمل الذي يعرضه getTradefedSandboxEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.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. الركلات المردودة فارغ في حال عدم التمكن من إنشاء إعداد مشغّل تطبيقات رفيعة المستوى.

اختبارات

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration)

هي خطوة فرعية من prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) ترصد الاختبارات في حال تفعيل SandboxOptions.shouldUseTestDiscovery().

المعلمات
`context`	`IInvocationContext`: الاستدعاء الحالي `IInvocationContext`
`configuration`	`IConfiguration`: السمة `IConfiguration` المطلوبة لتشغيل الأمر.

المرتجعات
	خريطة الاختبارات المكتشفة أو تكون فارغة إذا لم تكن متوافقة أو لم تنجح.

اختبارات

public  discoverTests (IInvocationContext context, 
                IConfiguration configuration, 
                ITestLogger logger)

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

المرتجعات

استرجاع عناصر التحكّم في وضع الحماية

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

خطوة فرعية من prepareEnvironment(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.config.IConfiguration, com.android.tradefed.result.ITestInvocationListener) والتي تجلب الملفات الإضافية اللازمة لوضع الحماية.

المعلمات
`context`	`IInvocationContext`: الاستدعاء الحالي `IInvocationContext`
`configuration`	`IConfiguration`: السمة `IConfiguration` المطلوبة لتشغيل الأمر.
`args`	`String`: وسيطات سطر الأوامر

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

الرميات
	com.android.tradefed.build.BuildRetrievalError:
	com.android.tradefed.config.ConfigurationException
	IOاستثناء
`BuildRetrievalError`
`ConfigurationException`

getTradefedSandboxEnvironment

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

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

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

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

getTradefedSandboxEnvironment

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

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

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

إعداد البيئة

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

قم بتهيئة البيئة لتشغيل وضع الحماية بشكل صحيح.

المعلمات
`context`	`IInvocationContext`: الاستدعاء الحالي `IInvocationContext`
`configuration`	`IConfiguration`: السمة `IConfiguration` المطلوبة لتشغيل الأمر.
`listener`	`ITestInvocationListener`: الاستدعاء الحالي `ITestInvocationListener` حيث تظهر النتائج النهائية الممرات.

المرتجعات
`Exception`	`Exception` تحتوي على الخطأ. أو Null إذا كانت ناجحة.

ضربة طويلة

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

يمكنك تشغيل وضع الحماية باستخدام البيئة التي تم ضبطها.

المعلمات
`info`	`TestInformation`: `TestInformation` الذي يصف الاستدعاء
`configuration`	`IConfiguration`: السمة `IConfiguration` المطلوبة لتشغيل الأمر.
`logger`	`ITestLogger`: `ITestLogger` حيث يمكننا تسجيل الملفات.

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

قطع

public abstract void tearDown ()

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