कोड में हुए बदलावों को सबमिट करें

इस पेज पर, Android पर कोड बदलने के अनुरोध को सबमिट करने की पूरी प्रोसेस बताई गई है ओपन सोर्स प्रोजेक्ट (एओएसपी), जिसमें समीक्षा का अनुरोध करने और उसे ट्रैक करने का तरीका शामिल है आपके परिवर्तन.

एओएसपी, Gerrit पर निर्भर करता है. यह एक वेब आधारित कोड समीक्षा सिस्टम है. इसकी मदद से, उन प्रोजेक्ट का इस्तेमाल किया जा सकता है जिनमें गिट.

योगदान देने वाले लोगों के लाइसेंस के कानूनी समझौतों पर हस्ताक्षर करें

एओएसपी के लिए कोड में कोई बदलाव करने से पहले, आपको यह जानकारी ज़रूर पढ़ें योगदान देने वाले के लाइसेंस के कानूनी समझौते और हेडर और इनमें से किसी एक कानूनी समझौते पर हस्ताक्षर करें:

• योगदान देने वाले व्यक्तिगत तौर पर, सिर्फ़ आपकी ओर से योगदान देने के लिए हस्ताक्षर करें यह व्यक्तिगत तौर पर योगदान देने वाले को लाइसेंस देने के लिए कानूनी समझौता.
• किसी कॉर्पोरेशन में काम करने वाले कर्मचारी के तौर पर, यह पक्का करें कि आपकी कंपनी ने कॉर्पोरेट कॉन्ट्रिब्यूटर के लाइसेंस से जुड़ा कानूनी समझौता योगदान देने के लिए अधिकृत करना.

ब्रांच शुरू करें

आपको जो भी कोड बदलाव करना है उसके लिए, नीचे दिया गया तरीका अपनाएं:

1. काम के Git रिपॉज़िटरी में नई ब्रांच शुरू करें. ब्रांच कॉपी नहीं है फ़ाइलें इस्तेमाल की जा सकती हैं; यह किसी प्रतिबद्धता की दिशा में एक पॉइंटर है. इससे लोकल ब्रांच बनाना और उनमें आसानी से बदलाव करना. इन्होंने बदलाव किया है ब्रांच का इस्तेमाल करके, एक-दूसरे में हुए बदलावों की पहचान की जा सकती है. इस निर्देश को चलाने के लिए ब्रांच शुरू करें:

   repo start BRANCH_NAME
   

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

2. (ज़रूरी नहीं) पुष्टि करें कि ब्रांच बनाई गई थी:

   repo status .
   

   आपको अपनी नई बनाई गई ब्रांच दिखेगी. उदाहरण के लिए:

   project frameworks/native/                      branch mynewbranch
   

बदलाव करें और उसकी जांच करें

बदलाव करने और उसकी जांच करने के लिए, यह तरीका अपनाएं:

1. यह सुनिश्चित करने के लिए कि आप सबसे नए कोड बेस के साथ काम कर रहे हैं, पूरा कोड बेस:

   repo sync
   

   अगर सिंक करने के दौरान कोई समस्या होती है, तो सिंक करने से जुड़े विवादों का समाधान करें.

2. जिस कोड को बदलना है उसे ढूंढें. कोड ढूंढने के लिए, Android कोड खोज. Android डिवाइस पर कोड सर्च की मदद से, एओएसपी सोर्स कोड को ठीक वैसे ही देखा जा सकता है जैसा कि असल में इस्तेमाल करते समय यह तय किया जाता है इसे. ज़्यादा जानकारी के लिए, यह देखें कोड सर्च का इस्तेमाल शुरू करना. Android कोड सर्च में, main की ब्रांच के सभी कोड देखने के लिए, इस पर जाएं https://cs.android.com/android/platform/superproject/main.

3. सोर्स फ़ाइलों में बदलाव करें या उन्हें जोड़ें. किए गए किसी भी बदलाव के लिए:

   • सबसे सही तरीकों को अपनाएं लाइसेंस हेडर शामिल करें.

   • Java कोड के लिए, इन निर्देशों का पालन करें योगदान देने वालों के लिए AOSP Java कोड स्टाइल.

   • एओएसपी के कुछ हिस्से Kotlin (.kt) में लिखे गए हैं और आपके पास Kotlin का इस्तेमाल इन कामों के लिए किया जा सकता है जो पहले से Kotlin में लिखे गए हैं. Reader Revenue Manager को सेट अप करने के बारे में Android में Kotlin के बारे में जानने के लिए, Android डेवलपर के बारे में जानें Kotlin की स्टाइल गाइड और Kotlin-Java इंटरऑप गाइड. Kotlin के बारे में ज़्यादा जानकारी के लिए, यहां देखें: Kotlin की भाषा साइट.

   • एपीआई लिखते समय, Android API के दिशा-निर्देशों का पालन करें. Android के एपीआई से जुड़े फ़ैसले लेने की वजह जानने के लिए, इन दिशा-निर्देशों का पालन करें. प्लैटफ़ॉर्म एपीआई जोड़ने और उनमें बदलाव करने की पुष्टि मेटलवा.

