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