ISandbox

public interface ISandbox

com.android.tradefed.sandbox.ISandbox


একটি স্যান্ডবক্স নির্ধারণকারী ইন্টারফেস যা কোনো ইনভোকেশন চালানোর জন্য ব্যবহার করা যেতে পারে।

সারসংক্ষেপ

জনসাধারণের পদ্ধতি

abstract String createClasspath (File workingDir)

getTradefedSandboxEnvironment(IInvocationContext,IConfiguration,String[]) দ্বারা ফেরত আসা এনভায়রনমেন্ট এবং ওয়ার্কিং ডিরেক্টরির উপর ভিত্তি করে একটি ক্লাসপাথ তৈরি করুন।

abstract IConfiguration createThinLauncherConfig (String[] args, IKeyStoreClient keyStoreClient, IRunUtil runUtil, File globalConfig)

মূল রান থেকে বিশেষ মোড বিচ্ছিন্ন: যখন কোনো কনফিগারেশন প্যারেন্টে বিদ্যমান বলে মনে হয় না, তখন আমরা থিন লঞ্চারে ফিরে যাই, যেখানে আমরা বর্তমানে জানা তথ্য দিয়ে স্যান্ডবক্স সেটআপ করার চেষ্টা করি এবং ভার্সনযুক্ত ডিরেক্টরিতে কনফিগারেশনটি সম্পূর্ণরূপে তৈরি করার জন্য ওয়ার্কিং ডিরেক্টরি পূরণ করি।

default Map<String, List<String>> discoverTests ( IInvocationContext context, IConfiguration configuration)

prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) এর একটি উপ-ধাপ, যা SandboxOptions.shouldUseTestDiscovery() সক্রিয় থাকলে টেস্টগুলি খুঁজে বের করে।

default Map<String, List<String>> discoverTests ( IInvocationContext context, IConfiguration configuration, ITestLogger logger)
default IFolderBuildInfo fetchSandboxExtraArtifacts ( IInvocationContext context, IConfiguration configuration, String[] args)

prepareEnvironment(IInvocationContext,IConfiguration,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 ()

পরিবর্তিত হয়ে থাকতে পারে এমন যেকোনো স্টেট, ফাইল বা এনভায়রনমেন্ট পরিষ্কার করুন।

জনসাধারণের পদ্ধতি

ক্লাস পাথ তৈরি করুন

public abstract String createClasspath (File workingDir)

getTradefedSandboxEnvironment(IInvocationContext,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 একটি ফাইল যা নন-ভার্সনড অবজেক্টগুলোর জন্য টিএফ-এর কনফিগারেশন এক্সএমএল নির্দেশ করে। যদি কোনো থিন লঞ্চার কনফিগারেশন তৈরি করা না যায়, তবে এটি নাল রিটার্ন করে।

ডিসকভারটেস্টস

public Map<String, List<String>> discoverTests (IInvocationContext context, 
                IConfiguration configuration)

prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) এর একটি উপ-ধাপ, যা SandboxOptions.shouldUseTestDiscovery() সক্রিয় থাকলে টেস্টগুলি খুঁজে বের করে।

প্যারামিটার
context IInvocationContext : বর্তমান আহ্বান IInvocationContext .

configuration IConfiguration : যে কমান্ডটি চালানো হবে তার IConfiguration

ফেরত
Map<String, List<String>> আবিষ্কৃত পরীক্ষাগুলোর মানচিত্র, অথবা অসমর্থিত বা ব্যর্থ হলে নাল।

ডিসকভারটেস্টস

public Map<String, List<String>> discoverTests (IInvocationContext context, 
                IConfiguration configuration, 
                ITestLogger logger)

প্যারামিটার
context IInvocationContext

configuration IConfiguration

logger ITestLogger

ফেরত
Map<String, List<String>>

ফেচস্যান্ডবক্সএক্সট্রাআর্টিফ্যাক্টস

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

prepareEnvironment(IInvocationContext,IConfiguration,ITestInvocationListener) এর একটি উপ-ধাপ, যা স্যান্ডবক্সের জন্য প্রয়োজনীয় অতিরিক্ত ফাইলগুলো সংগ্রহ করে।

প্যারামিটার
context IInvocationContext : বর্তমান আহ্বান IInvocationContext .

configuration IConfiguration : যে কমান্ডটি চালানো হবে তার IConfiguration

args String : কমান্ড লাইন আর্গুমেন্টসমূহ।

ফেরত
IFolderBuildInfo অতিরিক্ত স্যান্ডবক্স করা ফাইলগুলির জন্য আনা বিল্ড।

নিক্ষেপ
com.android.tradefed.build.BuildRetrievalError
com.android.tradefed.config.ConfigurationException
java.io.IOException
BuildRetrievalError
ConfigurationException
IOException

getTradefedSandboxEnvironment

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

কমান্ড লাইন আর্গুমেন্টের উপর ভিত্তি করে ব্যবহারযোগ্য স্যান্ডবক্স এনভায়রনমেন্ট TF ফেরত দেয়।

প্যারামিটার
context IInvocationContext : প্যারেন্টের IInvocationContext

nonVersionedConfig IConfiguration : যে IConfiguration ভার্সনবিহীন অবজেক্টগুলোকে উপস্থাপন করে।

args String : কমান্ড লাইন আর্গুমেন্টসমূহ।

ফেরত
File একটি File ডিরেক্টরি যেখানে TF স্যান্ডবক্স এনভায়রনমেন্টের জার ফাইলগুলো থাকে।

নিক্ষেপ
Exception

getTradefedSandboxEnvironment

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

প্যারামিটার
context IInvocationContext

nonVersionedConfig IConfiguration

logger ITestLogger

args String

ফেরত
File

নিক্ষেপ
Exception

পরিবেশ প্রস্তুত করুন

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

নিক্ষেপ
Throwable

ভেঙে ফেলা

public abstract void tearDown ()

পরিবর্তিত হয়ে থাকতে পারে এমন যেকোনো স্টেট, ফাইল বা এনভায়রনমেন্ট পরিষ্কার করুন।