यह पृष्ठ डेवलपर-संचालित सीटीएस (सीटीएस-डी) के लिए उपयोग दिशानिर्देशों की रूपरेखा देता है।
परीक्षण कवरेज
सीटीएस-डी, सीटीएस और सीटीएस सत्यापनकर्ता की तरह, केवल निम्नलिखित को लागू कर सकता है:
- सभी सार्वजनिक एपीआई जो एक निश्चित एपीआई स्तर के लिए डेवलपर एसडीके (डेवलपर.एंड्रॉइड.कॉम) में वर्णित हैं।
- सभी आवश्यक आवश्यकताएं जो एक निश्चित एपीआई स्तर के लिए एंड्रॉइड संगतता परिभाषा दस्तावेज़ (सीडीडी) में शामिल हैं।
गैर-आवश्यक आवश्यकताएं, जैसे कि अत्यधिक अनुशंसित, चाहिए, मई, वैकल्पिक हैं और सीटीएस का उपयोग करके परीक्षण नहीं किया जा सकता है।
क्योंकि सभी एपीआई और सीडीडी आवश्यकताएं एक विशिष्ट एपीआई स्तर से जुड़ी हुई हैं, सभी सीटीएस परीक्षण (सीटीएस, सीटीएस-डी, और सीटीएस सत्यापनकर्ता) उनके संबंधित एपीआई या आवश्यकताओं के समान एपीआई स्तर से बंधे हैं। यदि किसी विशिष्ट एपीआई को हटा दिया गया है या बदल दिया गया है, तो उसके संबंधित परीक्षण को हटा दिया जाना चाहिए या अद्यतन किया जाना चाहिए।
सीटीएस परीक्षण निर्माण नियम
- एक परीक्षण को लगातार एक ही वस्तुनिष्ठ परिणाम देना चाहिए।
- एक परीक्षण को यह निर्धारित करना होगा कि कोई उपकरण बॉक्स से बाहर एक बार परीक्षण करके उत्तीर्ण होता है या विफल रहता है।
- परीक्षण निर्माताओं को उन सभी संभावित कारकों को हटाना होगा जो परीक्षण परिणामों को प्रभावित कर सकते हैं।
- यदि किसी डिवाइस को एक निश्चित हार्डवेयर स्थिति/पर्यावरण/सेटअप की आवश्यकता है, तो उस सेटअप को प्रतिबद्ध संदेश में स्पष्ट रूप से परिभाषित किया जाना चाहिए। उदाहरण के लिए सेटअप निर्देशों के लिए, सीटीएस सेट करना देखें।
- परीक्षण एक बार में 6 घंटे से अधिक नहीं चलना चाहिए। यदि इसे अधिक समय तक चलाने की आवश्यकता है, तो कृपया अपने परीक्षण प्रस्ताव में तर्क शामिल करें ताकि हम इसकी समीक्षा कर सकें।
ऐप प्रतिबंध के परीक्षण के लिए परीक्षण शर्तों का एक उदाहरण निम्नलिखित है:
- वाईफ़ाई स्थिर है (एक परीक्षण के लिए जो वाईफ़ाई पर निर्भर है)।
- परीक्षण के दौरान उपकरण स्थिर रहता है (या नहीं, यह परीक्षण पर निर्भर करता है)।
- डिवाइस को X प्रतिशत बैटरी स्तर के साथ किसी भी पावर स्रोत से अनप्लग किया गया है।
- सीटीएस को छोड़कर कोई भी ऐप, फ़ोरग्राउंड सेवाएँ या पृष्ठभूमि सेवाएँ नहीं चल रही हैं।
- सीटीएस चलाते समय स्क्रीन बंद है।
- डिवाइस
isLowRamDeviceनहीं है। - बैटरी सेवर/ऐप प्रतिबंध को "आउट-ऑफ़-द-बॉक्स" स्थिति से नहीं बदला गया है।
पात्रता का परीक्षण करें
हम ऐसे नए परीक्षण स्वीकार करते हैं जो ऐसे व्यवहार को लागू करते हैं जिसका परीक्षण मौजूदा सीटीएस, सीटीएस सत्यापनकर्ता या सीटीएस-डी परीक्षणों द्वारा नहीं किया जाता है। कोई भी परीक्षण जो हमारे परीक्षण कवरेज के दायरे से बाहर के व्यवहार की जाँच करता है उसे अस्वीकार कर दिया जाएगा।
सीटीएस जमा करने की प्रक्रिया
- एक परीक्षण प्रस्ताव लिखें: एक ऐप डेवलपर Google इश्यू ट्रैकर का उपयोग करके एक परीक्षण प्रस्ताव सबमिट करता है, जिसमें पहचानी गई समस्या का वर्णन होता है और इसकी जांच के लिए एक परीक्षण का प्रस्ताव होता है। प्रस्ताव में संबंधित सीडीडी आवश्यकता आईडी शामिल होनी चाहिए। एंड्रॉइड टीम प्रस्ताव की समीक्षा करती है।
- सीटीएस परीक्षण विकसित करें: एक प्रस्ताव स्वीकृत होने के बाद, इसका प्रस्तुतकर्ता मुख्य (एओएसपी/मुख्य) शाखा पर एओएसपी पर एक सीटीएस परीक्षण बनाता है। एंड्रॉइड टीम कोड की समीक्षा करती है।
- परीक्षण प्रकाशित करें: अपना सीएल
AOSP/mainपर सबमिट करें और फिर इसे नवीनतमandroidx-tests-devशाखा में चेरी-पिक करें। परीक्षण अब सार्वजनिक रूप से उपलब्ध है.
सीटीएस-डी परीक्षण लेखन दिशानिर्देश
- जावा कोड स्टाइल गाइड का पालन करें।
- सीटीएस विकास में वर्णित सभी चरणों का पालन करें।
- अपने परीक्षण उचित परीक्षण योजना में जोड़ें:
- सीटीएस-डी परीक्षण योजना में अपने नए परीक्षण जोड़ने के लिए
include-filtersउपयोग करें:platform/cts/tools/cts-tradefed/res/config/cts-developer.xml - अपने नए परीक्षणों को मुख्य सीटीएस परीक्षण योजना से बाहर करने के लिए
exclude-filtersउपयोग करें:platform/cts/tools/cts-tradefed/res/config/cts-developer-exclude.xml
- सीटीएस-डी परीक्षण योजना में अपने नए परीक्षण जोड़ने के लिए
-
build_error.logमें सभीerrorproneचेतावनियों और सुझावों को संभालें। - अपने परिवर्तनों को
headमें पुनः आधार बनाएं। इसमेंcts-developer.xmlऔरcts-developer-exclude.xmlपरीक्षण योजनाएँ शामिल हैं। - यह निर्धारित करने के लिए अपने Google इंजीनियरिंग संपर्क के साथ काम करें कि क्या आपका परीक्षण मामला मौजूदा सीटीएस मॉड्यूल में शामिल किया जा सकता है। यदि ऐसा नहीं हो सकता, तो वे आपको एक नया मॉड्यूल बनाने में मदद करेंगे।
- बनाए गए प्रत्येक नए परीक्षण मॉड्यूल के लिए, नई परीक्षण मॉड्यूल निर्देशिका में एक OWNERS फ़ाइल बनाएं।
- आपकी OWNERS फ़ाइल में निम्नलिखित जानकारी होनी चाहिए, जो उस Google परीक्षण स्वामी से प्राप्त की गई है जिसके साथ आप काम कर रहे हैं:
-
# Bug component: xxx - Google परीक्षण स्वामी ldap
-
AndroidTest.xmlमें, निम्नलिखित पैरामीटर निर्दिष्ट करें। उदाहरण के लिए नमूना फ़ाइलें ( 1 , 2 ) देखें:-
Instant_appयाnot_instant_app -
secondary_userयाnot_secondary_user -
all_foldable_statesयाno_foldable_states
-
- सही minSDK निर्दिष्ट करने के लिए, <uses-sdk> दस्तावेज़ देखें।
- नई परीक्षण विधियों, कक्षाओं या मॉड्यूल में जाँच करते समय, उन्हें सीटीएस-डी परीक्षण योजना में जोड़ें और नए परीक्षणों की तरह ही उन्हें मुख्य सीटीएस परीक्षण योजना से बाहर कर दें।
अपना सीटीएस-डी परीक्षण चलाएँ
run run cts --plan cts-developer उपयोग करके कमांड लाइन से CTS-D परीक्षण योजना चलाएँ।
एक विशिष्ट परीक्षण केस चलाने के लिए, run cts --include-filter "test_module_name test_name" उपयोग करें।
पूर्ण सीटीएस चलाने की जानकारी के लिए, सीटीएस परीक्षण चलाएँ देखें।
स्वीकृति एवं रिहाई
एक बार परीक्षण अनुरोध सबमिट हो जाने के बाद, एक आंतरिक टीम इसकी समीक्षा करेगी ताकि यह सुनिश्चित हो सके कि यह सीडीडी आवश्यकता या दस्तावेज एपीआई व्यवहार का परीक्षण करती है। यदि परीक्षण किसी वैध आवश्यकता या व्यवहार की जांच के लिए निर्धारित किया जाता है, तो टीम इस परीक्षण मामले को आगे की समीक्षा के लिए Google इंजीनियर को भेज देगी। सीटीएस में स्वीकार किए जाने से पहले परीक्षण को कैसे बेहतर बनाया जा सकता है, इस बारे में फीडबैक के साथ Google इंजीनियर आपके पास पहुंचेगा।
सीटीएस रिलीज़ शेड्यूल के विवरण के लिए रिलीज़ शेड्यूल और शाखा जानकारी देखें।