ItargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

ज्ञात अप्रत्यक्ष उपवर्ग BaseEmulatorPreparer , BaseTargetPreparer , BuildInfoRecorder , CreateAvdPreparer , CreateUserPreparer , DeviceBuildInfoBootStrapper , DeviceBuildInfoInjector , DeviceCleaner , DeviceFlashPreparer , DeviceImageZipFlashingTargetPreparer , DeviceSetup , DeviceUpdateTargetPreparer , FastbootUpdateBootstrapPreparer , FoldableModePreparer , GkiDeviceFlashPreparer , और 15 अन्य शामिल हैं। बेसएम्यूलेटर प्रिपेरर स्थानीय एमुलेटर लॉन्च करने के लिए सामान्य तैयारी। बेसटार्गेटप्रेपरर के लिए बेस कार्यान्वयन वर्ग ITargetPreparer कि चाहे वस्तु अक्षम किया गया है या नहीं नियंत्रित करने के लिए अनुमति देता है। BuildInfoRecorder एक ITargetPreparer है कि एक निर्दिष्ट फ़ाइल में निर्माण की जानकारी मेटा डेटा लिखता है। CreateAvdPreparer CreateUserPreparer उपयोगकर्ता बनाने और अंत में इसे साफ करने के लिए लक्ष्य तैयार करने वाला। DeviceBuildInfoBootStrapper एक ITargetPreparer कि विशेषताओं के साथ की जगह निर्माण की जानकारी क्षेत्रों डिवाइस से पढ़ यह बाहरी स्रोत से उत्पन्न बिल्ड वाले उपकरणों के परीक्षण के लिए उपयोगी है (जैसे DeviceBuildInfoInjector एक ITargetPreparer कि आवेषण DeviceBuildDescriptor में मेटाडाटा IBuildInfo । डिवाइस क्लीनर परीक्षण के बाद रीबूट या क्लीनअप क्रिया के रूप में प्रारूपित करता है, और वैकल्पिक रूप से स्क्रीन को बंद कर देता है डिवाइसफ्लैशप्रेपरर एक ITargetPreparer कि शारीरिक एंड्रॉयड हार्डवेयर पर एक छवि पाती है। DeviceImageZipFlashingTargetPreparer एक लक्ष्य तैयारकर्ता जो एक विशिष्ट प्रारूप के माध्यम से प्रदान की गई डिवाइस छवियों के साथ डिवाइस को फ्लैश करता है। डिवाइस सेटअप एक ITargetPreparer कि पर उपलब्ध कराई आधारित परीक्षण के लिए एक उपकरण कॉन्फ़िगर Option है। DeviceUpdateTargetPreparer एक सार ITargetPreparer (के रूप में एक निर्माण सेवा के खिलाफ) है कि एक बाहरी स्रोत से एक डिवाइस छवि फ़ाइल के साथ उपकरणों को अद्यतन करने के चारों ओर आम कदम का ख्याल रखता है। FastbootUpdateबूटस्ट्रैप तैयार करने वाला एक ITargetPreparer कि चरणों में निर्दिष्ट फ़ाइलें (बूटलोडर, रेडियो, उपकरण छवि ज़िप) IDeviceBuildInfo उपकरणों के साथ भेजा पाने के लिए FastbootDeviceFlasher , तो injects बाद बूट डिवाइस परिणाम रिपोर्टिंग प्रयोजनों के लिए निर्माण की जानकारी में जिम्मेदार बताते हैं। FoldableModePreparer एक लक्ष्य तैयार करने वाला जो किसी डिवाइस की फोल्डेबल स्थिति को स्विच कर सकता है। GkiDeviceFlashPreparer एक लक्ष्य तैयारकर्ता जो डिवाइस को एंड्रॉइड सामान्य कर्नेल जेनेरिक छवि के साथ फ्लैश करता है। GsiDeviceFlashPreparer एक लक्ष्य तैयार करने वाला जो डिवाइस को एंड्रॉइड जेनेरिक सिस्टम इमेज के साथ फ्लैश करता है। आईटार्गेटक्लीनर यह इंटरफ़ेस बहिष्कृत है। टियरडाउन को आधार ItargetPreparer इंटरफ़ेस में स्थानांतरित कर दिया गया है। इंस्टालएपेक्समॉड्यूलटार्गेटप्रेपरर KillExistingEmulatorPreparer एक ITargetPreparer है कि एक चल एमुलेटर बंद हो जाता है। लोकलएम्युलेटरलॉन्च एक टारगेटप्रेपर जो एक एंड्रॉइड बिल्ड वातावरण से स्थानीय रूप से एक एमुलेटर लॉन्च करता है। स्थानीय एमुलेटर स्नैपशॉट एक एंड्रॉइड बिल्ड/डेवलपमेंट एनवायरनमेंट से एक क्लीन एमुलेटर स्नैपशॉट बनाने के लिए टारगेटप्रेपरर का इरादा है मॉड्यूलOemTargetPreparer रिकवरीलॉगप्रेपरर एक लक्ष्य तैयार करने वाला पुनर्प्राप्ति से पहले लॉग एकत्र करता था। RunCommandTargetPreparer RunOnSecondaryUserTargetPreparer एक ITargetPreparer कि सेटअप में एक माध्यमिक उपयोगकर्ता बनाता है, और वह निशान जो परीक्षण है कि उपयोगकर्ता में चला जाना चाहिए। RunOnSystemUserTargetPreparer एक ITargetPreparer कि कि परीक्षण उपयोगकर्ता (बजाय वर्तमान उपयोगकर्ता) पर चलाया जाना चाहिए अंक। RunOnWorkProfileTargetPreparer एक ITargetPreparer कि सेटअप में कार्य प्रोफ़ाइल बनाता है, और वह निशान जो परीक्षण है कि उपयोगकर्ता में चला जाना चाहिए। StubTargetPreparer एक के खाली कार्यान्वयन प्लेसहोल्डर ITargetPreparer । सुइटएपीकेइंस्टॉलर सुइट कॉन्फ़िगरेशन के लिए निर्दिष्ट APK स्थापित करता है: या तो $ANDROID_TARGET_OUT_TESTCASES चर से या बिल्ड जानकारी में ROOT_DIR से। TestAppInstallSetup एक ITargetPreparer है कि एक से एक या अधिक एप्लिकेशन को स्थापित करता है IDeviceBuildInfo.getTestsDir() डिवाइस पर फ़ोल्डर।

---

परीक्षण चलाने के लिए परीक्षण वातावरण तैयार करता है।

उदाहरण के लिए, सॉफ़्टवेयर स्थापित करना, परीक्षण के लिए env सेटिंग्स में बदलाव करना, लक्ष्य लॉन्च करना आदि।

ध्यान दें कि कई ITargetPreparer एक विन्यास में निर्दिष्ट किया जा सकता। यह अनुशंसा की जाती है कि प्रत्येक ItargetPreparer अपने अपेक्षित परिवेश पूर्व-सेटअप और पोस्ट-सेटअप को स्पष्ट रूप से प्रलेखित करे। उदाहरण के लिए एक आईटारगेटप्रेपरर जो परीक्षण के लिए एक डिवाइस को कॉन्फ़िगर करता है, उसे सॉफ्टवेयर स्थापित करने वाले आईटारगेटप्रेपरर के बाद चलाया जाना चाहिए।

सारांश

सार्वजनिक तरीके
default void	setUp (ITestDevice device, IBuildInfo buildInfo) यह विधि बहिष्कृत है। उपयोग setUp(com.android.tradefed.invoker.TestInformation) के बजाय
default void	setUp (TestInformation testInformation) परीक्षण के लिए लक्ष्य सेटअप करें।
default void	tearDown (TestInformation testInformation, Throwable e) परीक्षण के बाद लक्ष्य क्लीनअप/टियरडाउन करें।
default void	tearDown (ITestDevice device, IBuildInfo buildInfo, Throwable e) यह विधि बहिष्कृत है। उपयोग tearDown(com.android.tradefed.invoker.TestInformation, Throwable) के बजाय

सार्वजनिक तरीके

सेट अप

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

यह विधि बहिष्कृत है।
उपयोग setUp(com.android.tradefed.invoker.TestInformation) के बजाय

परीक्षण के लिए लक्ष्य सेटअप करें।

मापदंडों
device	ITestDevice : ITestDevice तैयार करने के लिए।
buildInfo	IBuildInfo : परीक्षण के अंतर्गत निर्माण के बारे में डेटा।

फेंकता
TargetSetupError	यदि पर्यावरण की स्थापना में घातक त्रुटि हुई है
BuildError	यदि BuildInfo से संबंधित कोई त्रुटि होती है
DeviceNotAvailableException	अगर डिवाइस अनुत्तरदायी हो गया

सेट अप

public void setUp (TestInformation testInformation)

परीक्षण के लिए लक्ष्य सेटअप करें।

मापदंडों
testInformation	TestInformation : TestInformation मंगलाचरण की।

फेंकता
TargetSetupError	यदि पर्यावरण की स्थापना में घातक त्रुटि हुई है
BuildError	यदि बिल्ड तैयार होने के कारण कोई त्रुटि होती है
DeviceNotAvailableException	अगर डिवाइस अनुत्तरदायी हो गया

चीथड़े कर दो

public void tearDown (TestInformation testInformation, 
                Throwable e)

परीक्षण के बाद लक्ष्य क्लीनअप/टियरडाउन करें।

मापदंडों
testInformation	TestInformation : TestInformation मंगलाचरण की।
e	Throwable : अगर मंगलाचरण एक अपवाद के साथ समाप्त हुआ, इस अपवाद है कि प्रार्थना के स्तर पर पकड़ा गया था हो जाएगा। अन्यथा, हो जाएगा null ।

फेंकता
DeviceNotAvailableException	अगर डिवाइस अनुत्तरदायी हो गया

चीथड़े कर दो

public void tearDown (ITestDevice device, 
                IBuildInfo buildInfo, 
                Throwable e)

यह विधि बहिष्कृत है।
उपयोग tearDown(com.android.tradefed.invoker.TestInformation, Throwable) के बजाय

परीक्षण के बाद लक्ष्य क्लीनअप/टियरडाउन करें।

मापदंडों
device	ITestDevice : ITestDevice तैयार करने के लिए।
buildInfo	IBuildInfo : परीक्षण के अंतर्गत निर्माण के बारे में डेटा।
e	Throwable : अगर मंगलाचरण एक अपवाद के साथ समाप्त हुआ, इस अपवाद है कि प्रार्थना के स्तर पर पकड़ा गया था हो जाएगा। अन्यथा, हो जाएगा null ।

फेंकता
DeviceNotAvailableException	अगर डिवाइस अनुत्तरदायी हो गया