ملخص
يعد محرر Git source (ci.android.com/edit) أداة تعتمد على المتصفح لتحرير الملفات في مشروع Android مفتوح المصدر (AOSP) وتحميل التغييرات إلى Gerrit. إنه مخصص لإجراء تغييرات طفيفة على عدد صغير من الملفات، ويوفر سير عمل أسرع من تنزيل شجرة مصدر Android . يجب أن تكون على دراية بالعملية الكاملة لإرسال التغييرات إلى AOSP باستخدام Git وRepo وGerrit قبل استخدام محرر مصدر Git.
عندما تقوم بتحرير ملف باستخدام محرر مصدر Git، يتم كل العمل على جهازك المحلي، حتى تقوم بتحميل التغييرات لإنشاء قائمة تغييرات Gerrit.
تسجيل الدخول
- قم بتحميل محرر مصدر Git في المتصفح.
انقر فوق تسجيل الدخول لتسجيل الدخول إلى حسابك.
الشكل 1. زر تسجيل الدخول
تحرير الملفات والتغييرات
يحتوي Git Source Editor على مسارات العمل الرئيسية التالية:
- قم بتحرير ملف واحد أو أكثر من اختيارك، في الفرع الذي تختاره.
- تحرير التغيير. عندما تقوم بتحرير تغيير، تعتمد النتيجة على من قام بإنشاء التغيير:
- إذا قمت بإنشاء التغيير، فسيتم تصحيح تعديلات Git Source Editor الخاصة بك في التغيير كمجموعة تصحيح جديدة.
- إذا قام شخص آخر بإنشاء التغيير، فإن تعديلات Git Source Editor الخاصة بك ستنشئ تغييرًا جديدًا تملكه، بناءً على التغيير الذي قمت بتحميله.
قم بتحميل ما تريد تحريره
ابدأ جلسة تحرير عن طريق تحميل ملف أو تغيير.
تحميل الملفات
أدخل عنوان URL للملف الذي تريد تحريره في مربع مسار الملف/التغيير الموجود أعلى الصفحة.
نموذج مسار الملف: https://android.googlesource.com/platform/build/+show/refs/heads/main/Changes.md
انقر فوق تحميل الملف أو تغييره .
الشكل 2. تحميل ملف أو تغييره
يتم تحميل الملف في جزء المحرر. جزء التنقل الموجود على يسار جزء المحرر هو متصفح الملفات، الذي يفتح الريبو، مع تحميل ملفك مسبقًا.
الشكل 3. ملف تم تحميله في جزء التحرير
يمكنك استخدام جزء التنقل لفتح المزيد من الملفات داخل نفس الريبو. إذا قمت بفتح ملفات متعددة، فسيظهر كل ملف كعلامة تبويب في الصف أعلى جزء التحرير. انقر فوق علامة تبويب لفتح هذا الملف في جزء التحرير.
الشكل 4. علامات التبويب للملفات المحملة
تحميل التغيير
انتقل إلى التغيير الذي تريد تحريره عن طريق إدخال عنوان URL الخاص بقائمة تغييرات Gerrit في مربع مسار الملف/التغيير الموجود أعلى الصفحة (انظر الشكل 2).
رابط تغيير العينة: https://android-review.googlesource.com/c/platform/build/soong/+/1284176
يتم فتح الملفات الموجودة في التغيير في جزء التحرير (انظر الشكل 3).
إذا كان التغيير يتضمن ملفات متعددة، فسيظهر كل ملف كعلامة تبويب في الصف أعلى جزء التحرير (انظر الشكل 4). انقر فوق علامة تبويب لفتح هذا الملف في جزء التحرير.
قم بإجراء تعديلاتك
تحرير الملفات باستخدام جزء تحرير النص. تظهر الملفات التي تقوم بتحريرها في قائمة التغييرات المعلقة أسفل جزء التحرير. إذا قمت عن طريق الخطأ بإغلاق علامة تبويب ملف يحتوي على تعديلات، فيمكنك إعادة فتح الملف مع الحفاظ على التعديلات عن طريق النقر فوق اسمه في قائمة التغييرات المعلقة.
أرسل التغييرات
يمكنك إنشاء ونشر التغيير الخاص بك على Gerrit في Git Source Editor. ثم تقوم بتتبع الموافقة على التغيير في جيريت.
إنشاء ونشر التغييرات
اتبع هذا الإجراء لإنشاء ونشر التغييرات التي أجريتها.
انقر فوق الزر المناسب:
- انقر فوق إنشاء تغيير إذا كنت تقوم بإنشاء تغيير جديد.
- انقر فوق تحديث التغيير إذا كنت تقوم بتحديث تغيير موجود.
يتم فتح مربع حوار.
الشكل 5. إنشاء مربع حوار التغيير
أدخل وصف التغيير، والذي سيصبح وصف التغيير في Gerrit. هذا الوصف مطلوب. إذا كنت تقوم بتحرير تغيير موجود، فيمكنك تحرير الوصف الخاص به إذا أردت ذلك.
بشكل اختياري، قم بإلغاء تحديد خانة الاختيار نشر عند الإنشاء أو تحديدها.
يتم تحديد هذا المربع بشكل افتراضي.
إذا تم تحديد هذا المربع عند إنشاء التغيير، فسيتم نشر التغيير على الفور إلى Gerrit. إذا لم يتم تحديد المربع، فسيتم تحميل التغيير إلى Gerrit ولكن لن يتم نشره.
انقر فوق إنشاء .
يتم تحميل التغيير إلى Gerrit. إذا قمت بتحديد خانة الاختيار النشر عند الإنشاء ، فسيتم نشر التغيير أيضًا في Gerrit. يتم ربط التغيير في إشعار أعلى الشاشة.
الشكل 6. تغيير الإشعار الذي تم إنشاؤه
تتبع الموافقة على التغيير في Gerrit
تتبع حالة إرسال التغيير مباشرة في Gerrit، كما تفعل مع أي تغيير آخر.
الشكل 7. تتبع حالة تقديم التغيير في جيريت
عرض فروق الملف
حدد خانة الاختيار Diff أسفل جزء التحرير لعرض اختلافات التعديلات التي أجريتها على الملف النشط في جزء التحرير. يعد هذا مفيدًا عند تغيير ملف وعند تحرير تغيير موجود.
الشكل 8. عرض فروق الملف
استرجاع الملفات
يمكنك التراجع عن التغييرات من ملف واحد أو من جميع الملفات الموجودة في قائمة التغييرات المعلقة. يقوم كلا خياري التراجع بإرجاع التغييرات فقط في Git Source Editor. لن يقوموا بتحديث التغيير في Gerrit.
استرجاع ملف واحد
لإرجاع ملف واحد، انقر فوق X بجوار اسم الملف في قائمة التغييرات المعلقة.
الشكل 9. قسم التغييرات المعلقة
استرجاع كافة الملفات
لإرجاع كافة الملفات مرة واحدة، انقر فوق إرجاع كافة الملفات أسفل جزء التحرير.
الشكل 10. زر إرجاع كافة الملفات
يتم فتح مربع حوار منبثق. انقر فوق "إرجاع الكل" للتراجع عن التغييرات في جميع الملفات المعلقة، أو انقر فوق "إلغاء الأمر" للاحتفاظ بالتغييرات ومتابعة التحرير.
الشكل 11. مربع حوار تأكيد جميع الملفات
قم بتحرير صفحة مباشرة من بحث كود Android
يمكنك فتح ملف في Git Source Editor مباشرة من خلال البحث عن أكواد Android . يعد هذا مفيدًا إذا كنت بحاجة إلى تحديد موقع الملف قبل تحريره.
اتبع هذا الإجراء لتحرير ملف مباشرة من بحث كود Android.
في Android Code Search (cs.android.com)، انتقل إلى الملف الذي ترغب في تحريره.
انقر فوق تحرير التعليمات البرمجية .
الشكل 12. زر تحرير رمز Android Code Search
يتم فتح Git Source Editor مع الملف المحدد مسبقًا للتحرير.
حدد فرع Git الذي تريد تحرير الملف فيه من القائمة المنسدلة تحديد فرع git ، ثم انقر فوق اختيار فرع .
الشكل 13. تحديد فرع Git لتحريره
يتم فتح الملف في جزء التحرير.
استمر في التحرير كما هو موضح في قسم إجراء تعديلاتك .
يمكنك فتح ملفات إضافية لتحريرها كما هو موضح في قسم تحميل الملفات
حل النزاعات
لحل الصراعات:
في محرر المصدر، انتقل إلى التغيير. بعد تحميل التغيير، يتم إدراج الملفات المتعارضة في الجزء السفلي من الشاشة. على سبيل المثال، يوضح الشكل 14 أن ملف
Android.pbبه تعارض.
الشكل 14. تعارض محرر المصدر
انقر فوق ملف متعارض. يتم تحميل الملف وعرض كتل المحتوى المتعارضة بالتتابع وداخل علامات Git (
<<<<<<<و>>>>>>>).
الشكل 15. علامات تعارض محرر المصدر
قم بإصلاح التعارض عن طريق تحرير الملف وإزالة علامات التعارض يدويًا حول المحتوى الذي تريد الاحتفاظ به. قم أيضًا بإزالة المحتوى وعلامات التعارض للمحتوى الذي لا تريد الاحتفاظ به.
انقر فوق "إنشاء تغيير" لإنشاء تغيير جديد. يظهر مربع الحوار "إنشاء تغيير".
الشكل 16. إحداث التغيير
اكتب وصفًا للتغيير، ثم انقر فوق "إنشاء" .
ارسل رأيك
استخدم زر الخطأ 
في الزاوية اليمنى العليا لتقديم تعليقات حول Git Source Editor.