खास जानकारी
Git सोर्स एडिटर (ci.android.com/edit), ब्राउज़र पर काम करने वाला एक टूल है. इसका इस्तेमाल, Android Open Source Project (AOSP) में फ़ाइलों में बदलाव करने और Gerrit में बदलावों को अपलोड करने के लिए किया जाता है. इसका मकसद, कुछ फ़ाइलों में छोटे बदलाव करना है. साथ ही, यह Android सोर्स ट्री को डाउनलोड करने के मुकाबले तेज़ वर्कफ़्लो देता है. Git सोर्स एडिटर का इस्तेमाल करने से पहले, आपको Git, Repo, और Gerrit का इस्तेमाल करके, AOSP में बदलाव सबमिट करने की पूरी प्रोसेस के बारे में पता होना चाहिए.
Git सोर्स एडिटर का इस्तेमाल करके किसी फ़ाइल में बदलाव करने पर, सारा काम आपकी लोकल मशीन पर होता है. ऐसा तब तक होता है, जब तक कि आप Gerrit की बदलाव सूची बनाने के लिए बदलावों को अपलोड नहीं कर देते.
लॉग इन करें
- ब्राउज़र में Git Source Editor लोड करें.
अपने खाते में लॉग इन करने के लिए, लॉग इन करें पर क्लिक करें.
पहली इमेज. लॉगिन बटन
फ़ाइलों और बदलावों में बदलाव करना
Git सोर्स एडिटर में ये मुख्य वर्कफ़्लो होते हैं:
- अपनी पसंद की शाखा में, एक या उससे ज़्यादा फ़ाइलों में बदलाव करें.
- किसी बदलाव में बदलाव करना. किसी बदलाव में बदलाव करने पर, नतीजा इस बात पर निर्भर करता है कि बदलाव किसने किया है:
- अगर आपने बदलाव किया है, तो Git Source Editor में किए गए बदलाव, बदलाव में नए पैचसेट के तौर पर पैच हो जाते हैं.
- अगर किसी और ने बदलाव किया है, तो Git सोर्स एडिटर में किए गए बदलावों से, आपके बदलाव के आधार पर एक नया बदलाव बन जाता है.
वह फ़ाइल लोड करें जिसमें बदलाव करना है
कोई फ़ाइल या बदलाव लोड करके, एडिट करने का सेशन शुरू करें.
फ़ाइलें लोड करना
पेज पर सबसे ऊपर मौजूद फ़ाइल/बदलाव का पाथ बॉक्स में, उस फ़ाइल का यूआरएल डालें जिसमें आपको बदलाव करना है.
फ़ाइल के पाथ का सैंपल: https://android.googlesource.com/platform/build/+show/refs/heads/main/Changes.md
फ़ाइल लोड करें या बदलें पर क्लिक करें.
दूसरी इमेज. फ़ाइल लोड हो रही है या कोई बदलाव हो रहा है
फ़ाइल, एडिटर पैनल में लोड हो जाती है. एडिटर पैनल के बाईं ओर मौजूद नेविगेशन पैनल, एक फ़ाइल ब्राउज़र है. यह आपके लिए पहले से लोड की गई फ़ाइल के साथ, रिपॉज़िटरी खोलता है.
तीसरी इमेज. बदलाव करने वाले पैनल में लोड की गई फ़ाइल
नेविगेशन पैनल का इस्तेमाल करके, एक ही रिपॉज़िटरी में मौजूद ज़्यादा फ़ाइलें खोली जा सकती हैं. अगर एक से ज़्यादा फ़ाइलें खोली जाती हैं, तो हर फ़ाइल, एडिट पैनल के ऊपर मौजूद लाइन में टैब के तौर पर दिखती है. बदलाव करने वाले पैनल में उस फ़ाइल को खोलने के लिए, किसी टैब पर क्लिक करें.
चौथी इमेज. लोड की गई फ़ाइलों के लिए टैब
बदलाव लोड करना
जिस बदलाव में आपको बदलाव करना है उस पर जाएं. इसके लिए, पेज पर सबसे ऊपर मौजूद फ़ाइल/बदलाव का पाथ बॉक्स में, Gerrit के बदलावों की सूची का यूआरएल डालें (दूसरा इमेज देखें).
बदलाव का सैंपल लिंक: https://android-review.googlesource.com/c/platform/build/soong/+/1284176
बदलाव वाली फ़ाइलें, बदलाव करने वाले पैनल में खुलती हैं (तीसरा चित्र देखें).
अगर बदलाव में एक से ज़्यादा फ़ाइलें शामिल हैं, तो हर फ़ाइल, बदलाव करने वाले पैनल के ऊपर मौजूद लाइन में टैब के तौर पर दिखती है (चित्र 4 देखें). बदलाव करने वाले पैनल में उस फ़ाइल को खोलने के लिए, किसी टैब पर क्लिक करें.
बदलाव करना
टेक्स्ट एडिटिंग पैनल का इस्तेमाल करके फ़ाइलों में बदलाव करें. जिन फ़ाइलों में बदलाव किया जाता है वे बदलाव करने वाले पैनल के नीचे, 'बदलाव किए जाने बाकी हैं' सूची में दिखती हैं. अगर आपने गलती से बदलाव वाली किसी फ़ाइल का टैब बंद कर दिया है, तो बदलावों के साथ फ़ाइल को फिर से खोला जा सकता है. इसके लिए, 'बदलाव किए जाने बाकी हैं' सूची में, फ़ाइल के नाम पर क्लिक करें.
परिवर्तन सबमिट करें
आपने Git Source Editor में Gerrit में बदलाव किया और उसे पब्लिश किया. इसके बाद, Gerrit में बदलाव की अनुमति को ट्रैक करें.
बदलाव करना और उन्हें पब्लिश करना
किए गए बदलावों को पब्लिश करने के लिए, यह तरीका अपनाएं.
सही बटन पर क्लिक करें:
- नया बदलाव करते समय, बदलाव बनाएं पर क्लिक करें.
- अगर आपको किसी मौजूदा बदलाव को अपडेट करना है, तो बदलाव अपडेट करें पर क्लिक करें.
एक डायलॉग बॉक्स खुलेगा.
पांचवीं इमेज. बदलाव करने के लिए डायलॉग बॉक्स बनाना
बदलाव के बारे में जानकारी डालें. यह जानकारी, Gerrit में बदलाव के बारे में जानकारी बन जाएगी. यह जानकारी देना ज़रूरी है. अगर किसी मौजूदा बदलाव में बदलाव किया जा रहा है, तो आपके पास उसके ब्यौरे में बदलाव करने का विकल्प है.
इसके अलावा, बनाने के बाद पब्लिश करें चेकबॉक्स को चुनें या हटाएं.
यह बॉक्स डिफ़ॉल्ट रूप से चुना हुआ होता है.
बदलाव करते समय यह बॉक्स चुनने पर, बदलाव तुरंत Gerrit पर पब्लिश हो जाता है. अगर बॉक्स नहीं चुना गया है, तो बदलाव को Gerrit पर अपलोड कर दिया जाता है, लेकिन पब्लिश नहीं किया जाता.
बनाएं पर क्लिक करें.
बदलाव, Gerrit पर अपलोड हो जाता है. अगर आपने बनाने के बाद पब्लिश करें का चेकबॉक्स चुना है, तो बदलाव Gerrit में भी पब्लिश हो जाता है. यह बदलाव, स्क्रीन पर सबसे ऊपर मौजूद सूचना में लिंक किया गया है.
छठी इमेज. बनाई गई सूचना बदलना
Gerrit में बदलाव की मंज़ूरी ट्रैक करना
बदलाव सबमिट करने की स्थिति को सीधे Gerrit में ट्रैक करें, जैसे कि किसी दूसरे बदलाव को ट्रैक किया जाता है.
सातवीं इमेज. Gerrit में बदलाव सबमिट करने की स्थिति ट्रैक करना
फ़ाइल के बीच अंतर देखना
बदलाव करने वाले पैनल में मौजूद फ़ाइल में किए गए बदलावों की तुलना देखने के लिए, बदलाव करने वाले पैनल के नीचे मौजूद बदलाव चेकबॉक्स को चुनें. यह तब काम का होता है, जब किसी फ़ाइल में बदलाव किया जा रहा हो और किसी मौजूदा बदलाव में बदलाव किया जा रहा हो.
आठवीं इमेज. फ़ाइल के अंतर को देखना
फ़ाइलों को पहले जैसा करना
किसी एक फ़ाइल या बदलावों की सूची में मौजूद सभी फ़ाइलों में किए गए बदलावों को पहले जैसा किया जा सकता है. बदलावों को पहले जैसा करने के दोनों विकल्प, सिर्फ़ Git सोर्स एडिटर में बदलावों को पहले जैसा करते हैं. इससे, Gerrit में किए गए बदलाव अपडेट नहीं होंगे.
किसी एक फ़ाइल को पहले जैसा करना
किसी एक फ़ाइल को पहले जैसा करने के लिए, 'बदलाव किए जाने बाकी हैं' सूची में, फ़ाइल के नाम के बगल में मौजूद X पर क्लिक करें.
नौवीं इमेज. बदलावों को मंज़ूरी मिलना बाकी है सेक्शन
सभी फ़ाइलों को पहले जैसा करना
सभी फ़ाइलों को एक साथ पहले जैसा करने के लिए, बदलाव करने वाले पैनल के नीचे मौजूद, सभी फ़ाइलों को पहले जैसा करें पर क्लिक करें.
10वीं इमेज. सभी फ़ाइलों को पहले जैसा करने का बटन
इसके बाद, एक पॉप-अप डायलॉग बॉक्स खुलेगा. जिन फ़ाइलों में बदलाव किए गए हैं उन सभी में बदलावों को पहले जैसा करने के लिए, सभी बदलाव पहले जैसा करें पर क्लिक करें. इसके अलावा, बदलावों को बनाए रखने और बदलाव जारी रखने के लिए, रद्द करें पर क्लिक करें.
11वीं इमेज. सभी फ़ाइलों को वापस लाने की पुष्टि करने वाला डायलॉग बॉक्स
Android कोड खोजने की सुविधा से सीधे किसी पेज में बदलाव करना
Android कोड खोज से सीधे Git सोर्स एडिटर में कोई फ़ाइल खोली जा सकती है. अगर आपको फ़ाइल में बदलाव करने से पहले उसकी जगह का पता लगाना है, तो यह सुविधा मददगार साबित हो सकती है.
Android कोड सर्च से सीधे किसी फ़ाइल में बदलाव करने के लिए, यह तरीका अपनाएं.
Android Code Search (cs.android.com) में, उस फ़ाइल पर जाएं जिसमें आपको बदलाव करना है.
कोड में बदलाव करें पर क्लिक करें.
12वीं इमेज. Android Code Search कोड में बदलाव करें बटन
Git सोर्स एडिटर, बदलाव करने के लिए पहले से चुनी गई फ़ाइल के साथ खुलता है.
कोई Git शाखा चुनें ड्रॉपडाउन सूची से वह Git शाखा चुनें जिसमें आपको फ़ाइल में बदलाव करना है. इसके बाद, शाखा चुनें पर क्लिक करें.
13वीं इमेज. बदलाव करने के लिए कोई Git शाखा चुनना
ऐसा करने पर, फ़ाइल बदलाव करने वाले पैनल में खुल जाती है.
बदलाव करना सेक्शन में बताए गए तरीके से बदलाव करना जारी रखें.
बदलाव करने के लिए, फ़ाइलें लोड हो रही हैं सेक्शन में बताए गए तरीके से अन्य फ़ाइलें खोली जा सकती हैं
विवादों को हल करना
विरोधों को हल करने के लिए:
सोर्स एडिटर में, बदलाव पर जाएं. बदलाव लोड होने के बाद, स्क्रीन के सबसे नीचे, कॉन्फ़्लिक्ट वाली फ़ाइलों की सूची दिखती है. उदाहरण के लिए, फ़िगर 14 में दिखाया गया है कि
Android.pbफ़ाइल में कोई विरोध है.
14वीं इमेज. सोर्स एडिटर में कॉन्फ़िगरेशन का मेल न खाना
उस फ़ाइल पर क्लिक करें जिससे समस्या आ रही है. फ़ाइल लोड होने के बाद, Git मार्कर (
<<<<<<<और>>>>>>>) के अंदर, कॉन्टेंट के एक-दूसरे से मेल न खाने वाले ब्लॉक एक के बाद एक दिखते हैं.
15वीं इमेज. सोर्स एडिटर में कॉन्फ़लिक्ट मार्कर
फ़ाइल में बदलाव करके और जिस कॉन्टेंट को सेव रखना है उसके आस-पास मौजूद, मैन्युअल तरीके से हटाए जा सकने वाले मार्कर हटाकर, समस्या को ठीक करें. साथ ही, जिस कॉन्टेंट को आपको नहीं रखना है उसके लिए कॉन्टेंट और 'कॉन्फ़लिक्ट' मार्कर हटाएं.
नया बदलाव करने के लिए, बदलाव बनाएं पर क्लिक करें. 'बदलाव बनाएं' डायलॉग दिखेगा.
16वीं इमेज. बदलाव करना
बदलाव का ब्यौरा लिखें और बनाएं पर क्लिक करें.
सुझाव भेजें
Git Source Editor के बारे में सुझाव/राय देने या शिकायत करने के लिए, सबसे ऊपर दाएं कोने में मौजूद गड़बड़ी वाले बटन
का इस्तेमाल करें.