استكشاف أخطاء نشر حل Office

ينطبق على

تنطبق المعلومات الموجودة في هذا الموضوع فقط على أنواع المشاريع وإصدارات Microsoft Office التالية: لمزيد من المعلومات، راجع الميزات المتوفرة بواسطة تطبيقات Office و نوع المشروع.

نوع المشروع

  • مشروعات على مستوى المستند

  • مشروعات على مستوى التطبيق

إصدار Microsoft Office

  • نظام 2007 Microsoft Office

  • Microsoft Office 2010

يتضمن هذا المقطع نصائح حول حل المشاكل الشائعة التي قد تواجهها عندما تنشر حلول Office.

تغيير اسم التجميع يتسبب في تعارضات

إذا قمت بتغيير القيمة اسم التجميع في الصفحة تطبيق من مصمم المشروع بعد توزيع حل Office، سوف تقوم أدوات النشر بتعديل حزمة الإعداد لتحظى ببياني نشر وملف Setup.exe واحد. نشر ملفي بيان يمكن أن يتسبب في الحالات التالية:

  • إذا قام المستخدم النهائي بتثبيت كلا الإصدارين، سيقوم التطبيق بتحميل كلا الوظائف الإضافية.

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

لتجنب هذه الحالات لا تقم بتغيير القيمة اسم التجميع الخاصة بالحل بعد نشر الحل.

التحقق من وجود تحديثات يأخذ وقت طويل

Visual Studio Tools لـ Office Runtime يوفر إدخال تسجيل يمكّن المسؤولين من تعيين قيمة المهلة لتحميل ملفات البيان و الحل.

لتعيين قيمة المهلة

  1. في التسجيل ، انتقل إلى مفتاح التسجيل التالي:

    HKEY_CURRENT_USER\Software\Microsoft\VSTA

  2. في المفتاح الفرعي AddInTimeout ، قم بتعيين قيمة المهلة بالمللي ثانية.

    في حالة عدم وجود المفتاح الفرعي AddInTimeout قم بإنشائه كـ DWORD.

تعذر التحديث أو النشر لمشاركة ملف شبكة

حلول Office الموجودة على مشاركة ملف الشبكة قد يعرض رسالة مضللة أثناء إجراء التحديثات إذا كان الحل الخاص بـ Setup.exe مؤمن في العملية أثناء نشر التحديث. قد تكون الرسالة كالتالى: Unable to add 'setup.exe' to the Web (تعذر إضافة 'setup.exe' إلى الويب). الملف 'setup.exe' موجود بالفعل على هذه الويب

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

المتطلبات الأساسية لـ Microsoft Office غير مثبتة

يمكنك إضافة Microsoft .NET Framework و Visual Studio Tools لوقت تشغيل Office و تجميعات التوافق الأساسية لـ Microsoft Office إلى حزمة الإعداد الخاصة بك كمتطلبات أساسية يتم نشرها في حل Office الخاص بك . للحصول على معلومات حول كيفية تثبيت تجميعات التوافق الأساسية، راجع تكوين كمبيوتر لتطوير حلول Office و كيفية القيام بما يلي: تثبيت تجميعات توافق Office أساسية.

النشر باستخدام 'localhost' قد يتسبب في مشاكل تثبيت

عند استخدام "https://localhost" كموقع النشر أو التثبيت للحلول على مستوى المستند أو التطبيق لا يقوم معالج النشر بتحويل السلسلة إلى اسم الكمبيوتر الحقيقي. وهذا يعني أنه يمكن تثبيت الحل فقط على كمبيوتر التطوير. لجعل الحلول المنشورة تقوم باستخدام IIS على كمبيوتر التطوير، استخدم اسماً مؤهلاً بشكل كامل لكافة مواقع HTTPS HTTP FTP بدلاً من localhost (المضيف المحلي).

يتم تحميل تجميعات مخزنة مؤقتاً بدلاً من التجميعات المحدثة

Fusion و أداة تحميل تجميع .NET Framework تحمّل النسخة المخزنة مؤقتاً من التجميعات عندما يكون مسار إخراج المشروع موجودا على مشاركة ملف شبكة , يتم توقيع التجميع باسم قوي ،و لا يتغير إصدار تجميع التخصيص. إذا قمت بتحديث التجميع الذي يقابل هذه الشروط ، فلن تتمكن من رؤية التحديث في المرة التالية التي تقوم فيها بتشغيل المشروع لأنه يتم تحميل النسخة المخزنة مؤقتاً.

يمكنك تكوين Visual Studio و بحيث يقوم Fusion بتحميل التجميعات كل مرة يتم فيها تشغيل المشروع.

لتحميل التجميعات بدلاً من تحميل النسخ المخزنة مؤقتاً

  1. على قائمة المشروع، انقر فوق (خصائص المشروع) ProjectNameProperties.

  2. في الصفحة تطبيق ، انقر فوق معلومات التجميع.

  3. في أول مربع حوار إصدار التجميع، اكتب العلامة النجمية (*).

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

بعد تغيير إصدار التجميع ، يمكنك الاستمرار فى توقيع التجميع الخاص بك باسم قوى و fusion ستقوم بتحميل أحدث إصدار من التخصيص.

