محرر مصدر Git

نظرة عامة

محرر مصدر Git (ci.android.com/edit) هو أداة مستندة إلى المتصفّح لتعديل الملفات في "المشروع المفتوح المصدر لنظام Android" (AOSP) وتحميل التغييرات إلى Gerrit. وهو مخصّص لإجراء تغييرات بسيطة على عدد صغير من الملفات، ويوفّر سير عمل أسرع من تنزيل شجرة مصدر Android. يجب أن تكون على دراية بالعملية الكاملة لإرسال التغييرات إلى AOSP باستخدام Git وRepo وGerrit قبل استخدام محرِّر مصدر Git.

عند تعديل ملف باستخدام محرِّر مصدر Git، يتم تنفيذ جميع الإجراءات على جهازك المحلي إلى أن تحمِّل التغييرات لإنشاء قائمة تغييرات Gerrit.

تحذير: بما أنّ التغييرات يتم تخزينها في المتصفّح فقط، ستفقدها إذا أعدنا تحميل علامة التبويب في المتصفّح أو أغلقناها قبل تحميلها.

تسجيل الدخول

1. حمِّل Git Source Editor في متصفّح.

2. انقر على تسجيل الدخول لتسجيل الدخول إلى حسابك.

   ملاحظة: تأكَّد من تسجيل الدخول باستخدام الحساب الذي يمتلك امتيازات Gerrit للملفّات التلقائية التي تريد تعديلها.

   

   الشكل 1: زر تسجيل الدخول

تعديل الملفات والتغييرات

يتضمّن "محرِّر مصدر Git" سير العمل الرئيسية التالية:

• عدِّل ملفًا واحدًا أو أكثر من اختيارك في الفرع الذي تختاره.
• تعديل تغيير عند تعديل تغيير، تعتمد النتيجة على مَن أنشأ التغيير:
  • إذا أنشأت التغيير، سيتم تصحيح تعديلات "محرر مصدر Git" في التغيير كمجموعة تصحيحات جديدة.
  • إذا أنشأ شخص آخر التغيير، يؤدي تعديل "محرر مصدر Git" إلى إنشاء تغيير جديد تملكه، استنادًا إلى التغيير الذي حمّلته.

تحميل ما تريد تعديله

ابدأ جلسة تعديل من خلال تحميل ملف أو تغيير.

تحميل الملفات

1. أدخِل عنوان URL للملف الذي تريد تعديله في مربّع الملف/تغيير المسار في أعلى الصفحة.

   نموذج لمسار الملف: https://android.googlesource.com/platform/build/+show/refs/heads/main/Changes.md

2. انقر على تحميل ملف أو تغيير.

   

   الشكل 2: تحميل ملف أو إجراء تغيير

   يتم تحميل الملف في لوحة المحرِّر. لوحة التنقّل على يمين لوحة المحرِّر هي متصفّح ملفات يفتح المستودع مع تحميل ملفك مسبَقًا.

   

   الشكل 3: ملف تم تحميله إلى لوحة التعديل

ملاحظة: احرص على اتّباع الخطوات المتبقية لإرسال طلبك قبل إعادة تحميل أو إغلاق علامة تبويب المتصفّح. بما أنّ الملفات المعدَّلة يتم تخزينها على جهازك،

يؤدي تحديث علامة تبويب المتصفّح أو إغلاقها إلى فقدان أي تغييرات أجريتها.

يمكنك استخدام لوحة التنقّل لفتح المزيد من الملفات ضمن المستودع نفسه. إذا فتحت عدة ملفات، سيظهر كل ملف كعلامة تبويب في الصف أعلى pane التعديل. انقر على علامة تبويب لفتح هذا الملف في لوحة التعديل.

الشكل 4: علامات التبويب للملفات المحمَّلة

تحميل تغيير

انتقِل إلى التغيير الذي تريد تعديله عن طريق إدخال عنوان URL لقائمة تغييرات Gerrit في مربّع مسار الملف/التغيير في أعلى الصفحة (راجِع الشكل 2).

