ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox


واجهة تحدِّد مساحة محاكاة يمكن استخدامها لتشغيل طلب.

ملخّص

الطرق العامة

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

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()

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

الطرق العامة

createClasspath

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 تعرِض قيمة فارغة في حال تعذُّر إنشاء إعدادات مشغِّل التطبيقات المصغّر.

discoverTests

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 لتشغيل الأمر

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

discoverTests

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

المعلمات
context IInvocationContext

configuration IConfiguration

logger ITestLogger

المرتجعات

fetchSandboxExtraArtifacts

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
IOException
BuildRetrievalError
ConfigurationException

getTradefedSandboxEnvironment

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

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

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

prepareEnvironment

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 مع حالة تشغيل وضع الحماية للأمان والسجلات

tearDown

public abstract void tearDown ()

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