مراجعة طلب سحب ودمجه

يبيّن هذا الدليل كيف تراجع طلب سحب وتدمجه.

افتح منضدة طلب السحب

انتقل إلى طلبات السحب في الشريط الجانبي
اختر طلب سحب من القائمة

يُفتح طلب السحب منضدةً ذات ألسنة، لا صفحة واحدة. تُفتح خمسة ألسنة افتراضيًا، بهذا الترتيب: نظرة عامة، الفروق، إدارة المصادر، الدردشة وإجراءات (فحوصات CI مجمّعة حسب سير العمل). لسان مراجعة — تقدّم خط أنابيب المراجعة، ثم المُخرَج الذي نشره مع شريط نتائجه — ليس من هذه الخمسة عمدًا: لا مراجعة لطلب السحب حتى يطلبها أحد، واسأل الذكاء الاصطناعي هو ما يفتح اللسان. الطرفية، ومحرّر الملف الواحد، وcode-server المضمّن، والمتصفح داخل التطبيق تُفتح عند الطلب، وتُضاف ألسنة معاينة النشر تلقائيًا حين يُكتشف رابط معاينة على طلب السحب. يُحفظ تخطيط الألسنة لكل طلب سحب.

يحمل لسان نظرة عامة بيانات طلب السحب (المؤلف، الفرع، التسميات، المُسند إليهم، التفاعلات، الإيداعات، حالة الفحوصات) وصف الإجراءات: تحديث، مراجعة، دمج، فتح في بيئة التطوير، وقائمة ⋯ مزيد من الإجراءات.

اقرأ الفروق

افتح لسان الفروق لترى فرق طلب السحب كله دفعة واحدة، مع شجرة ملفات للتنقّل بين الملفات.

زر إعدادات عرض الفروق في شريط الأدوات يبدّل بين مقسّم (جنبًا إلى جنب) وموحّد، ويبدّل التفاف الأسطر وحروف الربط في خط التعليمات البرمجية.
تُستبدل ترويسات المقاطع @@ بـإظهار N سطرًا أو إظهار نهاية الملف، والنقر يُدرج السياق المحيط.
اضغط j / k للتنقّل بين الملفات، وc لطي الملف المركّز أو توسيعه، وt لإعادة الشريط الجانبي إلى شجرة الملفات، و⌘F للبحث في الفروق كلها (Enter / Shift+Enter يتنقّلان بين المطابقات).
اضغط v لتعليم الملف المركّز بأنه شُوهد، فينتقل المؤشر إلى الملف التالي. على GitHub تُخزَّن حالة المشاهدة على مضيف الشفرة، فتتبعك بين العملاء. GitLab وBitbucket بلا واجهة API لذلك، فتُحفظ الحالة على هذا الجهاز فقط.

السحب بالفأرة في منطقة الشفرة يحدد النص حتى العمود نفسه، و⌘C ينسخ المصدر الخام لا علامات الفرق المعروضة.

اترك تعليقات مضمّنة

انقر هامش صف الشفرة لفتح مربّع كتابة مثبت على ذلك السطر، أو زر + في ترويسة الملف لـالتعليق على هذا الملف
اكتب تعليقك بصيغة Markdown
أرسل

على GitHub وGitLab يقدّم مربّع الكتابة إرسالين: إضافة تعليق واحد يُنشر فورًا، وبدء مراجعة / إضافة إلى المراجعة يُدرج التعليق في مراجعة معلّقة تخرج مع موافقة أو طلب تغييرات أو تعليق. لا تجميع لمراجعة معلّقة في Bitbucket، فكل إرسال هناك يُنشر فورًا. يظهر النشر الفوري بحالة جارٍ النشر… حتى يؤكّده المضيف، ثم يصير متزامن. إن فشل النشر، تُوسَم السلسلة بالخطأ وتُعرض إعادة المحاولة.

