ट्रेडफेडरेशन परियोजनाओं में गैर-प्रमुख स्रोतों का योगदान करने वाली टीमों को समीक्षा प्रक्रिया का पूर्ण स्वामित्व प्रदान करने के लिए, सभी टीमों के लिए खुले +2 अधिकारों के साथ निम्नलिखित परियोजनाएं बनाई गई हैं। यह कोर ट्रेडफेडरेशन टीम को कोर फ्रेमवर्क से असंबद्ध सभी कोड समीक्षाओं के बोझ से राहत देता है, जबकि अन्य टीमों को अपने समीक्षा चक्र में तेजी से पुनरावृत्ति करने की अनुमति देता है।
गैर-कोर स्रोत को उस कोड के रूप में परिभाषित किया गया है जिसे ट्रेडफेडरेशन ढांचे द्वारा कार्यात्मक होने की आवश्यकता नहीं है (उदाहरण के लिए कस्टम परीक्षण, कॉन्फ़िगरेशन, विशिष्ट परीक्षण उपयोगिताएँ)।
महत्वपूर्ण गैर-कोर स्रोत को कोर ट्रेडफेडरेशन कक्षाओं का विस्तार नहीं करना चाहिए। ऐसा करने से भविष्य में रिफैक्टरिंग/सफाई पर असर पड़ता है। यदि आप अनिश्चित हैं कि आपका कोड कोर या कंट्रिब में है, तो स्पष्टीकरण के लिए android-tradefed@ से संपर्क करें। कोर ट्रेडफेडरेशन टीम फीचर अनुरोधों को सलाह देने और प्राप्त करने में प्रसन्न है।
एक उदाहरण कोर ट्रेडफेडरेशन क्लास
com.google.android.tradefed.build
पैकेज में कोई भी क्लास होगी जैसे:com.google.android.tradefed.build.LaunchControlProvider
पुनः, यदि आप स्पष्ट नहीं हैं कि android-tradefed@ का मुख्य वर्ग किसे माना जाएगा, तो कृपया संपर्क करें।
[टीओसी]
योगदान परियोजनाओं के पथ
ये योगदान परियोजनाएँ किसके लिए हैं?
यदि आप वर्तमान में ट्रेडफ़ेडरेशन परियोजनाओं में परीक्षण/परीक्षण उपयोगिताएँ/कॉन्फ़िगरेशन लिखने का काम करते हैं, तो ये परियोजनाएँ आपके लिए बनाई गई थीं।
योगदान परियोजनाओं में कोड समीक्षाएँ
योगदान परियोजनाओं का लक्ष्य आपको कोर टीम (android-tradefed@) की समीक्षा की आवश्यकता के बिना ट्रेडफेड में विकास करने की अनुमति देना है। इसलिए हम उम्मीद करते हैं कि आपकी टीम या आपके संदर्भ से परिचित कोई भी व्यक्ति आपके सीएल पर कोड समीक्षा करेगा।
यदि कोई फंस जाए या किसी विशेष मामले पर मार्गदर्शन की आवश्यकता हो तो हमेशा बेझिझक android-tradefed@ से संपर्क करें, लेकिन योगदान में अपने कोड की समीक्षा करने के लिए डिफ़ॉल्ट रूप से उस पर निर्भर न रहें। जब योगदान में कोड समीक्षा की बात आती है तो ट्रेडफेड टीम के पास कोई एसएलओ नहीं है।
मैं इन परियोजनाओं पर काम कहां से शुरू कर सकता हूं?
उन्हें निम्नलिखित शाखा मैनिफ़ेस्ट में जोड़ा गया है और वे पहले से ही मुख्य प्लेटफ़ॉर्म चेकआउट का हिस्सा हैं, इसलिए यदि आप अपने वातावरण में प्रोजेक्ट नहीं देखते हैं, तो आप योगदान देने से एक रेपो सिंक दूर हैं।
- मुख्य
- ट्रेडफेड
- oc-dev
- ओसी-देव-प्लस-एओएसपी
- nyc-mr2-dev-plus-aosp
- मुख्य-दिवास्वप्न-देव
- मुख्य-बिना-विक्रेता
- पहनना-मुख्य
विकास एवं परीक्षण
योगदान में विकास से एंड्रॉइड रिपॉजिटरी में कहीं भी समान गुणवत्ता बार होने की उम्मीद है:
- Android फ़ॉर्मेटिंग दिशानिर्देशों का सम्मान करें
- कोड का परीक्षण किया जाता है और परीक्षणों के साथ प्रस्तुत किया जाता है
- डिज़ाइन विचारशील है और समझ में आता है
मैं योगदान में स्थानीय स्तर पर परीक्षण कैसे करूँ?
एओएसपी
एओएसपी में, कॉन्ट्रिब के यूनिट परीक्षण प्लेटफ़ॉर्म/टूल्स/ट्रेडफेडरेशन/कॉन्ट्रिब/टेस्ट/src/ में स्थित होते हैं और यूनिट परीक्षणों को प्रीसबमिट और स्थानीय परीक्षण स्क्रिप्ट में लेने के लिए com.android.tradefed.prodtests.UnitTests में जोड़ा जाना चाहिए।
लंच चलाने के बाद Aosp स्थानीय स्क्रिप्ट:
tools/tradefederation/core/tests/run_tradefed_aosp_presubmit.sh
योगदान परियोजनाओं के लिए नियम अद्यतन बनाएं
बिल्ड नियम (मेकफ़ाइल्स) उनके स्वयं के build/
फ़ोल्डर के अंतर्गत हैं और एक OWNERS
फ़ाइल द्वारा लॉक किए गए हैं जो आपको कोर टीम से अतिरिक्त समीक्षा के बिना उन्हें संशोधित करने से रोकेंगे। यह योगदान परियोजना की एकमात्र सीमा है।
हमें यह सुनिश्चित करने के लिए इस समीक्षा की आवश्यकता है कि कोर टीम की जानकारी या सहमति के बिना समग्र ट्रेडफेड परियोजनाओं में कोई अप्रत्याशित निर्भरता न जोड़ी जाए। यदि आपको वास्तव में कुछ नई निर्भरताएँ जोड़ने की आवश्यकता है, तो कृपया अपने उपयोग के मामलों को देखने और आपको सलाह देने के लिए android-tradefed@
से संपर्क करें।