सिस्टम की स्थिति देखें

सिस्टम स्टेटस चेकर (एसएससी), सुइट-लेवल कॉन्फ़िगरेशन में तय किए जाते हैं और हर मॉड्यूल के बीच चलाए जाते हैं. ये जांच करते हैं कि मॉड्यूल में बदलाव हुआ है या नहीं और क्या उसने कुछ दी गई स्थितियों को वापस नहीं लाया है. उदाहरण के लिए, सिस्टम प्रॉपर्टी की वैल्यू बदलना.

एसएससी का इस्तेमाल मुख्य रूप से यह पक्का करने के लिए किया जाता है कि मॉड्यूल लिखने वाले लोग, टेस्ट के बाद क्लीन अप करना न भूलें. अगर ऐसा होता है, तो इसका पता लगाने के लिए एसएससी का इस्तेमाल किया जाता है, ताकि समस्या को ठीक किया जा सके.

इस सुविधा का दूसरा इस्तेमाल, डिवाइस को उसकी मूल स्थिति में वापस लाना है. उदाहरण के लिए, अगर कीगार्ड खुला है, तो उसे बंद करना.

सिस्टम की स्थिति की जांच करने वाले टूल की एक्सएमएल परिभाषा

<system_checker class="com.android.tradefed.suite.checker.KeyguardStatusChecker" />
<system_checker class="com.android.tradefed.suite.checker.LeakedThreadStatusChecker" />
<system_checker class="com.android.tradefed.suite.checker.SystemServerStatusChecker" />

एसएससी, Tradefed कॉन्फ़िगरेशन के एक्सएमएल में system_checker टैग के तहत तय किए जाते हैं.

लागू करना

हर एसएससी को ISystemStatusChecker इंटरफ़ेस लागू करना होगा. यह दो मुख्य तरीके preExecutionCheck और postExecutionCheck उपलब्ध कराता है, जो हर मॉड्यूल के लागू होने से पहले और बाद में चलते हैं.

चेकर, इनमें से सिर्फ़ एक को लागू कर सकता है. अगर मॉड्यूल से पहले की स्थिति की जांच करके, उसे मॉड्यूल के बाद की स्थिति से तुलना करने की ज़रूरत है, तो दोनों को लागू किया जा सकता है.

Tradefed में, लागू करने के कई उदाहरण मौजूद हैं. हमारा सुझाव है कि हर बार लागू करने के लिए, एक ही जांच पर फ़ोकस करें, ताकि फिर से इस्तेमाल करने की सुविधा को बेहतर बनाया जा सके. उदाहरण के लिए, SystemServerStatusCheck यह जांच करता है कि जांच के सुइट को चलाने के दौरान, डिवाइस पर system_server प्रोसेस फिर से शुरू हुई या नहीं. postExecutionCheck में, यह deviceSoftRestarted को कॉल करता है, जो NativeDevice में तय किया गया है. इससे यह पता चलता है कि system_server प्रोसेस फिर से शुरू हुई है या नहीं.

हर कार्रवाई के बाद, StatusCheckerResult दिखता है. इससे हार्नेस को यह तय करने में मदद मिलती है कि गड़बड़ी की रिपोर्ट जैसी अन्य जानकारी कैप्चर की जाए या नहीं.

सीटीएस में ये कहां तय किए जाते हैं?

सीटीएस सिस्टम के स्टेटस की जांच करने वाले टूल, /test/suite_harness/tools/cts-tradefed/res/config/cts-system-checkers.xml में तय किए गए हैं.

जांच करने वाले टूल से जुड़ी गड़बड़ियों का पता लगाने का तरीका

डिफ़ॉल्ट रूप से, सिस्टम चेकर की गड़बड़ियां सिर्फ़ लॉग में दिखती हैं. साथ ही, bugreport-checker-post-module-<module name>.zip फ़ॉर्मैट के हिसाब से नाम वाले इनवोकेशन के लिए कैप्चर की गई गड़बड़ी की रिपोर्ट के तौर पर भी दिखती हैं.

इससे यह पता चलता है कि गड़बड़ी की रिपोर्ट किस मॉड्यूल के बाद जनरेट हुई.

--report-system-checkers विकल्प को true पर सेट करके, सिस्टम चेकर की रिपोर्ट को टेस्ट में हुई गड़बड़ी के तौर पर दिखाया जा सकता है. इससे एक टेस्ट रन 'फ़ेल' के तौर पर दिखाया जाता है, जिसमें 'स्टेटस चेकर' की खास जांच न होने की वजह होती है.