4. Android बनाएं.

5. अपने बिल्ड की जांच करें.

बदलाव करें और बदलावों को लागू करें

commit, Git में रिविज़न कंट्रोल की बुनियादी यूनिट है और इसमें पूरे प्रोजेक्ट के लिए डायरेक्ट्री स्ट्रक्चर और फ़ाइल के कॉन्टेंट का स्नैपशॉट. बदलाव करने के लिए यह तरीका अपनाएं:

1. डिफ़ॉल्ट रूप से, Git रजिस्टर करता है, लेकिन आपके किए गए बदलावों को ट्रैक नहीं करता. यहां की यात्रा पर हूं Git को अपने बदलावों को ट्रैक करने का निर्देश दें, तो आपको शामिल हैं. बदलाव करने के लिए इस निर्देश को चलाएं:

   git add -A
   

   यह निर्देश, फ़ाइलों में किए गए बदलावों को ट्रैक करता है.

2. फ़ाइलों को स्टेजिंग एरिया में ले जाएं और उन्हें अपने डिवाइस में सेव करें या सेव करें डेटाबेस:

   git commit -s
   

   डिफ़ॉल्ट रूप से, एक टेक्स्ट एडिटर खुल जाता है और आपको कोई कमेंट करने के लिए भी किया जा सकता है.

3. इस फ़ॉर्मैट में अपना मैसेज दें:

   • लाइन 1: हेडलाइन. बदलाव की खास जानकारी एक लाइन में दें (50 वर्ण ज़्यादा से ज़्यादा). जिस इलाके में आपने बदलाव किया है उसकी जानकारी देने के लिए, प्रीफ़िक्स का इस्तेमाल करें. किए गए बदलाव की जानकारी देते हैं, जैसे कि यूज़र इंटरफ़ेस में किए गए बदलाव का उदाहरण:

     ui: Removes deprecated widget
     

   • पंक्ति 2: खाली पंक्ति. एक खाली लाइन के साथ हेडलाइन का पालन करें.

   • लाइन 3: मुख्य हिस्सा. ऐसा ब्यौरा दें जो 72 वर्णों में पूरा हो ज़्यादा से ज़्यादा. बताएं कि बदलाव से किस समस्या का समाधान हुआ और कैसे. भले ही शरीर वैकल्पिक रूप से, यह उन अन्य लोगों के लिए उपयोगी होता है जिन्हें बदलाव पर वापस जाने की ज़रूरत होती है. किसी भी अनुमान या बैकग्राउंड की जानकारी के बारे में एक छोटा नोट शामिल करना न भूलें योगदान देने वाला कोई अन्य क्रिएटर इस सुविधा पर काम करता है.

   अच्छी प्रतिबद्धताओं के बारे में ब्लॉग पढ़ने के लिए (उदाहरण के साथ), देखें Git तय मैसेज लिखने का तरीका.

4. तय की गई कीमत को सेव करें.

यूनीक चेंज आईडी और आपका नाम और ईमेल पता, जो ये सुविधाएं, repo init के दौरान उपलब्ध कराई जाती हैं. इन्हें आपके तय किए गए मैसेज में अपने-आप जोड़ दिया जाता है.

बदलाव को समीक्षा के लिए अपलोड करें

अपने व्यक्तिगत Git इतिहास में बदलाव करने के बाद, उसे Gerrit पर अपलोड करें:

1. अपने सभी कमिट को प्रोजेक्ट:

   repo upload
   

   सभी प्रोजेक्ट के सभी बदलाव, अपलोड में शामिल कर लिए जाते हैं.

   आपको हुक स्क्रिप्ट चलाने के लिए कहा जाएगा.

2. a और फिर Enter दबाएं.

   आपसे अपलोड की अनुमति मांगी जाएगी:

   Upload project frameworks/native/ to remote branch main:
   branch BRANCH_NAME ( 1 commit, Wed Aug 7 09:32:33 2019 -0700):
          ff46b36d android codelab change
   to https://android-review.googlesource.com/ (y/N)?
   

3. अपलोड को मंज़ूरी देने के लिए, y और फिर Enter दबाएं.

आपको remote: SUCCESS के जैसा एक मैसेज मिलेगा.

समीक्षा का अनुरोध करें

अपलोड हो जाने के बाद, Repo आपको एक लिंक देता है, जिस पर जाकर गेरिट. समीक्षा सर्वर पर अपने बदलाव देखने, टिप्पणियां जोड़ने, और या अपने परिवर्तन के लिए विशिष्ट समीक्षकों से अनुरोध करें. कोड में किए जाने वाले सभी बदलाव उसकी समीक्षा सही कोड मालिकों ने की हो. समीक्षा का अनुरोध करने के लिए:

