مشاركة عبر

تصحيح الأخطاء ملحقات لأدوات SharePoint في ‏‫Visual Studio

  • مقالة

لنشر ملحق أدوات SharePoint إنشاء Visual Studioالحزمة ملحق (VSIX) الذي يحتوي على التجميع ملحق ومن أية ملفات أخرى تريد توزيع مع الملحق. تعتبر حزمة VSIX ملف مضغوط يتبع اصطلاحات التحزيم فتح (OPC) القياسي. تحتوي حزم VSIX ملحق .vsix.

بعد إنشاء حزمة، VSIX يمكن للمستخدمين الآخرين تشغيل الملف .vsix إلى يثّبت الملحق الخاص بك. عندما يقوم مستخدم بتثبيت الملحق الخاص بك, يتم تثبيت كافة الملفات إلى المجلد %UserProfile%\AppData\Local\Microsoft\VisualStudio\10.0\Extensions. لنشر الملحق يمكنك تحميل حزمة VSIX إلى موقع ويب ‏‫Visual Studio معرض أو يمكنك توزيع الحزمة إلى العملاء بعض وسيلة أخرى, مثل استضافة الحزمة على يجعله مشتركًا عبر شبكة أو بعض مواقع ويب.

للحصول على أكثر المعلومات حول إنشاء حزم VSIX ونشرها لهم ‏‫Visual Studio معرض، راجع نشر ملحقات Visual Studioو الإرشادات التفصيلية: كيفية نشر ملحق Studio مرئية.

يمكنك إنشاء حزمة VSIX باستخدام القالب VSIX مشروع في ‏‫Visual Studio أو إنشاء حزمة VSIX يدوياً.

استخدام مشاريع VSIX إلى إنشاء حزم VSIX

يمكنك استخدام قالب مشروع VSIX يوفرها Visual Studio 2010SDK لإنشاء حزم VSIX ملحقات أدوات SharePoint. يوفر استخدام مشروع VSIX فوائد عديدة عبر إنشاء حزمة VSIX يدوياً:

  • ‏‫Visual Studio ببنية حزمة VSIX بشكل تلقائي عند بنية المشروع. يتم تنفيذ مهام مثل إضافة ملفات توزيع إلى الحزمة وإنشاء ملف .xml [Content_Types] للحزمة.

  • يمكنك تكوين المشروع VSIX لتضمين إخراج بناء المشروع ملحق ملفات أخرى مثل قوالب العنصر الموجودة في المشروع وقوالب المشروع في الحزمة VSIX.

لمزيد من المعلومات حول استخدام مشروع VSIX راجع Creating Extensions with the VSIX Project Template.

تنظيم المشاريع الخاصة بك

افتراضياً، لا يمكن تنفيذ ملحق أدوات SharePoint في مشروع VSIX لأنه لا تُنشئ المشاريع VSIX التجميعات; يقوموا بإنشائها VSIX الحزم. إذا كنت تستخدم مشروع VSIX لحزم ملحق أدوات SharePoint يجب استخدام اثنين المشاريع:

  • مشروع VSIX.

  • مشروع مكتبة فئة بتطبيق الملحق.

إذا كان ملحق يتضمن الأوامر SharePoint التي تستدعي في SharePoint الخادم طراز الكائن, يجب عليك استخدام ثلاثة المشاريع:

  • مشروع VSIX.

  • مشروع مكتبة فئة بتطبيق الملحق.

  • مشروع مكتبة الفئات التي تقوم بتنفيذ الأوامر SharePoint.

إذا قمت بتضمين الكل المشاريع في ‏‫Visual Studio نفس الحل, يمكنك تعديل الملف المصدر.ملحق.vsixmanifest في المشروع VSIX لتضمين إخراج بناء المشاريع مكتبة الفئات.

تكوين مشروع VSIX لنشر ملحق أدوات SharePoint

