ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

ऐसे सबक्लास जिनके बारे में पहले से पता है AdbStopServerPreparer, AllTestAppsInstallSetup, AoaTargetPreparer, AppSetup, ArtChrootPreparer, BaseEmulatorPreparer, BaseTargetPreparer, BuildInfoRecorder, CheckPairingPreparer, CompanionAllocator, CompanionAwarePreparer, CompanionRunCommandTargetPreparer, CompanionTestAppInstallSetup, CompileBootImageWithSpeedTargetPreparer, CpuThrottlingWaiter, और 76 अन्य. AdbStopServerPreparer adb टेस्ट चलाने से पहले और बाद में, होस्ट पर adb सर्वर को रोकने के लिए टारगेट तैयार करने वाला टूल.  AllTestAppsInstallSetup ऐसा ITargetPreparer जो डिवाइस पर IDeviceBuildInfo.getTestsDir() फ़ोल्डर से सभी ऐप्लिकेशन इंस्टॉल करता है.  AoaTargetPreparer ITargetPreparer, जो Android Open Accessory (AOAv2) प्रोटोकॉल का इस्तेमाल करके, कई कार्रवाइयां करता है. जैसे, क्लिक और स्वाइप.  AppSetup ऐसा ITargetPreparer जो APK और उसके टेस्ट इंस्टॉल करता है.  ArtChrootPreparer ART टेस्ट के लिए chroot डायरेक्ट्री बनाएं.  BaseEmulatorPreparer स्थानीय एम्युलेटर लॉन्च करने के लिए, सामान्य प्रिपरर.  BaseTargetPreparer ITargetPreparer के लिए, लागू करने की बुनियादी क्लास. इससे यह कंट्रोल किया जा सकता है कि ऑब्जेक्ट बंद है या नहीं.  BuildInfoRecorder ऐसा ITargetPreparer जो किसी खास फ़ाइल में, बिल्ड की जानकारी का मेटाडेटा लिखता है.  CheckPairingPreparer CompanionAwarePreparer, जो प्राइमरी और साथी डिवाइसों के बीच बीटी बॉन्डिंग की पुष्टि करता है  CompanionAllocator बेस क्लास, जो साथी डिवाइस को असाइन और खाली करने की सुविधा देती है कंपैनियन डिवाइस को असाइन करने के लिए ज़रूरी शर्तों के बारे में बताने के लिए, getCompanionDeviceSelectionOptions() को लागू किया जाना चाहिए  CompanionAwarePreparer एक ITargetPreparer, जो पहले से तय किए गए साथी डिवाइस को पाने के लॉजिक को शामिल करता है.  CompanionRunCommandTargetPreparer ऐसा ITargetPreparer जो असाइन किए गए साथी डिवाइस पर तय किए गए निर्देशों को चलाता है  CompanionTestAppInstallSetup ऐसा ITargetPreparer जो किसी डिवाइस के लिए असाइन किए गए साथी डिवाइस पर, IDeviceBuildInfo.getTestsDir() फ़ोल्डर से एक या उससे ज़्यादा ऐप्लिकेशन इंस्टॉल करता है.  CompileBootImageWithSpeedTargetPreparer कंपाइलर फ़िल्टर 'speed' की मदद से, बूट क्लासपाथ और सिस्टम सर्वर को फिर से कंपाइल करता है.  CpuThrottlingWaiter एक ITargetPreparer जो तब तक इंतज़ार करता है, जब तक सभी कोर पर ज़्यादा से ज़्यादा फ़्रीक्वेंसी, उपलब्ध सबसे ऊंचे लेवल पर वापस नहीं आ जाती  CreateAvdPreparer   CreateUserPreparer उपयोगकर्ता बनाने और आखिर में उसे हटाने के लिए टारगेट तैयार करने वाला टूल.  DeviceActionTargetPreparer डिवाइस की कार्रवाइयां करने के लिए ITargetPreparer.  DeviceBuildInfoBootStrapper ऐसा ITargetPreparer जो डिवाइस से पढ़े गए एट्रिब्यूट के साथ, बिल्ड की जानकारी वाले फ़ील्ड को बदलता है यह किसी बाहरी सोर्स से जनरेट किए गए बिल्ड वाले डिवाइसों की जांच करने के लिए मददगार है. उदाहरण के लिए,  DeviceBuildInfoInjector ऐसा ITargetPreparer जो IBuildInfo में DeviceBuildDescriptor मेटाडेटा डालता है.  DeviceCleaner टेस्ट के बाद, क्लीनअप ऐक्शन के तौर पर रीबूट या फ़ॉर्मैट करता है. साथ ही, स्क्रीन को बंद भी कर सकता है  DeviceFlashPreparer एक ITargetPreparer, जो Android के फ़िज़िकल हार्डवेयर पर इमेज दिखाता है.  DeviceImageZipFlashingTargetPreparer टारगेट तैयार करने वाला टूल, जो किसी खास फ़ॉर्मैट में दी गई डिवाइस इमेज के साथ डिवाइस को फ़्लैश करता है.  DeviceOwnerTargetPreparer डिवाइस के मालिक का कॉम्पोनेंट सेट अप करने वाला ITargetPreparer.  DeviceSetup ऐसा ITargetPreparer जो दिए गए Option के आधार पर, टेस्टिंग के लिए डिवाइस को कॉन्फ़िगर करता है.  DeviceStorageFiller स्टोरेज भरने के लिए टारगेट तैयार करें, ताकि कुछ खाली जगह उपलब्ध हो.  DeviceStringPusher टारगेट तैयार करने वाला, किसी फ़ाइल में स्ट्रिंग लिखता है.  DeviceUpdateTargetPreparer एक एब्स्ट्रैक्ट ITargetPreparer, जो डिवाइसों को अपडेट करने के सामान्य चरणों को ध्यान में रखता है. इसके लिए, डिवाइस इमेज फ़ाइल को किसी बाहरी सोर्स से लिया जाता है, न कि बिल्ड सेवा से.  DeviceWiper उपयोगकर्ता डेटा को मिटाने वाला ITargetPreparer  DisableSELinuxTargetPreparer टारगेट तैयार करने वाला ऐसा टूल जो चालू होने पर SELinux को बंद कर देता है.  DynamicSystemPreparer एक ITargetPreparer, जो डाइनैमिक सिस्टम अपडेट की मदद से डिवाइस के बिल्ड के ऊपर सिस्टम इमेज सेट अप करता है.  EraseUserDataPreparer ऐसा ITargetPreparer जो डिवाइस पर उपयोगकर्ता का डेटा मिटाता है.  FastbootCommandPreparer टारगेट तैयार करने वाला टूल, जो fastboot को ट्रिगर करता है और fastboot निर्देश भेजता है.  FastbootUpdateBootstrapPreparer ऐसा ITargetPreparer जो FastbootDeviceFlasher से फ़्लैश किए गए डिवाइसों को पाने के लिए, चुनिंदा फ़ाइलों (बूटलोडर, रेडियो, डिवाइस इमेज ज़िप) को IDeviceBuildInfo में स्टेशन करता है. इसके बाद, नतीजे की रिपोर्टिंग के मकसद से, बिल्ड की जानकारी में डिवाइस के पोस्ट-बूट एट्रिब्यूट इंजेक्ट करता है.  FeatureFlagTargetPreparer DeviceConfig को अपडेट करता है (रिमोट सेवा की मदद से ट्यून किए गए सुविधा फ़्लैग).  FoldableModePreparer टारगेट तैयार करने वाला टूल, जो किसी डिवाइस की फ़ोल्ड करने की स्थिति को स्विच कर सकता है.  FolderSaver एक ITargetPreparer जो डिवाइस से डायरेक्ट्री खींचता है, उसे संपीड़ित करता है, और लॉगिंग बैकएंड में सेव करता है.  GkiDeviceFlashPreparer एक टारगेट तैयार करने वाला टूल, जो डिवाइस को Android के सामान्य कर्नेल की जेनरिक इमेज से फ़्लैश करता है.  GsiDeviceFlashPreparer टारगेट तैयार करने वाला टूल, जो डिवाइस को Android के लिए सामान्य सिस्टम इमेज से फ़्लैश करता है.  ILabPreparer लैब तैयार करने वाले लोगों के लिए मार्कर इंटरफ़ेस इन इंटरफ़ेस के मकसद के बारे में जानने के लिए, ITargetPreparer देखें.  ITargetCleaner यह इंटरफ़ेस अब काम नहीं करता. tearDown को बेस ITargetPreparer इंटरफ़ेस में ले जाया गया है.  InstallAllTestZipAppsSetup एक ITargetPreparer, जो टेस्टिंग के लिए बनाए गए zip में मौजूद सभी ऐप्लिकेशन इंस्टॉल करता है.  InstallApexModuleTargetPreparer   InstallApkSetup एक ITargetPreparer, जो फ़ाइल सिस्टम पर मौजूद एक या उससे ज़्यादा APK इंस्टॉल करता है.  InstallBuildEnvApkSetup ऐसा ITargetPreparer जो Android प्लैटफ़ॉर्म के बिल्ड एनवायरमेंट से एक या एक से ज़्यादा टेस्ट APK इंस्टॉल करता है.  InstallKernelModulePreparer टारगेट तैयार करने वाला टूल, जो कर्नेल मॉड्यूल इंस्टॉल करता है.  InstrumentationPreparer ऐसा ITargetPreparer जो इंस्ट्रुमेंटेशन चलाता है  KillExistingEmulatorPreparer ITargetPreparer, जो चल रहे एम्युलेटर को बंद कर देता है.  KnownFailurePreparer टारगेट तैयार करने वाले को, पहले से मौजूद गड़बड़ी को फिर से आज़माने से रोकना.  LocalEmulatorLaunch TargetPreparer, जो Android बिल्ड एनवायरमेंट से स्थानीय तौर पर एमुलेटर लॉन्च करता है.  LocalEmulatorSnapshot TargetPreparer, Android के बिल्ड/डेवलपमेंट एनवायरमेंट से, एमुलेटर का क्लीन स्नैपशॉट जनरेट करने के लिए है  MixKernelTargetPreparer एक ITargetPreparer, जो डिवाइस इमेज के साथ कर्नेल इमेज को मिक्स करने की अनुमति देता है.  ModuleOemTargetPreparer   NativeLeakCollector एक ITargetPreparer, जो 'dumpsys meminfo --unreachable -a' चलाता है, ताकि हर प्रोसेस के पास मौजूद, ऐक्सेस न की जा सकने वाली नेटिव मेमोरी की पहचान की जा सके.  NoApkTestSkipper यह एक खास प्रिपरर है, जो टेस्ट करने के लिए कोई APK न होने पर, कॉल को पूरी तरह से स्किप करने की अनुमति देता है.  PerfettoPreparer Perfetto preparer, डिवाइस में कॉन्फ़िगरेशन फ़ाइल को स्टैंडर्ड जगह पर डालता है. इस जगह का ऐक्सेस, Perfetto के पास होता है.  ProfileTargetPreparer किसी भी प्रोफ़ाइल उपयोगकर्ता android.os.usertype.profile.XXX के लिए, टारगेट तैयार करने वाले टूल को सेट अप करने के लिए बुनियादी क्लास.  PushFileInvoker इस क्लास का इस्तेमाल नहीं किया जा सकता. इसके बजाय, PushFilePreparer का इस्तेमाल करें  PushFilePreparer ऐसा ITargetPreparer जो किसी भी होस्ट पाथ से किसी भी डिवाइस पाथ पर, किसी भी संख्या में फ़ाइलें पुश करने की कोशिश करता है.  PythonVirtualenvPreparer यह होस्ट पर Python virtualenv सेट अप करता है और पैकेज इंस्टॉल करता है.  RebootTargetPreparer डिवाइस को रीबूट करने वाला टारगेट तैयार करने वाला टूल.  RecoveryLogPreparer टारगेट तैयार करने वाला टूल, रिकवरी से पहले लॉग इकट्ठा करता है.  RemoveSystemAppPreparer टेस्ट रन से पहले, सिस्टम पार्टीशन से किसी APK को हटाने के लिए ITargetPreparer.  RestartSystemServerTargetPreparer टारगेट तैयार करने वाला टूल, जो डिवाइस को रीबूट किए बिना सिस्टम सर्वर को रीस्टार्ट करता है.  RootTargetPreparer टारगेट तैयार करने वाला टूल, जो "force-root" विकल्प के आधार पर "adb root" या "adb unroot" करता है.  RootcanalForwarderPreparer   RunCommandTargetPreparer   RunHostCommandTargetPreparer टेस्ट चलाने से पहले और बाद में, होस्ट के मनमुताबिक निर्देश चलाने के लिए, टारगेट तैयार करने वाला टूल.  RunHostScriptTargetPreparer टारगेट तैयार करने वाला टूल, जो टेस्ट चलाने से पहले स्क्रिप्ट को एक्ज़ीक्यूट करता है.  RunOnCloneProfileTargetPreparer   RunOnPrivateProfileTargetPreparer   RunOnSdkSandboxTargetPreparer ITargetPreparer, यह मार्क करता है कि टेस्ट को SDK टूल के सैंडबॉक्स में चलाया जाना चाहिए.  RunOnSecondaryUserTargetPreparer ITargetPreparer, ताकि यह पक्का किया जा सके कि टेस्ट, सेकंडरी उपयोगकर्ता के तौर पर चल रहा है.  RunOnSystemUserTargetPreparer ITargetPreparer, जो यह मार्क करता है कि जांच, मौजूदा उपयोगकर्ता के बजाय उपयोगकर्ता पर की जानी चाहिए.  RunOnWorkProfileTargetPreparer एक ITargetPreparer, जो सेटअप में वर्क प्रोफ़ाइल बनाता है और यह मार्क करता है कि टेस्ट उस उपयोगकर्ता में चलाए जाने चाहिए.  SemaphoreTokenTargetPreparer यह एक ऐसा तैयार करने वाला टूल है जिसका इस्तेमाल, tradefed होस्ट में टेस्ट एक्सीक्यूशन को सीरियलाइज़ करने के लिए टोकन का इस्तेमाल करने के लिए किया जाता है.  SideloadOtaTargetPreparer यह एक टारगेट तैयार करने वाला टूल है, जो किसी खास ओटीए पैकेज को साइडलोड करता है, पैकेज को लागू करता है, डिवाइस के बूट होने का इंतज़ार करता है, और डिवाइस की बिल्ड प्रॉपर्टी को इंजेक्ट करता है, ताकि उन्हें बिल्ड की जानकारी के तौर पर इस्तेमाल किया जा सके यह टारगेट तैयार करने वाला टूल यह मानता है कि डिवाइस शुरू होने पर, वह सामान्य adb मोड में होगा. साथ ही, यह पक्का करेगा कि डिवाइस उसी मोड में बंद हो, लेकिन उस पर नया बिल्ड लागू हो.  StopServicesSetup ऐसा ITargetPreparer जो डिवाइस पर सेवाएं बंद कर देता है.  StubTargetPreparer ITargetPreparer के लिए प्लेसहोल्डर का खाली वर्शन.  SuiteApkInstaller यह सुइट कॉन्फ़िगरेशन के लिए, बताए गए APK इंस्टॉल करता है: $ANDROID_TARGET_OUT_TESTCASES वैरिएबल से या बिल्ड की जानकारी में मौजूद ROOT_DIR से.  SwitchUserTargetPreparer एक ITargetPreparer, जो सेटअप में बताए गए उपयोगकर्ता टाइप पर स्विच करता है.  TearDownPassThroughPreparer यह उन प्रिपरर पर tearDown चलाने की अनुमति देता है जिन्हें कॉन्फ़िगरेशन में ऑब्जेक्ट के तौर पर शामिल किया गया है.  TemperatureThrottlingWaiter ऐसा ITargetPreparer जो डिवाइस के तापमान के टारगेट पर पहुंचने तक इंतज़ार करता है  TestAppInstallSetup ऐसा ITargetPreparer जो डिवाइस पर IDeviceBuildInfo.getTestsDir() फ़ोल्डर से एक या उससे ज़्यादा ऐप्लिकेशन इंस्टॉल करता है.  TestFilePushSetup ऐसा ITargetPreparer जो IDeviceBuildInfo.getTestsDir() फ़ोल्डर से एक या उससे ज़्यादा फ़ाइलों/डायरेक्ट्री को डिवाइस पर पुश करता है.  TestSystemAppInstallSetup ऐसा ITargetPreparer जो डिवाइस के /system पार्टीशन पर, IDeviceBuildInfo.getTestsDir() फ़ोल्डर से एक या उससे ज़्यादा ऐप्लिकेशन इंस्टॉल करता है.  TimeWaster समय बर्बाद करने और डिवाइस को रीस्टार्ट करने के लिए, टारगेट तैयार करने वाला एक आसान टूल.  UserCleaner ऐसा ITargetPreparer जो टियरडाउन के दौरान सेकंडरी उपयोगकर्ताओं को हटा देता है.  VisibleBackgroundUserPreparer बैकग्राउंड में दिखने वाले उपयोगकर्ता में टेस्ट चलाने के लिए टारगेट तैयार करने वाला टूल.  WaitForDeviceDatetimePreparer ऐसा ITargetPreparer जो डिवाइस पर तारीख और समय सेट होने का इंतज़ार करता है अगर टाइम आउट के अंदर तारीख और समय सेट नहीं किया जाता है, तो यह प्रिपरर TargetSetupError को ज़बरदस्ती लागू कर सकता है.  WifiPreparer ITargetPreparer, जो ज़रूरत पड़ने पर डिवाइस पर वाई-फ़ाई कॉन्फ़िगर करता है.

