تحتوي ملحقات Cool Visual Studio على العديد من الميزات الرئيسية التي تميزها عن الباقي. أنها تبدو وفعلا في الواقع مدروس ، وظيفية وموثوق بها. بالإضافة إلى ذلك ، يفعلون ما يجب عليهم ، إلى مستوى التميز ويتناسبون أصلاً مع الوظائف الداخلية لبرنامج Visual Studio.
لجعل كتابة ملحقات جيدة أسهل ، نحن نعمل مع المجتمع لتطوير قائمة تحقق بسيطة. يوجد حتى
قالب إصدار GitHub يمكنك استخدامه. في هذه المقالة ، سننظر في 9 قواعد توسيع باردة. التفاصيل تحت خفض.
القواعد
القائمة التالية ليست بالترتيب. تذكر أن تتبع جميع القواعد للحصول على أفضل النتائج.
المادة 1: الالتزام بقواعد التغطية
أضف حزمة
Microsoft.VisualStudio.SDK.Analyzers إلى مشروع VSIX الخاص بك. هذا سيساعدك على تحديد وحل الأخطاء المشتركة للخيوط.
القاعدة 2: إضافة أيقونة عالية الجودة
يجب أن تحتوي جميع الإضافات على أيقونة مرتبطة بها. تأكد من أن الرمز هو ملف .png عالي الجودة بدقة 128 × 128 بكسل و DPI يبلغ 96 أو أكثر. بعد إضافة الرمز إلى مشروع VSIX ، قم بتسجيله في ملف .vsixmanifest كرمز وصورة معاينة. يستخدم Visual Studio Marketplace رمزًا أكبر وسوف يتغير رمزك ديناميكيًا عند عرضه في Visual Studio.
المادة 3: العنوان والوصف
تشير الدراسات إلى أن المستخدمين في كثير من الأحيان تثبيت ملحقات مع أسماء وصفية قصيرة ومعلومات دقيقة عنهم. تأكد من أن الاسم يلتقط جوهر ما تقوم به الإضافة. يجب أن ينشئ الوصف في ملف .vsixmanifest توقعات حول ما يفعله الملحق. في المجموع ، وصف موجز للمشكلات التي يحلها الامتداد وما هي وظائفه الأساسية.
القاعدة 4: اكتب وصفًا جيدًا للسوق
هذا أحد أهم الأشياء التي يجب عليك القيام بها لإنجاح عملية التوسع. وصف جيد يتكون من:
- لقطات / صور GIF لما ستضافه الإضافة
- وصف مفصل الميزات
- روابط إلى التفاصيل ، إذا لزم الأمر
المادة 5: حدد الترخيص
يتم عرض الترخيص في Marketplace ، وفي مثبت VSIX ، وفي مربع الحوار Extensions Manager. حدد دائمًا ترخيصًا لإنشاء توقعات للمستخدمين. النظر في استخدام
choosealicense.com للعثور على الترخيص المناسب. سبب هذه القاعدة هو حل أي غموض ، وهو أمر مهم للعديد من مستخدمي Visual Studio.
المادة 6: إضافة إشعار الخصوصية
إذا قامت الإضافة بجمع بيانات ، مثل القياس عن بُعد ، فأضف ملاحظة حول ذلك في الوصف.
المادة 7: استخدام KnownMonikers حيثما كان ذلك ممكنا
يأتي Visual Studio مع الآلاف من الرموز المتوفرة في مجموعة
KnownMonikers . عند إضافة رموز إلى أزرار ، تحقق: ربما يمكنك استخدام رموز KnownMonikers الحالية ، لأنها جزء من لغة التصميم المألوفة لمستخدمي Visual Studio. فيما يلي
قائمة كاملة
بـ KnownMonikers ، ويمكنك أيضًا استخدام ملحق
KnownMonikers Explorer للعثور على البرنامج الذي يناسب البرامج النصية.
المادة 8: خلق شعور التمديد الأصلي
اتبع نفس الأنماط ومبادئ التصميم التي يستخدمها Visual Studio نفسه. هذا يجعل التمديد طبيعيًا للمستخدمين. كما أنه يقلل من الانحرافات الناجمة عن واجهة مستخدم سيئة التصميم. تأكد من أن جميع الأزرار والقوائم وأشرطة الأدوات ونافذة الأدوات مرئية بشكل افتراضي فقط عندما يكون المستخدم في السياق الصحيح لاستخدامها. هناك العديد من القواعد:
- لا تقم أبدًا بإضافة قائمة جديدة ذات مستوى عالٍ (بجوار ملف ، تحرير ، وما إلى ذلك)
- يجب ألا تكون هناك أزرار أو قوائم أو أشرطة أدوات مرئية في السياقات التي لا تنتمي إليها.
- إذا كنت بحاجة إلى التحميل التلقائي (على الأرجح لا) ، فقم بذلك في أقرب وقت ممكن.
- استخدم VisibilityConstrict لتبديل رؤية الأمر بدلاً من الاعتماد على التحميل التلقائي
المادة 9: استخدام نطاقات الإصدار الصحيح
قد يكون من المغري دعم إصدارات Visual Studio حتى Visual Studio 2010 حتى يتمكن الجميع من استخدام الملحق الجديد. المشكلة هي أنه لم يعد بإمكانك استخدام واجهات برمجة التطبيقات المقدمة بعد الإصدار القديم الذي يدعمه الامتداد. غالبًا ما تكون واجهات برمجة التطبيقات الجديدة هذه مهمة وتساعد على تحسين أداء وموثوقية كل من الملحق و Visual Studio نفسه.
فيما يلي إرشاداتنا لتحديد إصدارات Visual Studio لدعمها:
- دعم فقط الإصدارات السابقة والحالية من Visual Studio - إذا كان ذلك ممكنا ، لا تدعم الإصدارات القديمة
- لا تحدد نطاق الإصدارات المتاحة. على سبيل المثال [16.0). تعرف على المزيد حول الإصدارات هنا .
رايك
ما رأيك في قائمة المراجعة هذه؟ هل توافق على القواعد؟ يرجى مشاركة أفكارك أدناه في التعليقات أو في
مستودع جيثب . آمل أن تساعدك قائمة التحقق في إنشاء ملحقات رائعة ستصبح شائعة جدًا.