إذا كنت تريد استخدام مشروع VSIX لإنشاء الحزمة VSIX للملحق أدوات SharePoint يجب تحرير الملف .vsixmanifest في المشروع لتضمين التجميع الملحق. يجب تحرير الملف .vsixmanifest أيضاً إذا كان ملحق يتضمن أمر SharePoint أو قالب ‏‫Visual Studio لمشروع أو العنصر.

عند بنية المشروع ‏‫Visual Studio ببنية ملف .vsix في المجلد بناء المشروع VSIX.

إلى تضمين التجميع ملحق

  1. في مشروع VSIX ينقر مزودجا الملف المصدر.ملحق.vsixmanifest لفتح الملف في محرر ملف البيان.

  2. في المقطع المحتوى من محرر "" ، انقر فوق الزر إضافة المحتوى.

  3. في إضافة محتوى مربع حوار في تحديد نوع محتوى مربع قائمة، تحديد MEF مكوّنات.

  4. تحت تحديد المصدر ، قم بإحدى الخطوات التالية:

    • إذا تم بناء التجميع ملحق من مشروع في الحل نفس كمشروع VSIX, انقر فوق زر تبادلي Project ثم تحديد اسم المشروع في مربع قائمة التالي إليه.

    • حالة التجميع ملحق مُضمن كملف في المشروع انقر فوق زر تبادلي ملف في Project وتحديد التجميع في مربع قائمة التالي إليه.

    • إذا كان موجوداً في بعض التجميع ملحق أخرى, انقر فوق زر تبادلي الملف والموقعه ثم استخدم مربع حوار اختيار ملف لتحديد التجميع.

  5. انقر فوق موافق.

إلى تتضمن تجميع أمر SharePoint

  1. في مشروع VSIX ينقر مزودجا الملف المصدر.ملحق.vsixmanifest لفتح الملف في محرر ملف البيان.

  2. في المقطع المحتوى من محرر "" ، انقر فوق الزر إضافة المحتوى.

  3. في إضافة محتوى مربع الحوار في حدد نوع محتوى صواب ، حدد نوع ملحق مخصص.

  4. في مربع النص اكتب ، اكتب SharePoint.صواب.v4. هذه القيمة مطلوبة لالكل التجميعات التي تحتوي على الأوامر SharePoint.

  5. تحت تحديد المصدر ، قم بإحدى الخطوات التالية:

    • إذا تم بناء التجميع ملحق من مشروع في الحل نفس كمشروع VSIX, انقر فوق زر تبادلي Project ثم تحديد اسم المشروع في مربع قائمة التالي إليه.

    • حالة التجميع ملحق مُضمن كملف في المشروع انقر فوق زر تبادلي ملف في Project وتحديد التجميع في مربع قائمة التالي إليه.

    • إذا كان موجوداً في بعض التجميع ملحق أخرى, انقر فوق زر تبادلي الملف والموقعه ثم استخدم مربع حوار اختيار ملف لتحديد التجميع.

  6. انقر فوق موافق.

إلى تضمين قالب مشروع أو القالب العنصر

  1. إضافة مجلد جديد في مشروع VSIX إلى المشروع إلى تحتوي على القالب.

  2. تحت هذا المجلد الجديد بإنشاء مجلدات فرعية التالية ثم قم بإضافة ملف القالب (.zip) إلى المجلد معرّف إعدادات محلية.

         YourTemplateFolder

              SharePoint

                   SharePoint14

                        معرّف الإعدادات المحلية

                             YourTemplateName.zip

    على سبيل المثال، إذا كان لديك أحد قوالب عنصر المسمى ContosoCustomAction.zip يعتمد اللغة الإنكليزية (الولايات المتحدة) ، قد يكون مسار كامل ItemTemplates\SharePoint\SharePoint14\1033\ContosoCustomAction.zip.

  3. في مستكشف الحلول، انقر فوق ملف القالب ( YourTemplateName.zip).

  4. في الإطار الخصائص، تعيين الخاصية إنشاء إجراء صواب المحتوى.

  5. في مشروع VSIX ينقر مزودجا الملف المصدر.ملحق.vsixmanifest لفتح الملف في محرر ملف البيان.

  6. في المقطع المحتوى من محرر "" ، انقر فوق الزر إضافة المحتوى.

  7. إضافة محتوى مربع حوار في تحديد نوع محتوى مربع قائمة، تحديد قالب العنصر أو قالب مشروع الخاص .

  8. ضمن تحديد المصدر، انقر فوق زر تبادلي ملف في مشروع ثم حدد مسار كامل من القالب في مربع قائمة إلى جانب. على سبيل المثال، ItemTemplates\SharePoint\SharePoint14\1033\ContosoCustomAction.zip.

  9. انقر فوق موافق.