---

टेस्ट रन के लिए टेस्ट एनवायरमेंट तैयार करता है.

उदाहरण के लिए, सॉफ़्टवेयर इंस्टॉल करना, टेस्टिंग के लिए एनवायरमेंट सेटिंग में बदलाव करना, टारगेट लॉन्च करना वगैरह.

ध्यान दें कि किसी कॉन्फ़िगरेशन में एक से ज़्यादा ITargetPreparer तय किए जा सकते हैं. हमारा सुझाव है कि हर ITargetPreparer, सेटअप से पहले और सेटअप के बाद के अपने अनुमानित एनवायरमेंट को साफ़ तौर पर दस्तावेज़ में लिखे. उदाहरण के लिए, टेस्टिंग के लिए डिवाइस को कॉन्फ़िगर करने वाले 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) का इस्तेमाल करें

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

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

यह तरीका अब काम नहीं करता.
इसके बजाय, setUp(com.android.tradefed.invoker.TestInformation) का इस्तेमाल करें

जांच के लिए टारगेट सेटअप करें.

पैरामीटर
device	ITestDevice: ITestDevice को तैयार करना है.
buildInfo	IBuildInfo: टेस्ट किए जा रहे वर्शन का डेटा.

थ्रो
TargetSetupError	if fatal error occurred setting up environment
BuildError	अगर BuildInfo से जुड़ी कोई गड़बड़ी होती है
DeviceNotAvailableException	अगर डिवाइस काम नहीं कर रहा है

setUp

public void setUp (TestInformation testInformation)

जांच के लिए टारगेट सेटअप करें.

पैरामीटर
testInformation	TestInformation: TestInformation का इस्तेमाल करके, टास्क को शुरू किया जाता है.

थ्रो
TargetSetupError	if fatal error occurred setting up environment
BuildError	अगर बिल्ड तैयार होने की वजह से कोई गड़बड़ी होती है
DeviceNotAvailableException	अगर डिवाइस काम नहीं कर रहा है

tearDown

public void tearDown (TestInformation testInformation, 
                Throwable e)

जांच करने के बाद, टारगेट का क्लीनअप/टियरडाउन करें.

पैरामीटर
testInformation	TestInformation: TestInformation का इस्तेमाल करके, टास्क को शुरू किया जाता है.
e	Throwable: अगर कॉल को किसी अपवाद के साथ पूरा किया गया है, तो यह वह अपवाद होगा जो कॉल के लेवल पर पकड़ा गया था. ऐसा न करने पर, यह null होगा.

थ्रो
DeviceNotAvailableException	अगर डिवाइस काम नहीं कर रहा है

tearDown

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	अगर डिवाइस काम नहीं कर रहा है