المسودة هي متن المراجعة وحده: يُحفظ على الخادم مقابل (المالك، المستودع، رقم طلب السحب) بعد لحظة من توقّفك عن الكتابة، فيبقى بعد إعادة التحميل ويتبعك بين عميل سطح المكتب وعميل الويب.

أرسل مراجعة

اضغط مراجعة في صف إجراءات نظرة عامة (يُخفى في طلبات السحب التي ألفتها، وفي الطلب المغلق أو المدموج)
اكتب متن المراجعة. تستطيع إرفاق صورة، أو إدراج رمز تعبيري أو GIF، والتبديل بين كتابة ومعاينة
اضغط طلب تغييرات أو تعليق أو موافقة

الحكم هو الزر، ولا منتقي حكم منفصل. بعد موافقة أو طلب تغييرات تصير تسمية الزر تمت الموافقة أو طُلبت تغييرات، ويُمسح متن المسودة. حكم تعليق يُبقي الزر باسم مراجعة.

الدمج

يظهر زر دمج حين تملك صلاحية الكتابة، وطلب السحب مفتوح وليس مسودة. لونه إشارة جاهزية تُشتق من الموافقات المطلوبة وحالة الفحوصات (جاهز / معلّق / محظور)، وهي للتنبيه فقط. حالة المراجعة لا تعطّل الزر. ما يفرض القواعد هو حماية الفرع لدى المضيف.

اضغط دمج لفتح لوحة الدمج المنبثقة
اختر طريقة الدمج: سحق ودمج أو إنشاء إيداع دمج أو إعادة تأسيس ودمج (سحق ودمج هو الافتراضي). لا يملك Bitbucket دمجًا حقيقيًا بإعادة التأسيس، فيُقابَل إعادة تأسيس ودمج باستراتيجية fast-forward لديه، ويفشل على فرع متباعد
مع سحق ودمج وإنشاء إيداع دمج، عدّل عنوان الإيداع ووصف الإيداع المعبّأين مسبقًا. إعادة تأسيس ودمج لا يأخذ أيًا منهما ويخفي الحقلين
اقرأ لوحة التحذيرات. تعرض فحوصات فاشلة وبعض المراجعات معلّقة، ولا تمنعك
اضغط دمج طلب السحب في اللوحة المنبثقة للتأكيد

الدمج لا رجعة فيه: يدفع الإيداعات إلى مضيف الشفرة، فيأخذ خطوة تأكيد لا مدخلًا في مكدس التراجع. بعد ذلك تُبطَل الذاكرة المؤقتة لطلب السحب، وتصير حالته تم الدمج، ويُطلَق حدث PullRequestStatusChanged بالحالة merged. يُخلي هذا الحدث شجرة العمل العابرة لـ«فتح في المحرر»، ويبدأ اثنين من خطوط الأنابيب المُنشأة مع مساحة العمل: Stale repository cleanup، الذي يزيل أشجار العمل ومجلدات المحادثات القديمة لطلب السحب، وRelease notes، الذي يصوغ بندًا في سجل التغييرات.

أوكل طلب السحب إلى وكلاء المراجعة

تحمل قائمة ⋯ (مزيد من الإجراءات) في لسان نظرة عامة بند اسأل الذكاء الاصطناعي، ويبدأ خط الأنابيب pr_review المُنشأ مع مساحة العمل لهذا الطلب. لا يظهر البند إلا ما دام طلب السحب مفتوحًا. انظر استخدام المراجعة المدعومة بالذكاء الاصطناعي لما يفعله خط الأنابيب وكيف تنشر نتائجه، وحوسبة المراجعة (المجموعات والمحاور) لنموذج المجموعات والمحاور الحتمي.

راجع طلب سحب خارجي

يستورد Control Center أيضًا طلبات السحب التي يفتحها أشخاص من خارج التطبيق. مسار المراجعة أعلاه هو نفسه. تكتشف خدمة استطلاع طلبات السحب الطلبات الخارجية.