עורך מקור של Git

סקירה כללית

עורך המקור של Git (ci.android.com/edit) הוא כלי מבוסס דפדפן לעריכת קבצים ב-Android Open Source Project (AOSP) והעלאת שינויים ל-Gerrit. הוא מיועד לביצוע שינויים קלים במספר קטן של קבצים, ומספק זרימת עבודה מהירה יותר מאשר הורדת עץ המקור של אנדרואיד . עליך להכיר את התהליך המלא של הגשת שינויים ל-AOSP באמצעות Git, Repo ו-Gerrit לפני השימוש בעורך המקור של Git.

כאשר אתה עורך קובץ באמצעות עורך המקור של Git, כל העבודה מתרחשת במחשב המקומי שלך, עד שאתה מעלה שינויים ליצירת רשימת שינויים של Gerrit.

התחברות

1. טען את עורך המקור של Git בדפדפן.

2. לחץ על התחבר כדי להיכנס לחשבון שלך.

   

   איור 1. כפתור התחברות

ערוך קבצים ושינויים

לעורך Git Source יש את זרימות העבודה העיקריות הבאות:

• ערוך קובץ אחד או יותר לבחירתך, בסניף שתבחר.
• ערוך שינוי. כאשר אתה עורך שינוי, התוצאה תלויה במי שיצר את השינוי:
  • אם יצרת את השינוי, עריכות המקור של Git יתבצעו בשינוי בתור ערכת תיקונים חדשה.
  • אם מישהו אחר יצר את השינוי, עריכות Git Source Editor יוצרות שינוי חדש שבבעלותך, על סמך השינוי שטענת.

טען את מה שאתה רוצה לערוך

התחל סשן עריכה על ידי טעינת קובץ או שינוי.

טען קבצים

1. הזן את כתובת האתר של הקובץ שברצונך לערוך בתיבת הקובץ/שינוי נתיב בראש העמוד.

   נתיב קובץ לדוגמה: https://android.googlesource.com/platform/build/+show/refs/heads/main/Changes.md

2. לחץ על טען קובץ או שנה .

   

   איור 2. טעינת קובץ או שינוי

   הקובץ נטען בחלונית העורך. חלונית הניווט משמאל לחלונית העריכה היא דפדפן קבצים, שפותח את ה-repo, כשהקובץ שלך טעון מראש.

   

   איור 3. קובץ שנטען לחלונית העריכה

אתה יכול להשתמש בחלונית הניווט כדי לפתוח קבצים נוספים באותו ריפו. אם אתה פותח מספר קבצים, כל קובץ יופיע כלשונית בשורה שמעל לחלונית העריכה. לחץ על כרטיסייה כדי לפתוח את הקובץ בחלונית העריכה.

איור 4. כרטיסיות לקבצים שנטענו

טען שינוי

נווט אל השינוי שברצונך לערוך על ידי הזנת כתובת האתר של רשימת שינויים של Gerrit בתיבת הקובץ/נתיב השינוי בראש העמוד (ראה איור 2).

קישור לשינוי לדוגמה: https://android-review.googlesource.com/c/platform/build/soong/+/1284176

הקבצים בשינוי נפתחים בחלונית העריכה (ראה איור 3).

אם השינוי כולל מספר קבצים, כל קובץ מופיע כלשונית בשורה שמעל לחלונית העריכה (ראה איור 4). לחץ על כרטיסייה כדי לפתוח את הקובץ בחלונית העריכה.

בצע את העריכות שלך

ערוך קבצים באמצעות חלונית עריכת הטקסט. קבצים שאתה עורך מופיעים ברשימת שינויים בהמתנה מתחת לחלונית העריכה. אם אתה סוגר בטעות את הכרטיסייה של קובץ עם עריכות, אתה יכול לפתוח מחדש את הקובץ עם העריכות שלמות על ידי לחיצה על שמו ברשימת שינויים בהמתנה.

שלח שינויים

אתה יוצר ומפרסם את השינוי שלך ל-Gerrit בעורך המקור של Git. לאחר מכן אתה עוקב אחר אישור השינוי ב-Gerrit.

צור ופרסם את השינויים

בצע את ההליך הזה כדי ליצור ולפרסם את השינויים שביצעת.

1. לחץ על הכפתור המתאים:

   • לחץ על צור שינוי אם אתה יוצר שינוי חדש.
   • לחץ על עדכן שינוי אם אתה מעדכן שינוי קיים.

   תיבת דו-שיח נפתחת.

   

   איור 5. תיבת דו-שיח צור שינוי

2. הזינו תיאור שינוי, שיהפוך לתיאור השינוי בחריט. תיאור זה נדרש. אם אתה עורך שינוי קיים, תוכל לערוך את התיאור שלו אם תרצה.