مخططات XML في التخصيصات على مستوى المستند غير مسجلة

في حالة إرفاق مخطط XML إلى مستند في مشروع على مستوى المستند لنظام Microsoft Office 2007 فإن المخطط غير مسجل في مكتبة المستخدم. يجب إنشاء ملف مثبت منفصل للقيام بذلك. لمزيد من المعلومات، راجع مخططات و بيانات XML في تخصيصات على مستوى المستند.

يفشل التثبيت عندما تحتوي URI على الأحرف التي هي غير US-ASCII

عند نشر حل Office على موقع HTTPS HTTP FTP لا يمكن أن يكون لدي المسار أي أحرف Unicode ليست US-ASCII. تتسبب هذه الأحرف في سلوك غير متناسق في ملف الإعداد . تستخدم أحرف ASCII US لمسار التثبيت.

قم بالمطالبة بأن يظهر إزالة التثبيت يدوياً عند نشرك لحل وتثبيته على كمبيوتر التطوير

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

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

الخطأ "الاستثناء لم يُمسك" أو "‏‏لم يتم العثور على الأسلوب" عند تثبيتك للحل

عند تثبيت حلول Office المطورة باستخدام (Visual Studio 2008 Service Pack 1 (SP1 عن طريق فتح بيان النشر (ملف . Vsto ) أو تطبيق Office أو المستند أو المصنف، قد تظهر رسائل خطأ في الحالات التالية:

  • ‏‏لم يتم العثور على الأسلوب.

  • MissingMethodException (استثناء "أسلوب غير موجود").

  • استثناء لم يُمسك.

لمنع رسائل الخطأ، قم بتثبيت الحل عن طريق تشغيل برنامج الإعداد .

حلول Office التي تم تطويرها باستخدام 2008 Visual Studio SP1 تتطلب SP1 الخاص بأدوات Visual Studio لوقت تشغيل Office 3.0. برنامج الإعداد يقوم بالتحقق من الإصدار الصحيح من المتطلبات الأساسية بما فى ذلك SP1 لوقت التشغيل، و يثبتها حسب الحاجة. ومع ذلك، عند تثبيت الحل دون تشغيل ملف الإعداد، لا يقوم المثبت بتثبيت أو التحقق من المتطلبات الأساسية.

مفاتيح تسجيل البيان الخاصة بتغيير الوظائف الإضافية بعد بناء مشروع إعداد Windows Installer

مفتاح تسجيل البيان الذي هو جزء من ملف إعداد الوظيفة الإضافية، أحياناً يتغير من .vsto إلى. بيان dll. عند بناء مشروع إعداد Windows Installer.

للتغلب على هذه المشكلة ، قم بإنشاء مشروع الإعداد في حل مختلف أو قم باستخدام CompanyName.AddinName كقيمة مفتاح التسجيل الذي يحتوي على اسم الوظيفة الإضافية.

مثبت ClickOnce لـحل Office الخاص بك لا يقوم بتثبيت تجميعات التوافق الأساسية

عند تشغيل ملف الإعداد الذي يقوم ClickOnce بإنشائه لحلول Office الخاصة بك، يعمل المثبت لتجميعات التوافق الأساسية لـ PIAs) Office) فقط إذا ما لم يكن هناك PIAs مثبتة بالفعل.

إذا كان برنامج الإعداد لا يقوم بتثبيت PIAs بشكل صحيح, قم بتثبيت PIAs يدويًا عن طريق تشغيل ملف المثبت المسمى o2007pia.msi من دليل التثبيت.

أدوات Visual Studio لخدمة Office 3.0 Service Pack 1 Runtime لا يتم إعادة تثبيتها

عند استخدامك Setup.exe لإعادة تثبيت أدوات Visual Studio لـوقت تشغيل (Office 3.0 Service Pack 1 (SP1 على كمبيوتر يحتوي مسبقاً على أدوات Visual Studio لوقت تشغيل Office 3.0 المزودة بحزمة خدمة SP1، التثبيت قد يفشل . لحل هذه المشكلة، قم بحذف مفتاح التسجيل [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\vsto runtime Setup\] و قم بتشغيل المثبّت VSTO 3.0 المزود بحزمة الخدمة SP1 مرة أخرى.

إعادة تثبيت حلول Office يتسبب في الاستثناء "الوسيطة خارج النطاق"

عند إعادة تثبيت حل Office قد ترى استثناء ArgumentOutOfRangeException مع رسالة الخطأ التالية: الوسيطة المحددة كانت خارج نطاق القيم الصالحة.

يحدث هذا إذا كانت حالة أحرف URL موقع التثبيت مختلفة. على سبيل المثال، قد تظهر هذه الأخطاء في حالة تثبيت حل Office من https://fabrikam.com/ExcelSolution.vstohttps://fabrikam.com/excelsolution.vsto فى المرة الأولى و استخدام https://fabrikam.com/excelsolution.vsto فى المرة الثانية.

لمنع ظهور الرسالة, استخدم نفس حالة الأحرف عند تثبيت حلول Office.

راجع أيضًا:

المبادئ

توزيعات ClickOnce استكشاف الأخطاء وإصلاحها

موارد أخرى

توزيع حلول Office