עורך מקור של 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, כפי שהיית עושה כל שינוי אחר.

מעקב אחר סטטוס הגשת שינוי ב-Gerrit

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

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

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

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

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

החזר קבצים

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

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

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

מדור שינויים בהמתנה

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

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

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

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

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

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

הפוך את כל הקבצים לאישור תיבת הדו-שיח

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

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

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

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

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

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

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

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

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

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

    בחירת ענף Git לעריכה

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

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

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

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

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

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

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

    עימות עורך מקור

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

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

    סמני קונפליקט

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

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

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

    ליצור שינוי

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

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

שלח משוב

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