3. לחלופין, נקה או בחר את תיבת הסימון פרסם ביצירה .

   תיבה זו נבחרת כברירת מחדל.

   אם תיבה זו מסומנת בעת יצירת השינוי, השינוי יפורסם מיד ל-Gerrit. אם התיבה לא מסומנת, השינוי מועלה ל-Gerrit אך לא מפורסם.

4. לחץ על צור .

   השינוי מועלה ל-Gerrit. אם בחרת בתיבת הסימון פרסם ביצירה , השינוי יתפרסם גם ב-Gerrit. השינוי מקושר בהתראה בחלק העליון של המסך.

   

   איור 6. שינוי הודעה שנוצרה

עקוב אחר אישור שינוי בחריט

עקוב אחר סטטוס הגשת השינוי ישירות ב-Gerrit, כפי שהיית עושה כל שינוי אחר.

איור 7. מעקב אחר מצב הגשת שינוי ב- Gerrit

הצג הבדלי קבצים

בחר בתיבת הסימון Diff מתחת לחלונית העריכה כדי להציג את ההבדלים של העריכות שביצעת בקובץ הפעיל בחלונית העריכה. זה שימושי בעת שינוי קובץ ובעת עריכת שינוי קיים.

איור 8. הצגת הבדלי קבצים

החזר קבצים

ניתן לבטל שינויים מקובץ בודד או מכל הקבצים ברשימת השינויים הממתינים. שתי אפשרויות החזרה מחזירות שינויים רק בעורך המקור של Git. הם לא יעדכנו את השינוי ב-Gerrit.

החזר קובץ בודד

כדי להחזיר קובץ בודד, לחץ על ה- X לצד שם הקובץ ברשימת שינויים ממתינים.

איור 9. סעיף שינויים ממתינים

החזר את כל הקבצים

כדי להחזיר את כל הקבצים בבת אחת, לחץ על החזר את כל הקבצים מתחת לחלונית העריכה.

איור 10. לחצן החזר את כל הקבצים

תיבת דו-שיח קופצת נפתחת. לחץ על החזר הכל כדי לבטל שינויים בכל הקבצים הממתינים, או לחץ על ביטול כדי לשמור את השינויים ולהמשיך בעריכה.

איור 11. תיבת הדו-שיח החזר את כל הקבצים לאישור

ערוך דף ישירות מחיפוש קוד אנדרואיד

אתה יכול לפתוח קובץ ב-Git Source Editor ישירות מחיפוש קוד אנדרואיד . זה מועיל אם אתה צריך לאתר את הקובץ לפני עריכתו.

בצע את ההליך הזה כדי לערוך קובץ ישירות מחיפוש קוד אנדרואיד.

1. ב-Android Code Search (cs.android.com), נווט אל הקובץ שאתה מעוניין לערוך.

2. לחץ על ערוך קוד .

   

   איור 12. כפתור עריכת קוד של Android Code Search

   Git Source Editor נפתח עם הקובץ שנבחר מראש לעריכה.

3. בחר בענף Git שבו תרצה לערוך את הקובץ מהרשימה הנפתחת בחר ענף git , ולאחר מכן לחץ על בחר ענף .

   

   איור 13. בחירת ענף Git לעריכה

   הקובץ נפתח בחלונית העריכה.

4. המשך לערוך כמתואר בסעיף ביצוע העריכות שלך .

5. ניתן לפתוח קבצים נוספים לעריכה כמתואר בסעיף טעינת קבצים

לפתור קונפליקטים

כדי לפתור קונפליקטים:

1. בעורך המקור, נווט אל השינוי. לאחר טעינת השינוי, הקבצים המתנגשים מופיעים בחלק התחתון של המסך. לדוגמה, איור 14 מראה שלקובץ Android.pb יש התנגשות.

   

   איור 14. התנגשות עורך מקור

2. לחץ על קובץ מתנגש. הקובץ נטען ומציג בלוקים מתנגשים של תוכן ברצף ובתוך סמני Git ( <<<<<<< ו >>>>>>> ).

   

   איור 15. סמני קונפליקט של עורך מקור

3. תקן את ההתנגשות על ידי עריכת הקובץ והסרה ידנית של סמני ההתנגשות סביב התוכן שברצונך לשמור. כמו כן, הסר את התוכן ואת סמני ההתנגשות עבור תוכן שאינך רוצה לשמור.

4. לחץ על צור שינוי כדי ליצור שינוי חדש. תיבת הדו-שיח צור שינוי מופיעה.

   

   איור 16. צור שינוי

5. הקלד תיאור שינוי ולחץ על צור .

שלח משוב

השתמש בכפתור באג בפינה השמאלית העליונה כדי לספק משוב על עורך המקור של Git.

תיעוד קשור

• חיפוש קוד אנדרואיד