डेवलपर की ओर से मिलने वाले सीटीएस

इस पेज पर, डेवलपर की ओर से चलाए जाने वाले सीटीएस (सीटीएस-डी) के इस्तेमाल से जुड़े दिशा-निर्देश दिए गए हैं.

टेस्ट कवरेज

सीटीएस-डी, जैसे कि सीटीएस और CTS Verifier, सिर्फ़ नीचे दी गई चीज़ों को ही लागू कर सकता है:

• डेवलपर SDK में बताए गए सभी सार्वजनिक एपीआई (developer.android.com) सबमिट करें.
• 'Android के साथ काम करने की सुविधा' में शामिल की गई सभी ज़रूरी शर्तें एपीआई लेवल के बारे में जानकारी देने वाला दस्तावेज़ (सीडीडी).

बहुत ज़रूरी शर्तें, जैसे कि 'बहुत ज़्यादा सुझाया गया', हो सकती हैं, हो सकती हैं. ये वैकल्पिक हैं और सीटीएस का इस्तेमाल करके इनकी जांच नहीं की जा सकती.

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

सीटीएस टेस्ट बनाने के नियम

• टेस्ट से लगातार एक जैसा नतीजा मिलना चाहिए.
• टेस्ट से यह तय होना चाहिए कि कोई डिवाइस उस डिवाइस की जांच करके पास होता है या नहीं एक बार ही किया जा सकता है.
• जांच करने वाले क्रिएटर्स को उन सभी वजहों को हटा देना चाहिए जिनसे जांच के नतीजों पर असर पड़ सकता है.
• अगर किसी डिवाइस को किसी खास हार्डवेयर स्थिति/परिवेश/सेटअप की ज़रूरत होती है, तो वह सेटअप तय किए गए मैसेज में साफ़ तौर पर बताया जाना चाहिए. उदाहरण के लिए, सेटअप के निर्देश, CTS सेट अप करना देखें.
• टेस्ट को एक बार में छह घंटे से ज़्यादा समय तक नहीं चलाया जाना चाहिए. अगर इसे इतने समय तक चलाना है बड़ा, कृपया अपने परीक्षण प्रस्ताव में तर्क शामिल करें ताकि हम इसकी समीक्षा कर सकें.

ऐप्लिकेशन की जांच के लिए, टेस्ट की शर्तों के सेट का उदाहरण नीचे दिया गया है प्रतिबंध:

• वाई-फ़ाई स्थिर है (उस टेस्ट के लिए जो वाई-फ़ाई पर निर्भर करता है).
• जांच के दौरान, डिवाइस स्थिर रहता है या जांच के हिसाब से नहीं रहता.
• डिवाइस को ऐसे किसी भी पावर सोर्स से अनप्लग कर दिया गया है जिसमें बैटरी लेवल X प्रतिशत है.
• इनके अलावा, कोई भी ऐप्लिकेशन, फ़ोरग्राउंड सेवाएं या बैकग्राउंड सेवाएं चालू नहीं हैं सीटीएस.
• सीटीएस चलाने के दौरान स्क्रीन बंद है.
• यह डिवाइस isLowRamDevice नहीं है.
• बैटरी सेवर / ऐप्लिकेशन की पाबंदियां “आउट-ऑफ़-द-बॉक्स” स्थिति.

जांच के लिए ज़रूरी शर्तें

हम ऐसे नए टेस्ट को स्वीकार करते हैं जिनमें ऐसा व्यवहार लागू किया जाता है जिसकी जांच मौजूदा सीटीएस से नहीं की जाती है, सीटीएस वेरिफ़ायर या सीटीएस-डी टेस्ट. ऐसा कोई भी टेस्ट जो स्कोप के बाहर के व्यवहार की जांच करता है हमारे टेस्ट कवरेज को अस्वीकार कर दिया जाएगा.

सीटीएस सबमिट करने की प्रोसेस

1. एक परीक्षण प्रस्ताव लिखें: एक ऐप्लिकेशन डेवलपर इसका उपयोग करके एक परीक्षण प्रस्ताव सबमिट करता है Google समस्या को ट्रैक करने वाला टूल, उस समस्या के बारे में बताना जिसकी पहचान की जा चुकी है. साथ ही, इस समस्या की जांच करने का प्रस्ताव देना इसके लिए. प्रस्ताव में इससे जुड़ा CDD ज़रूरत आईडी शामिल होना चाहिए. Android टीम, प्रस्ताव की समीक्षा करती है.
2. सीटीएस टेस्ट तैयार करना: प्रस्ताव को मंज़ूरी मिलने के बाद, उसे सबमिट करने वाला व्यक्ति एक सीटीएस बनाता है मुख्य (एओएसपी/मेन) ब्रांच में, एओएसपी पर टेस्ट करें. Android टीम कोड की समीक्षा करती है.
3. टेस्ट पब्लिश करना: अपने CL को AOSP/main पर सबमिट करें और फिर उसे androidx-tests-dev की नई ब्रांच. यह जांच अब सार्वजनिक तौर पर उपलब्ध है.

सीटीएस-डी टेस्ट लिखने से जुड़े दिशा-निर्देश

• Java कोड स्टाइल गाइड का पालन करें.
• सीटीएस डेवलपमेंट में बताए गए सभी चरणों का पालन करें.
• अपने टेस्ट को सही टेस्ट प्लान में जोड़ें:
  • सीटीएस-डी टेस्ट प्लान में अपने नए टेस्ट जोड़ने के लिए, 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> देखें दस्तावेज़ में दिया गया है.
• जांच के नए तरीकों, क्लास या मॉड्यूल को देखते समय, उन्हें CTS-D में जोड़ें और उन्हें मुख्य CTS टेस्ट प्लान से उसी तरह बाहर कर दें जिस तरह नए टेस्ट किए जा सकते हैं.

अपना सीटीएस-डी टेस्ट चलाएं

कमांड लाइन से CTS-D टेस्ट प्लान चलाएं run cts --plan cts-developer का इस्तेमाल करके.

कोई खास टेस्ट केस चलाने के लिए, run cts --include-filter "test_module_name test_name" का इस्तेमाल करें.

पूरा सीटीएस चलाने के बारे में जानकारी के लिए, सीटीएस टेस्ट चलाना देखें.

स्वीकार करना और रिलीज़ करना

जांच का अनुरोध सबमिट होने के बाद, इंटरनल टीम यह पक्का करने के लिए उसकी समीक्षा करेगी यह सीडीडी की ज़रूरत या रिकॉर्ड किए गए एपीआई के व्यवहार की जांच करता है. अगर टेस्ट तय करती है कि किसी मान्य शर्त या व्यवहार की जांच की जाए. इस टेस्ट केस को आगे की समीक्षा के लिए, Google इंजीनियर को भेजेगा. Google इंजीनियर आपसे संपर्क करके, यह बताएंगे कि टेस्ट को कैसे बेहतर बनाया जा सकता है सीटीएस में स्वीकार किए जाने से पहले.

यहां जाएं: रिलीज़ का शेड्यूल और ब्रांच की जानकारी देखें.