סקירה כללית של המוצר
ממשק חיפוש המקור והגלישה של Bazel הוא כלי מבוסס-אינטרנט לגלישה במאגרי קוד של Bazel. ניתן להשתמש בתכונות אלו כדי לנווט בין מאגרים, סניפים וקבצים שונים. תוכלו גם להציג היסטוריה, הבדלים ומידע על האשמה.
איך מתחילים
כדי לגשת לממשק חיפוש הקוד והגלישה במקור, נכנסים אל https://source.bazel.build בדפדפן האינטרנט.
המסך הראשי מופיע. מסך זה מכיל את הרכיבים הבאים:
סרגל הכלים של מיקומים באתר. סרגל הכלים הזה מציג את המיקום הנוכחי שלך במאגר ומאפשר לך לעבור במהירות למיקום אחר, כגון מאגר אחר או למיקום אחר בתוך מאגר נתונים, כגון קובץ, סניף או עמלות.
רשימת מאגרים שניתן לעיין בהם.
בראש המסך מופיעה תיבת חיפוש. תוכלו להשתמש בתיבה הזו כדי לחפש קבצים וקוד ספציפיים.
עבודה עם מאגרים
פתיחת מאגר
כדי לפתוח מאגר, לוחצים על שמו במסך הראשי.
לחלופין, תוכלו להשתמש בסרגל הכלים של מיקומים באתר כדי לחפש מאגר ספציפי. סרגל הכלים הזה מציג את המיקום הנוכחי שלך במאגר ומאפשר לך לעבור במהירות למיקום אחר, כגון מאגר אחר או למיקום אחר בתוך מאגר נתונים, כגון קובץ, סניף או עמלות.
מעבר בין מאגרים
כדי לעבור למאגר אחר, בוחרים את המאגר מסרגל הכלים Breadcrumb.
צפייה במאגר נתונים עם התחייבות ספציפית
כדי להציג מאגר נתונים במסגרת התחייבות ספציפית:
- בתצוגת המאגר, בוחרים את הקובץ.
- בסרגל הכלים 'נתיבי ניווט', פותחים את התפריט סניף.
- בתפריט המשנה שמופיע, לוחצים על התחייבות.
- בוחרים את המחויבות שרוצים להציג.
מעכשיו, הממשק מציג את המאגר כפי שהוא היה קיים באותה מחויבות.
פתיחת סניף, התחייבות או תג
כברירת מחדל, ממשק חיפוש המקור והגלישה המקור פותח מאגר נתונים אל הסתעפות ברירת המחדל. כדי לפתוח סניף אחר, בסרגל הכלים 'נתיבי ניווט', לוחצים על התפריט סניף/התחייבות/תג. נפתח תפריט משנה, ובו ניתן לבחור סניף באמצעות שם סניף, שם תג או באמצעות תיבת חיפוש.
- כדי לבחור סניף באמצעות שם סניף, בוחרים באפשרות סניף ולאחר מכן לוחצים על שם הסניף.
- כדי לבחור סניף באמצעות שם תג, בוחרים באפשרות תג ולאחר מכן לוחצים על שם התג.
- כדי לבחור סניף באמצעות מזהה עמלה, בוחרים באפשרות התחייבות ולאחר מכן לוחצים על מזהה העמלה.
- כדי לחפש סניף, התחייבות או תג, יש לבחור את הפריט התואם ולהקליד מונח חיפוש בתיבת החיפוש.
עבודה עם קבצים
כשבוחרים מאגר נתונים מהמסך הראשי, המסך משתנה כדי להציג תצוגה של המאגר. אם קיים קובץ README, התוכן שלו מופיע בחלונית הקבצים, בצד שמאל של המסך. אחרת, תופיע רשימה של קבצים ותיקיות של המאגר. בצד ימין של המסך מופיעה תצוגת עץ של הקבצים והתיקיות שבמאגר. ניתן להשתמש בעץ הזה כדי לדפדף ולפתוח קבצים ספציפיים.
שימו לב שכאשר אתם מציגים מאגר נתונים, סרגל הכלים של מיקומים באתר כולל כעת שלושה רכיבים:
- תפריט מאגר שממנו אפשר לבחור מאגרים שונים
- תפריט סניף/התחייבות/תג, שממנו אפשר לבחור סניפים, תגיות או תחומים ספציפיים
- תיבה של נתיב הקובץ. הקובץ מציג את שם הקובץ או התיקייה הנוכחיים, ואת הנתיב התואם.
פתיחת קובץ
ניתן לפתוח קובץ על ידי גלישה לספרייה שלו ובחירה בו. התצוגה של המאגר מתעדכנת כדי להציג את תוכן הקובץ בחלונית הקובץ, ואת המיקום שלו במאגר בחלונית העץ.
הצגת שינויים בקובץ
כדי להציג את השינויים בקובץ:
- בתצוגת המאגר, בוחרים את הקובץ.
- לוחצים על BLAME בפינה השמאלית העליונה.
חלונית הקובץ מתעדכנת ומציגה מי ביצע שינויים בקובץ ומתי.
הצגת היסטוריית השינויים
כך מציגים את היסטוריית השינויים של קובץ:
- בתצוגת המאגר, בוחרים את הקובץ.
- לוחצים על היסטוריה בפינה השמאלית העליונה. החלונית היסטוריית שינויים תופיע ותציג את ההתחייבויות של הקובץ הזה.
הצגת בדיקות הקוד
כדי לקבל ביקורות של קוד Gerrit, אפשר לפתוח את הכלי ישירות מהחלונית 'היסטוריית שינויים'.
כדי להציג את בדיקת הקוד של קובץ:
- בתצוגת המאגר, בוחרים את הקובץ.
- לוחצים על היסטוריה בפינה השמאלית העליונה. החלונית 'היסטוריית שינויים' מופיעה ומציגה את המחויבות של הקובץ הזה.
- מעבירים את העכבר מעל להתחייבות. לחצן עוד (שלוש נקודות אנכיות) מופיע.
- לוחצים על הלחצן עוד.
- בוחרים באפשרות הצגת בדיקת הקוד.
הכלי 'סקירת קוד Gerrit' נפתח בחלון דפדפן חדש.
פתיחת קובץ עם התחייבות ספציפית
כדי לפתוח קובץ עם התחייבות ספציפית:
- בתצוגת המאגר, בוחרים את הקובץ.
- לוחצים על היסטוריה בפינה השמאלית העליונה. החלונית 'היסטוריית שינויים' מופיעה ומציגה את המחויבות של הקובץ הזה.
- מעבירים את העכבר מעל להתחייבות. לחצן תצוגה מפורטת מופיע.
- לוחצים על הלחצן הצגה.
השוואה בין קבצים להתחייבות אחרת
כדי להשוות קובץ עם התחייבות אחרת:
- בתצוגת המאגר, בוחרים את הקובץ. כדי להשוות בין שתי מחויבויות שונות, פותחים תחילה את הקובץ עם אותה התחייבות.
- מעבירים את העכבר מעל להתחייבות. הלחצן הבדל יופיע.
- לוחצים על הלחצן הבדל.
חלונית הקובץ מתעדכנת ומציגה השוואה בין שני הקבצים. הישן מבין שני ההתחייבויות נמצא תמיד משמאל.
בחלונית 'היסטוריית שינויים', שתי ההתחייבויות מודגשות ותווית מציינת אם העמלה מוצגת בצד שמאל או בצד ימין.
כדי לשנות אחד מהקבצים, מעבירים את העכבר מעל 'אישור' בחלונית 'היסטוריית השינויים'. לאחר מכן, לוחצים על הלחצן שמאלה או על הלחצן ימינה כדי לפתוח את ההתחייבות בצד שמאל או ימין של ההבדל.
עיון בהפניות צולבות
דרך נוספת לעיין במאגרי מקורות היא באמצעות הפניות צולבות. קובצי העזר מופיעים אוטומטית כהיפר-קישורים בקובץ מקור.
כדי להקל על הזיהוי של הפניות צולבות, לוחצים על הפניות צולבות, שממוקם בפינה השמאלית העליונה. אפשרות זו מציגה קו תחתון מתחת לכל הפניות שמופיעות בקובץ.
הערה: אם האפשרות 'הפניות צולבות' מופיעה באפור, פירוש הדבר שהפניות שונות אינן זמינות לקובץ זה.
לוחצים על הצלבת נתונים כדי לפתוח את החלונית Cross Cross. חלונית זו מכילה שני קטעים:
- קטע הגדרה, המפרט את הקובץ או הקבצים שמגדירים את ההפניה
- קטע קובצי עזר המפרט את הקבצים שבהם מופיע גם קובץ העזר
שני הקטעים מציגים את שם הקובץ, וכן את השורה או השורות שמכילות את ההפניה. כדי לפתוח קובץ מהחלונית 'צלב', לוחצים על הערך של מספר השורה. הקובץ מופיע בקטע חדש בחלונית, והוא מאפשר לכם להמשיך לעיין בקובץ ולשמור את הקובץ המקורי בתצוגה.
ניתן להמשיך לעיין בהפניות צולבות באמצעות חלונית הפניות צולבות, בדיוק כפי שניתן לעשות בחלונית 'קובץ'. כאשר תעשו זאת, החלונית תציג סימן דרך, שבו תוכלו להשתמש כדי לנווט בין הפניות שונות.
המערכת מחפשת קוד
ניתן לחפש קבצים ספציפיים או קטעי קוד באמצעות תיבת החיפוש הממוקמת בחלק העליון של המסך. החיפושים נמצאים תמיד מול ענף ברירת המחדל.
כל החיפושים משתמשים בביטויים רגולריים מסוג RE2 כברירת מחדל. אם אינך רוצה להשתמש בביטויים רגולריים, הקף את החיפוש במרכאות כפולות ( " ).
הערה: כדי לחפש במהירות קובץ ספציפי, יש להוסיף לוכסן הפוך לפני הנקודה, או להקיף את שם הקובץ כולו במירכאות.
foo\.java
"foo.java"
אפשר לצמצם את החיפוש באמצעות המסננים הבאים.
| סינון | אפשרויות נוספות | תיאור | דוגמה |
|---|---|---|---|
| lang: | שפה: | ביצוע התאמה מדויקת לפי שפת הקובץ. | בדיקה של Java:Java |
| file: | filepath: נתיב: f: |
||
| Case:yes | הפיכת תיבת החיפוש לדוגמה רגישה. כברירת מחדל, חיפושים אינם תלויי אותיות רישיות. | case:yes Hello World | |
| מחלקה: | מחפשים שם לכיתה. | class:MainClass | |
| פונקציה: | Func: | מחפשים שם של פונקציה. | function:print |
| - | מבטל את מונח החיפוש. | שלום -עולם | |
| \ | הוספת תווי escape מיוחדים, כמו ., \, או (. | הפעלה\(\) | |
| "[מונח]" | ביצוע חיפוש מילולי. | "class:main" |
תמיכה נוספת
כדי לדווח על בעיה, לוחצים על הלחצן משוב שמופיע בפינה השמאלית העליונה של המסך ומזינים את המשוב בטופס שסופק.