1. Gerrit में, SUGGEST OWNER पर क्लिक करें:

   

   पहला डायग्राम. Genrit में मालिकों के सुझाव दें लिंक.

   समीक्षक वाला डायलॉग बॉक्स दिखेगा. इस डायलॉग बॉक्स में उन कोड मालिकों की सूची होती है जो आपके बदलाव की समीक्षा कर सकता है.

2. किसी कोड मालिक को अपनी समीक्षा में जोड़ने के लिए, उसके नाम पर क्लिक करें.

   भेजें बटन चालू हो गया है.

3. (ज़रूरी नहीं) ऐसे किसी भी व्यक्ति का ईमेल पता लिखें जिसे आपको अपनी बदलें.

4. (ज़रूरी नहीं) बदलाव को अपने-आप सबमिट करने के लिए, 'अपने-आप सबमिट करें' के आगे मौजूद +1 पर क्लिक करें मंज़ूरी मिलने के बाद. अगर आप इस बटन पर क्लिक नहीं करते हैं, तो Google का एक कर्मचारी को आपके लिए आपका परिवर्तन सबमिट करना होगा.

5. बदलाव को समीक्षा के लिए भेजने के लिए, भेजें पर क्लिक करें.

कोड के मालिक आपके कोड में होने वाले बदलावों की समीक्षा करते हैं. साथ ही, इनके बारे में आपको सुझाव या राय देते हैं बदलावों का समाधान करें या उन्हें अनुमति दें.

बदलाव की स्थिति तय करना

अपने बदलाव में शामिल फ़ाइलों की स्थिति तय करने के लिए, बदलाव की फ़ाइलों के बगल में मौजूद आइकॉन:

• done (सही का निशान) आइकॉन): कोड के मालिक ने मंज़ूरी दी है
• clear (क्रॉस आइकॉन): कोड के मालिक ने अनुमति नहीं दी है
• access_time (घड़ी की दिशा में) आइकॉन): कोड के मालिक की मंज़ूरी बाकी है

यहां दिए गए डायग्राम में, बदलाव वाली फ़ाइलों पर लागू होने वाले इन स्टेटस आइकॉन को दिखाया गया है:

दूसरा डायग्राम. कोड के मालिक की अनुमति दिखाने वाले आइकॉन वाली फ़ाइलों का उदाहरण.

सुझाव, शिकायत या राय पर कार्रवाई करें और मौजूदा बदलाव को अपलोड करें

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

सुझाव, शिकायत या राय का समाधान करने और अपने बदलाव में बदलाव करने के लिए:

1. बदलाव लागू करना और उसकी जांच करना लेख में दिए गए 2 से 4 चरण का पालन करें.

2. अपने बदलाव में बदलाव करने के लिए, इन निर्देशों का पालन करें:

   git add -A
   git commit --amend
   

3. बदलाव अपलोड करें.

जब आप बदलाव किए गए बदलाव को अपलोड करते हैं, तो यह Gerrit पर मूल को बदल देता है और आपके स्थानीय Git इतिहास में मौजूद होगा.

सिंक से जुड़े विवादों का समाधान करना

अगर ऐसे सोर्स ट्री में अन्य बदलाव सबमिट किए जाते हैं जो आपकी सदस्यता को रद्द करने पर, आपको एक मैसेज मिलता है कि आपकी बातचीत को मैनेज नहीं किया जा सकता. विवादों को सुलझाने के लिए:

1. पक्का करें कि नए कोड का इस्तेमाल किया जा रहा हो:

   repo sync .
   

   repo sync निर्देश, सोर्स सर्वर से अपडेट फ़ेच करता है. इसके बाद, आपके HEAD को नए रिमोट HEAD पर अपने-आप फिर से इकट्ठा करने की कोशिश करता है.

2. अगर अपने-आप रीबेस की प्रोसेस पूरी नहीं हो पाती है, तो मैन्युअल तरीके से रीबेस करें:

   repo rebase .
   

3. एक बनाने से जुड़े विवादों का समाधान करें. अगर समस्या हल करने के लिए, आपने कोई पसंदीदा तरीका नहीं चुना है एक-दूसरे से जुड़े रहें, git mergetool का इस्तेमाल करें का इस्तेमाल करें.

4. विरोधी फ़ाइलों को ठीक करने के बाद, इस कमांड को नई तय की गई शर्तें लागू करें:

   git rebase --continue
   

बदलाव सबमिट करें

आवेदन सबमिट करने के बाद, उसकी समीक्षा और पुष्टि की प्रक्रिया पूरी हो जाती है. एक Google समीक्षक को आपके लिए कोड सबमिट करना होगा. किसी और तरीके से उपयोगकर्ता अपने लोकल डिवाइस पर अपडेट देखने के लिए, repo sync का इस्तेमाल कर सकते हैं क्लाइंट.

सबमिट किए गए कॉन्टेंट को मर्ज करने के बाद, Android का लगातार इंटिग्रेशन डैशबोर्ड पर जाएं, ताकि यह मॉनिटर किया जा सके कि आपके सबमिशन ट्री में कब इंटिग्रेट किए गए.