كيفية إصلاح خطأ "Missing Project Reference" عند تجميع إضافة CounterStrikeSharp
بعض الإضافات مقسمة على مستودعين: الإضافة نفسها، ومشروع منفصل من نوع "API" أو "shared" تعتمد عليه، عادة ما يكون مرتبطًا كوحدة فرعية git. إذا قمت بتنزيل الإضافة كملف .zip بسيط من GitHub، فلن يتم تضمين محتوى تلك الوحدة الفرعية، بل مؤشر إليها فقط. النتيجة هي عملية تجميع تفشل بعشرات الأخطاء المربكة CS0246/CS0103، "type or namespace not found"، واحد لكل صنف كان سيوفره المشروع المفقود. السبب الحقيقي هو سطر واحد فقط، يسهل تفويته.
ابحث عن الخطأ الحقيقي
مرر إلى أعلى سجل التجميع الفاشل، فوق جدار أخطاء CS0246. ابحث عن سطر مثل هذا، إنه السبب الحقيقي، وكل ما يليه هو نتيجة له:
warning MSB9008: The referenced project ../ggmcAPI/ggmcAPI.csproj does not exist.
افهم ماذا يعني
يشير ملف .csproj الخاص بالإضافة إلى مشروع آخر عبر مسار نسبي، في المثال أعلاه، مجلد باسم ggmcAPI، يقع مستوى واحد فوق مجلد الإضافة نفسه. هذا المجلد ببساطة غير موجود في الأرشيف الذي قمت برفعه.
تحقق مما إذا كانت وحدة فرعية git
افتح صفحة الإضافة على GitHub وابحث عن مجلد يظهر بأيقونة سهم صغيرة وتجزئة commit قصيرة، بدلاً من قائمة ملفات عادية، هذه وحدة فرعية. زر "Download ZIP" في GitHub لا يتضمن أبدًا محتوى الوحدات الفرعية، بل مؤشرًا فقط إلى commit الذي يجب أن يكون. ستحتاج إلى فتح مستودع تلك الوحدة الفرعية بشكل منفصل وتنزيله بمفرده.
عمق المجلد الصحيح
هذه هي الخطوة التي يخطئ فيها معظم الناس في المحاولة الأولى. المسار النسبي في .csproj (../ggmcAPI في مثالنا) يتم حله بالنسبة للمجلد الذي يحتوي على ملف .csproj نفسه، وليس بالنسبة لجذر أرشيف .zip الخاص بك. إذا لم يكن مجلد الإضافة الخاص بك ومجلد التبعية في نفس المستوى، فإن مستوى واحد للأعلى يؤدي إلى المكان الخاطئ.
خطأ شائع يجب تجنبه
وضع مجلد التبعية داخل مجلد الإضافة نفسه يبدو منطقيًا، لكنه ليس ما يتوقعه المسار النسبي. سيفشل هذا الهيكل تمامًا كما لو لم يكن هناك أي مجلد على الإطلاق:
أعد التجميع
بمجرد أن يصبح كلا المجلدين جنبًا إلى جنب في العمق الصحيح، أعد ضغط الأرشيف وارفعه مرة أخرى. إذا اختفى MSB9008 من السجل لكنك ما زلت ترى أخطاء، فهذه الآن أخطاء تجميع حقيقية تستحق النظر فيها بشكل منفصل.
افتح مترجم CS2Sharpهل كان هذا الدليل مفيدًا؟
Barlap من أجل المجتمع.
