نظرة عامة على المنتج
إنّ واجهة البحث في الرموز وتصفُّح المصدر في Bazel أداة مستندة إلى الويب من أجل تصفّح مستودعات رموز Bazel المصدر. يمكنك استخدام هذه الميزات للتنقل بين المستودعات والفروع والملفات. ويمكنك أيضًا عرض معلومات السجلّ والفِرَق لتوجيه اللوم.
البدء
للوصول إلى واجهة البحث عن الرموز وواجهة التصفّح، افتح https://source.bazel.build في متصفّح الويب.
ستظهر الشاشة الرئيسية. تحتوي هذه الشاشة على المكونات التالية:
شريط أدوات شريط التنقُّل. ويعرض شريط الأدوات هذا موقعك الجغرافي الحالي في المستودع، ويتيح لك الانتقال بسرعة إلى موقع آخر، مثل مستودع آخر، أو موقع آخر ضمن مستودع، مثل ملف أو فرع أو التزام.
قائمة بالمستودعات التي يمكنك تصفحها.
في أعلى الشاشة، سيظهر مربّع بحث. ويمكنك استخدام هذا المربّع للبحث عن ملفات ورموز محدّدة.
العمل مع المستودعات
فتح مستودع
لفتح مستودع، انقر على اسمه من الشاشة الرئيسية.
يمكنك أيضًا استخدام شريط أدوات شريط التنقّل للعثور على مستودع معيّن. ويعرض شريط الأدوات هذا موقعك الجغرافي الحالي في المستودع، ويتيح لك الانتقال بسرعة إلى موقع آخر، مثل مستودع آخر، أو موقع آخر ضمن مستودع، مثل ملف أو فرع أو التزام.
تبديل المستودعات
للتبديل إلى مستودع آخر، اختَر المستودع من شريط أدوات شريط التنقُّل.
عرض مستودع في تاريخ معيّن
لعرض مستودع في عملية تنفيذ مُحدَّدة:
- من عرض المستودع، اختَر الملف.
- من شريط أدوات شريط التنقل، افتح قائمة الفرع.
- في القائمة الفرعية التي تظهر، انقر على الالتزام.
- اختَر المعاملة التي تريد عرضها.
وتُظهر الواجهة الآن المستودع كما كان متوفّرًا في ذلك البرنامج.
فتح فرع أو إتمام أو وضع علامة
بشكل تلقائي، تفتح واجهة البحث عن الرموز وتصفّح المصدر مستودعًا للفرع التلقائي. لفتح فرع مختلف، من شريط أدوات شريط التنقّل، انقر على قائمة الفرع/الالتزام/العلامة. يتم فتح قائمة فرعية تتيح لك اختيار أحد الفروع باستخدام اسم الفرع، أو اسم علامة، أو من خلال مربع بحث.
- لاختيار الفرع باستخدام اسم الفرع، اختر الفرع، ثم انقر على اسم الفرع.
- لاختيار فرع باستخدام اسم علامة، اختَر العلامة، ثم انقر على اسم العلامة.
- لاختيار فرع باستخدام معرّف إتمام، اختر عمولة، ثم انقر على معرّف العمولة.
- للبحث عن فرع أو الالتزام أو العلامة، حدد العنصر ذي الصلة واكتب عبارة البحث في مربع البحث.
التعامل مع الملفات
عند اختيار مستودع من الشاشة الرئيسية، تتغير الشاشة لعرض طريقة عرض لهذا المستودع. إذا كان ملف README متوفّرًا، سيظهر محتواه في جزء الملف، على الجانب الأيسر من الشاشة. وإلّا، ستظهر قائمة بملفات ومجلدات المستودع. في الجانب الأيمن من الشاشة، يمكنك رؤية العرض التدرّجي لملفات ومجلدات المجلد. ويمكنك استخدام هذه الشجرة لتصفح ملفات محددة وفتحها.
تجدر الإشارة إلى أنه عند عرض مستودع، يحتوي شريط أدوات شريط التنقل الآن على ثلاثة مكونات:
- قائمة مستودع يمكنك من خلالها اختيار مستودعات مختلفة
- قائمة فرع/عمولة/علامة يمكنك من خلالها اختيار فروع أو علامات أو التزامات معيّنة
- مربّع مسار ملف يعرض اسم الملف أو المجلد الحالي والمسار المطابق له
فتح ملف
يمكنك فتح ملف من خلال التصفُّح إلى دليله واختياره. تُعد طريقة عرض تحديثات المستودع لعرض محتوى الملف في جزء الملف، وموقعه في المستودع في جزء الشجرة.
عرض تغييرات الملف
لعرض التغييرات في الملف:
- من عرض المستودع، اختَر الملف.
- انقر على بلام في الجانب العلوي الأيسر.
يتم تحديث لوحة الملف لعرض الأشخاص الذين أجروا التغييرات على الملف ووقت إجراء ذلك.
عرض سجلّ التغييرات
لعرض سجلّ التغييرات لأحد الملفات:
- من عرض المستودع، اختَر الملف.
- انقر على السجلّ، في أعلى يسار الصفحة. سيظهر جزء سجلّ التغييرات الذي يعرض العمليات في هذا الملف.
عرض مراجعات الرمز
بالنسبة إلى مراجعات رمز Gerrit، يمكنك فتح الأداة مباشرةً من لوحة "سجلّ التغييرات".
للاطّلاع على مراجعة الرمز لملف:
- من عرض المستودع، اختَر الملف.
- انقر على السجلّ، في أعلى يسار الصفحة. يظهر جزء "سجلّ التغييرات" الذي يعرض عمليات التنفيذ لهذا الملف.
- مرِّر مؤشر الماوس فوق عملية إتمام. سيظهر زر المزيد (ثلاث نقاط رأسية).
- انقر على الزر المزيد.
- اختَر عرض مراجعة الرمز.
يتم فتح أداة Gerrit Code Review في نافذة متصفح جديدة.
فتح ملف في عملية تنفيذ محدّدة
لفتح ملف في عملية تنفيذ مُحدَّدة:
- من عرض المستودع، اختَر الملف.
- انقر على السجلّ، في أعلى يسار الصفحة. يظهر جزء "سجلّ التغييرات" الذي يعرض عمليات التنفيذ لهذا الملف.
- مرِّر مؤشر الماوس فوق عملية إتمام. سيظهر الزر عرض.
- انقر على الزر عرض.
مقارنة ملف باتفاقية أخرى
لمقارنة ملف في تنفيذ مختلف:
- من عرض المستودع، اختَر الملف. لإجراء مقارنة من تنفيذَين مختلفَين، افتح أولاً الملف عند تنفيذ ذلك الإجراء.
- مرِّر مؤشر الماوس فوق عملية إتمام. سيظهر الزر الفرق.
- انقر على الزر فرق.
يتم تحديث لوحة الملف لعرض مقارنة جنبًا إلى جنب بين الملفين. أما العنصران الأقدم، فهما دائمًا في الجهة اليسرى.
في لوحة "سجلّ التغييرات"، يتم تمييز كلٍّ من الالتزامين، ويشير التصنيف إلى ما إذا كان التنفيذ معروضًا على يمين الصفحة أو على يساره.
لتغيير أي من الملفين، مرِّر مؤشر الماوس فوق إتمام في لوحة "سجل التغييرات". بعد ذلك، انقر على الزر لليسار أو لليمين لفتح الفتح على الجانب الأيسر أو الأيمن من الفرق.
الإحالات المرجعية المتبادلة
هناك طريقة أخرى لتصفح مستودعات المصدر وهي استخدام مراجع متبادلة. وتظهر هذه المراجع تلقائيًا كروابط تشعّبية ضمن ملف مصدر معيّن.
لتسهيل تحديد المراجع المتبادلة، انقر على المراجع المتبادلة، في أعلى يسار الصفحة. يعرض هذا الخيار تسطيرًا أسفل كل الإحالات في ملف.
ملاحظة: إذا كانت المراجع المتبادلة غير متاحة، يدلّ ذلك على أنّ المراجع المتعددة غير متوفّرة لهذا الملف.
انقر على الإشارة المرجعية لفتح لوحة الإحالة المرجعية. يحتوي هذا الجزء على قسمين:
- قسم التعريف، والذي يعرض الملف أو الملفات التي تحدد المرجع
- قسم المراجع الذي يعرض الملفات التي يظهر فيها المرجع أيضًا
يعرض كلا القسمين اسم الملف، فضلاً عن السطر أو السطور التي تحتوي على المرجع. لفتح ملف من لوحة "المرجع المتبادل"، انقر على إدخال رقم السطر. يظهر الملف في قسم جديد من اللوحة، يسمح لك بمواصلة تصفُّح الملف مع الاستمرار في عرض الملف الأصلي.
يمكنك الاستمرار في تصفُّح المراجع المشتركة باستخدام لوحة "المراجع المتبادلة"، مثلما يمكنك فعل ذلك في لوحة "الملفات". عند إجراء ذلك، يعرض الجزء مسار شريط تنقّل، يمكنك استخدامه للتنقل بين مراجع مختلفة.
جارٍ البحث عن الرمز
يمكنك البحث عن ملفات أو مقتطفات رموز معيّنة باستخدام مربّع البحث في أعلى الشاشة. عمليات البحث هي دائمًا مقابل الفرع التلقائي.
تستخدم جميع عمليات البحث RE2 التعبيرات العادية بشكل تلقائي. إذا كنت لا تريد استخدام التعبيرات العادية، يمكنك تضمين البحث بين علامتي اقتباس ( " ).
ملاحظة: للبحث عن ملف محدّد بسرعة، يمكنك إضافة شرطة مائلة للخلف قبل النقطة أو تضمين اسم الملف بالكامل بين علامتَي اقتباس.
foo\.java
"foo.java"
يمكنك تحسين البحث باستخدام الفلاتر التالية.
| الفلتر | خيارات أخرى | الوصف | مثال |
|---|---|---|---|
| lang: | اللغة: | إجراء مطابقة تامة حسب لغة الملف | اختبار lang:java |
| الملف: | مسار الملف: المسار: f: |
||
| الحالة:نعم | حسِّن حالة البحث. بشكل تلقائي، لا تكون عمليات البحث حساسة لحالة الأحرف. | case:yes مرحبًا العالم | |
| الفئة: | ابحث عن اسم للصف الدراسي. | class:MainClass | |
| الدالة: | فانك: | ابحث عن اسم دالة. | function:print |
| - | ينفّذ العبارة من البحث. | مرحبًا - العالم | |
| \ | يتم إفلات الأحرف الخاصة، مثل . أو \ أو (. | تنفيذ\(\) | |
| "[العبارة]" | نفِّذ عملية بحث حرفية. | "class:main" (الفئة:الرئيسي) |
خدمات الدعم الإضافية
للإبلاغ عن مشكلة، انقر على زر التعليقات الذي يظهر في أعلى يسار الشاشة وأدخِل تعليقاتك في النموذج المقدّم.