نموذج رابط التغيير: https://android-review.googlesource.com/c/platform/build/soong/+/1284176

يتم فتح الملفات في التغيير في لوحة التعديل (راجِع الشكل 3).

إذا كان التغيير يتضمّن عدة ملفات، يظهر كل ملف كعلامة تبويب في الصف فوق لوحة التعديل (راجِع الشكل 4). انقر على علامة تبويب لفتح هذا الملف في لوحة التعديل.

ملاحظة: احرص على اتّباع الخطوات المتبقية لإرسال طلبك قبل إعادة تحميل أو إغلاق علامة تبويب المتصفّح. بما أنّ الملفات المعدَّلة يتم تخزينها على جهازك،

يؤدي تحديث علامة تبويب المتصفّح أو إغلاقها إلى فقدان أي تغييرات أجريتها.

إجراء التعديلات

تعديل الملفات باستخدام لوحة تعديل النصوص تظهر الملفات التي تعدّلها في قائمة التغييرات في انتظار المراجعة أسفل لوحة التعديل. إذا أغلقت عن طريق الخطأ علامة تبويب ملف يحتوي على تعديلات، يمكنك إعادة فتح الملف مع الاحتفاظ بالتعديلات من خلال النقر على اسمه في قائمة "التغييرات في انتظار المراجعة".

إرسال التغييرات

يمكنك إنشاء التغيير ونشره في Gerrit في "محرِّر مصادر Git". بعد ذلك، يمكنك متابعة الموافقة على التغيير في Gerrit.

إنشاء التغييرات ونشرها

اتّبِع هذه الخطوات لإنشاء التغييرات التي أجريتها ونشرها.

1. انقر على الزر المناسب:

   • انقر على إنشاء تغيير إذا كنت بصدد إنشاء تغيير جديد.
   • انقر على تعديل التغيير إذا كنت بصدد تعديل تغيير حالي.

   سيظهر مربّع حوار.

   

   الشكل 5: مربّع الحوار "إنشاء تغيير"

2. أدخِل وصفًا للتغيير، وسيصبح وصف التغيير في Gerrit. هذا الوصف مطلوب. إذا كنت تعدّل تغييرًا حاليًا، يمكنك تعديل وصفه إذا أردت.

3. يمكنك اختياريًا وضع علامة في مربّع الاختيار النشر عند الإنشاء أو إزالتها.

   يتم وضع علامة في هذا المربّع تلقائيًا.

   في حال وضع علامة في هذا المربّع عند إنشاء التغيير، يتم نشر التغيير على Gerrit على الفور. في حال عدم وضع علامة في المربّع، يتم uploadتحميل التغيير إلى Gerrit ولكن لا يتم نشره.

4. انقر على إنشاء.

   يتم تحميل التغيير إلى Gerrit. إذا حدّدت مربّع الاختيار النشر عند الإنشاء ، يتم أيضًا نشر التغيير في Gerrit. يتم ربط التغيير في إشعار في أعلى الشاشة.

   

   الشكل 6: تغيير الإشعار الذي تم إنشاؤه

تتبُّع الموافقة على التغيير في Gerrit

يمكنك تتبُّع حالة إرسال التغييرات مباشرةً في Gerrit، كما يمكنك تتبُّع أي تغيير آخر.

الشكل 7: تتبُّع حالة إرسال التغييرات في Gerrit

عرض الاختلافات في الملفات

ضَع علامة في مربّع الاختيار الاختلاف أسفل لوحة التعديل للاطّلاع على الاختلافات في التعديلات التي أجريتها على الملف النشط في لوحة التعديل. يكون ذلك مفيدًا عند تغيير ملف وعند تعديل تغيير حالي.

الشكل 8: عرض الاختلافات في الملفات

إعادة الملفات إلى حالتها الأصلية