Walkthroughs ذات الصلة

للحصول على أكثر راجع معلومات حول استخدام مشروع VSIX لنشر أنواع مختلفة من SharePoint أدوات ملحقات، walkthroughs التالية:

إنشاء حزم VSIX يدوياً

إذا كنت ترغب في إنشاء الحزمة VSIX للملحق أدوات SharePoint يدوياً، نفذ الخطوات التالية:

  1. إنشاء ملف ملحق.vsixmanifest و .xml [Content_Types] ملف الحزمة VSIX (.vsix ملف). للمزيد من المعلومات، راجع Anatomy of a VSIX Package والإرشادات التفصيلية: كيفية نشر ملحق Studio مرئية.

  2. إضافة تجميع ملحق إلى الحزمة VSIX. إذا كان ملحق يحتوي على أمر SharePoint أيضاً إضافة التجميع يقوم بتطبيق الأمر SharePoint إلى حزمة VSIX.

  3. تعديل ملف ملحق.vsixmanifest:

    • في عنصر MefComponent، قم بإضافة عنصر Content. تعيين القيمة عنصر اسم الملف التجميع يقوم بتطبيق الملحق الخاص بك. لمزيد من المعلومات، راجع عنصر MEFComponent (VSX مخطط).

    • إذا كان ملحق يتضمن أمر SharePoint الذي يستدعي في SharePoint الخادم طراز الكائن قم بإضافة جديدة CustomExtensionعنصر ضمن Contentالعنصر. تعيين قيمة عنصر إلى اسم ملف التجميع يقوم بتطبيق الأمر SharePoint وتعيين Typeسمة إلى القيمة SharePoint.Commands.v4. لمزيد من المعلومات، راجع عنصر CustomExtension (VSX مخطط).

    • إذا كان ملحق قالب مشروع أو القالب العنصر ، إضافة جديد ItemTemplateالعنصر. يعرّف هذا العنصر الفرعي في حزمة VSIX التي تحتوي على قالب العنصر المشروع. لمزيد من المعلومات، راجع عنصر ItemTemplate (VSX مخطط).

يوضح المثال التالي محتويات Contentالعنصر في ملف extension.vsixmanifest للملحق أدوات SharePoint التي تتضمن تجميع أمر SharePoint قالب ضمن مجلد باسم ItemTemplates في المشروع. يفترض هذا المثال أن كلاً من التجميعات الموجودة في نفس المجلد مثل ملف ملحق.vsixmanifest في حزمة VSIX.

  <Content>
    <MefComponent>Contoso.ProjectExtension.dll</MefComponent>
    <CustomExtension Type="SharePoint.Commands.v4">Contoso.ExtensionCommands.dll</CustomExtension>
    <ItemTemplate>ItemTemplates</ItemTemplate>
  </Content>

راجع أيضًا:

المبادئ

توسيع النظام مشروع SharePoint

استدعاء في طرازات كائن SharePoint

موارد أخرى

توسيع عقدة الاتصالات SharePoint في خادم مستكشف

تصحيح الأخطاء ملحقات لأدوات SharePoint في ‏‫Visual Studio