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
IOEException
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

PreparEnvironment

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

قم بإعداد البيئة اللازمة لوضع الحماية لكي يعمل بشكل صحيح.

حدود
context IInvocationContext : الاستدعاء الحالي IInvocationContext .

configuration IConfiguration : IConfiguration للأمر المطلوب تشغيله.

listener ITestInvocationListener : الاستدعاء الحالي ITestInvocationListener حيث يجب إرسال النتائج النهائية.

عائدات
Exception Exception يحتوي على الفشل. أو فارغة إذا نجحت.

يجري

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

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