يمكنك التراجع عن التغييرات من ملف واحد أو من جميع الملفات في قائمة التغييرات في انتظار المراجعة. لا يؤدي كلا خيارَي التراجع إلى التراجع عن التغييرات إلا في "محرر مصدر Git". لن يتم تعديل التغيير في Gerrit.

التراجع عن ملف واحد

لإلغاء تغييرات ملف واحد، انقر على X بجانب اسم الملف في قائمة التغييرات في انتظار المراجعة.

الشكل 9: قسم "التغييرات المعلّقة"

إلغاء كل التغييرات في جميع الملفات

لإعادة جميع الملفات في آنٍ واحد، انقر على إعادة جميع الملفات أسفل لوحة التعديل.

الشكل 10: زر "إلغاء جميع التغييرات في الملفات"

سيظهر مربّع حوار منبثق. انقر على التراجع عن الكل للتراجع عن التغييرات في جميع الملفات المعلّقة، أو انقر على إلغاء للاحتفاظ بالتغييرات ومواصلة التعديل.

الشكل 11: مربّع حوار تأكيد إعادة جميع الملفات

تعديل صفحة مباشرةً من خلال البحث عن الرموز البرمجية في Android

يمكنك فتح ملف في "محرِّر مصدر Git" مباشرةً من بحث الرموز البرمجية في Android. يكون ذلك مفيدًا إذا كنت بحاجة إلى تحديد موقع الملف قبل تعديله.

اتّبِع هذا الإجراء لتعديل ملف مباشرةً من خلال البحث عن الرموز البرمجية في Android.

1. في أداة "بحث الرموز البرمجية لنظام التشغيل Android" (cs.android.com)، انتقِل إلى الملف الذي تريد تعديله.

2. انقر على تعديل الرمز.

   

   الشكل 12: زر تعديل الرمز في أداة Android Code Search

   يتم فتح "محرِّر مصدر Git" مع اختيار الملف مسبقًا للتعديل.

3. اختَر فرع Git الذي تريد تعديل الملف فيه من القائمة المنسدلة اختيار ملف برمجي git، ثم انقر على اختيار فرع.

   

   الشكل 13: اختيار فرع Git لتعديله

   يتم فتح الملف في لوحة التعديل.

4. واصِل التعديل كما هو موضّح في قسم إجراء التعديلات.

5. يمكنك فتح ملفات إضافية لتعديلها كما هو موضّح في قسم تحميل الملفات.

حلّ التعارضات

لحلّ التعارضات:

1. في "محرر المصدر"، انتقِل إلى التغيير. بعد تحميل التغيير، يتم إدراج الملفات المتعارضة في الجزء السفلي من الشاشة. على سبيل المثال، يوضّح الشكل 14 أنّ هناك تعارضًا في ملفAndroid.pb.

   

   الشكل 14: تعارض في محرِّر المصدر

2. انقر على ملف متضارب. يتم تحميل الملف وعرض مجموعات متضاربة من المحتوى بالتتابع وضمن علامات Git (<<<<<<< و>>>>>>>).

   

   الشكل 15: علامات تعارض محرِّر المصدر

3. يمكنك حلّ التعارض عن طريق تعديل الملف وإزالة علامات التعارض يدوياً حول المحتوى الذي تريد الاحتفاظ به. وأزِل أيضًا المحتوى وعلامات التعارض للمحتوى الذي لا تريد الاحتفاظ به.

4. انقر على إنشاء تغيير لإنشاء تغيير جديد. يظهر مربّع الحوار Create Change (إنشاء تغيير).

   

   الشكل 16: إنشاء تغيير

5. اكتب وصفًا للتغيير وانقر على إنشاء.

إرسال ملاحظات

استخدِم زر الإبلاغ عن الخطأ في أعلى يسار الصفحة لتقديم ملاحظات حول "محرِّر مصدر Git".

المستندات ذات الصلة

• البحث عن الرموز البرمجية لنظام التشغيل Android