كيفية إنشاء قوالب المشروع وملحق لـ Visual Studio 2019

مرحبا!

في الآونة الأخيرة ، قمت بإنشاء نموذجين للمشروع لـ Vue JS + Asp.Net Core ، كلاهما كإضافات Visual Studio 2019. تمت مشاركتها في سوق Visual Studio ، كما ترى في الرابط أدناه:

  • قالب Vue JS + Asp.Net Core 3.1

هل ترغب في معرفة كيفية إنشاء الملحق الخاص بك ونشر القالب الخاص بك؟ إذا كانت الإجابة بنعم ، فإن بقية المقالة هي عملية خطوة بخطوة حول كيفية القيام بذلك.

إنشاء المشروع

أول شيء عليك القيام به هو إنشاء مشروع تريد مشاركته كقالب. في هذه المقالة ، سأوضح خطوة بخطوة باستخدام مشروع Vue JS + Asp.Net Core الذي نشرته بالفعل.

تصدير المشروع

بمجرد إنشاء المشروع ، في Visual Studio 2019 ، انتقل إلى خيار قائمة Project واختر الخيار "Export Template":

هناك نوعان من القوالب: قالب المشروع ونموذج العنصر. كما في حالتنا ، نقوم بإنشاء قالب مشروع ، لقد حددت الخيار الأساسي:

الخطوة التالية هي تكوين الاسم والوصف والرمز الذي سيتم عرضه للمستخدمين ومعاينة الصورة. من المهم حقًا تعيين هذه المعلومات بشكل صحيح ، بقدر ما تستطيع بجودة عالية ، لأنها ستظهر للمستخدمين النهائيين الذين سيقومون بتنزيل وتثبيت القالب / الملحق الخاص بك.

وألغ تحديد الخيار "الاستيراد تلقائيًا إلى Visual Studio". بهذه الطريقة ، ستتمكن من تثبيت الإضافة التي تقوم بإنشائها.

أخيرًا ، ستنشئ العملية مجلدًا مضغوطًا يحتوي على القالب نفسه ، ولكنه ليس نهاية الإنشاء:

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

عندما نقوم بإنشاء مشروع جديد على Visual Studio 2019 ، تظهر القوالب مع بعض العلامات المحددة ، التي تساعدنا على تصفية القوالب:

منذ أحدث إصدار من Visual Studio 2019 ، هذه العلامات إلزامية لأولئك الذين يرغبون في نشر ملحق. بدونها ، سيتم تثبيت الإضافة ، ولكن لن يتم عرض النموذج أبدًا في القائمة ، حتى إذا بحث المستخدم عن ذلك.

لإنشاء هذه العلامات ، افتح المجلد المضغوط الذي تم إنشاؤه باستخدام القالب في الخطوة الأخيرة وافتح ملف .vstemplate باستخدام محرر نصوص:

في قسم "بيانات القالب" ، أضف بعد العلامة "OfferDefaultName" مرجع قائمة العلامات إلى القالب الخاص بك ، مثل النظام الأساسي ونوع المشروع واللغة وما إلى ذلك. في حالتي ، حددت ما يلي:

يمكن العثور على قائمة العلامات الكاملة المتاحة على الرابط أدناه:

إنشاء التمديد

مع إنشاء القالب بالفعل وتعيين العلامات ، حان الوقت الآن لإنشاء ملف التثبيت للملحق.

لذلك ، ما عليك سوى إنشاء مشروع من نوع مشروع VSIX:

هذا هو الهيكل الأساسي للمشروع:

ملاحظة: ولكني قمت بإنشاء اسم المشروع باستخدام أحرف خاصة معينة مثل "+" ، فقط لأغراض التدريس ، يرجى تجنب القيام بذلك في سيناريوهات حقيقية. من الأفضل إنشاء بدون أي مسافات فارغة أو أحرف خاصة ، مثل ذلك: TemplateVueJSAspNetCoreArtigoMedium ، بدلاً من الاسم الذي أضعه. سيمنع مشاكل البناء ، لأن VS سينشئ مساحات وفئات أسماء تلقائيًا باستخدام هذا الاسم.

قم بتضمين جذر مرجع المجلد المضغوط إلى القالب الخاص بك. من المهم أن يحتوي المجلد المضغوط على تغييرات ملف .vstemplate مع العلامات التي ذكرتها من قبل. لا تنسى ذلك.

يحتوي هذا المشروع على ملف بيان ، والذي سيحتوي على معلومات حول إرشادات التثبيت الملحق e.

إذا نقرت نقرًا مزدوجًا على هذا الملف ، فسيتم فتحه مثل النموذج ، الذي يمكنك ملؤه في الحقل حسب الحقل.

غيّر بعناية جميع المعلومات الضرورية بالجودة ، لأنها ستظهر للمستخدم النهائي في التثبيت والسوق أيضًا. أيضا ، من الضروري تحديد حقل "المؤلف" بشكل صحيح ، لأنه يحتوي عادة على اسم LAPTOP.

بعد ذلك ، انقر على "الأصول":

قم بإزالة الأصول الموجودة ، في حالة وجودها ، وانقر فوق "جديد":

اختر الخيارات التي أضعها وفي المسار حدد المجلد المضغوط الذي قمت بإضافته إلى المشروع.

توليد

لإنشاء ملف التثبيت ، يتم فقط بناء المشروع في وضع التحرير. سيتم إنشاء ملف. exe المستخدم لتثبيت الملحق على VS.

منجز! تم إنشاء ملحقنا. يمكنك اختباره الآن ، قبل النشر في سوق Visual Studio ، لمعرفة ما إذا كان كل شيء يعمل بشكل جيد.

نشر Visual Studio Market

إذا كنت ترغب في نشر إضافتك للجمهور ، فيمكنك القيام بذلك في Visual Studio Marketplace.

للقيام بذلك ، انتقل إلى marketplace.visualstudio.com ، وبعد تسجيل الدخول باستخدام حساب Microsoft الخاص بك ، انتقل إلى الخيارات أدناه:

قم بتحميل .exe الخاص بالامتداد الخاص بك:

املأ النموذج بالقالب ومعلومات الإضافة. بما أن هذه المعلومات ستكون عامة ، انتبه بالتفصيل.

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

استنتاج

آمل أن تكون هذه المقالة قد ساعدتك. نشكرك على قراءة ذلك.

فيما يلي ملفات تعريف الوسائط الاجتماعية الخاصة بي. لا تتردد في الاتصال وطرح سؤال. في ملفات التعريف هذه ، أشارك بشكل متكرر المحتوى حول تقنيات الويب وأحداث تكنولوجيا المعلومات.

تويتر: https://twitter.com/alemalavasi Linkedin: https://www.linkedin.com/in/alexandremalavasi/

قمت أيضًا بإنشاء قناة Youtube مؤخرًا للمساهمة في المجتمع التقني باستخدام هذه المنصة أيضًا ، مع التركيز على .NET Core و Vue JS و Azure والمزيد. إذا كنت مهتمًا بهذه الموضوعات ، فإنني أوصيك بالاشتراك. سيتم قريبًا إصدار المحتوى بانتظام ، بينما أقوم بإعداد الصوت والفيديو والمحتوى لمنحك تجربة عالية الجودة.

الرابط: https://www.youtube.com/channel/UC-KFGgYiot1eA8QFqIgLmqA