Поделиться через


Устранение неполадок, связанных с развертыванием решения Office

В этом разделе содержатся сведения о том, как решить типичные проблемы, с которыми можно столкнуться при развертывании решений Office.

Применение. Сведения этого раздела применяются к проектам уровня документа и уровня приложения для Office 2013 и Office 2010. См. раздел Доступность функций по типам приложений Office и проектов.

Диагностика решений Office с помощью средства просмотра событий

Можно использовать средство просмотра событий в Windows для изучения сообщений об ошибках, которые были зарегистрированы в среде Visual Studio Tools for Office (cреда выполнения) при установке или удалении решений Office.С помощью этих сообщений журнала событий можно устранять проблемы, возникшие при установке и развертывании.Дополнительные сведения см. в разделе Ведение журнала событий для решений Office.

Изменение имени сборки приводит к конфликтам

При необходимости измените значение Имя сборки на странице Приложение в Конструктор проектов, то после уже развертывание решения, средства публикации изменения пакета установки, чтобы иметь один файл Setup.exe и 2 манифеста развертывания.При развертывании 2 файла манифеста, могут возникнуть следующие условия:

  • Если конечный пользователь установит обе версии, приложение загрузит обе надстройки.

  • Если надстройка была установлена до изменения имени сборки, конечный пользователь не сможет получать обновления.

Чтобы избежать подобных последствий, не изменяйте значение Имя сборки решения после развертывания решения.

Проверка обновлений занимает продолжительное время

Средства Visual Studio 2010 для выполнения office предоставляют запись реестра, администраторы могут использовать для задания времени ожидания для загрузить манифесты и решение. 

Задание времени ожидания

  1. Перейдите к следующему разделу реестра:

    HKEY_CURRENT_USER\Software\Microsoft\VSTA

  2. В подразделе реестра AddInTimeout укажите время ожидания в миллисекундах.

    Если подраздел AddInTimeout не существует, создайте его DWORD.

Не удается обновить или публиковать в общей сетевой папке

Решения Office, размещенные в сетевой общей папке, могут выводить в процессе обновления вводящее в заблуждение сообщение, если файл Setup.exe решения заблокирован в процессе при публикации обновления.Сообщение может выглядеть следующим образом: "Не удается добавить файл "setup.exe" на веб-узел.Файл "setup.exe" уже существует на этом веб-узле".

Чтобы предотвратить блокировку файла, можно предоставить конечным пользователям права только на чтение общей папки.Тем не менее, если в общей папке имеются документы, они также станут доступны конечным пользователям только для чтения.

Необходимые компоненты для Microsoft Office не заданы

Можно добавить платформы .NET Framework, Visual Studio Tools for Office (cреда выполнения) и основные сборки взаимодействия office в установочный пакет в качестве необходимых компонентов, которые развертываются с конкретным решениям Office.Дополнительные сведения об установке основных сборок взаимодействия см. в разделах Настройка компьютера для разработки решений Office и Практическое руководство. Установка основных сборок взаимодействия Microsoft Office.

Публикация с использованием узла Localhost может привести к проблемам с установкой

При использовании "https://localhost" в качестве публиковать или папку установки для решений уровня документа в Мастер публикации не преобразует строковое значение реальному имени компьютера.В этом случае решения следует установить на компьютере разработчика.Чтобы развернутые решения могли использовать службы IIS на компьютере разработчика, используйте вместо "localhost" полные имена для всех местоположений, доступ к которым осуществляется по протоколам HTTP, HTTPS и FTP.

Вместо обновленных сборок загружаются кэшированные сборки

Fusion, загрузчик сборок платформы .NET Framework, загружает кэшированную копию сборок, если путь выходных данных проекта в общей сетевой папке, сборка подписана строгим именем, а версия сборки настройки не изменяется.При обновлении сборки, которая соответствует этим условиям, обновление не отображается при следующем вызове запуске проекта, поскольку загружена кэшированная копия.

Visual Studio можно настроить таким образом, чтобы загрузчик Fusion загружал сборки каждый раз при запуске проекта.

Загрузка сборки вместо кэшированных копий

  1. В строке меню выберите Проект, СвойстваProjectName.

  2. На странице Приложение выберите Сведения о сборке.

  3. В первом окне Версия сборки введите звездочку (*), а затем нажмите кнопку ОК.

После изменения версии сборки можно продолжить подписывание сборки строгим именем и fusion загрузит последней версии настройки.

Установка завершится ошибкой, если универсальный код ресурса (URI) содержит символы, Are't US-ASCII

Если вы публикуете решения Office в расположение, HTTP/HTTPS/FTP путь не может содержать символы юникода, которых нет в US-ASCII.Наличие таких символов может привести к непредсказуемому поведению программы установки.Используйте в пути установки знаки из набора US-ASCII.

При публикации и установке решения на компьютер разработчика появляется предложение удалить решение вручную

При построении решения Office построенная версия регистрируется автоматически.Если ранее публиковали и задаются то же решение на компьютере разработчика, Visual Studio Tools for Office (cреда выполнения) обнаруживает, что путь установки для публикованной версии и построенная версия другие после решения, далее будет создан при или публиковано.Сообщение об ошибке выглядит следующим образом: "Не удается установить настройку, поскольку установлена другая версия, которую нельзя обновить из данного местоположения". Разделы реестра обновляются, когда решение при.Поэтому необходимо удалить в предыдущей версии до того, как вы публикуете, отладка, или запустите новую версию.

Чтобы это сообщение не появлялось, создайте для тестирования развернутого решения на компьютере разработчика другую учетную запись пользователя.В качестве альтернативы можно удалить версию из списка установленных программ на компьютере перед далее публикуете, отладка, или перестроении решения.

Ошибка "Не удалось перехватить исключение" или "Метод не обнаружен" при установке решения

При размещении решения Office, открывая манифест развертывания (vsto-файл), приложение office, документ или рабочую книгу, сообщения об ошибках для следующих условий могут появляться:

  • "Метод не обнаружен";

  • "Отсутствует исключение метода";

  • "Не удалось перехватить исключение".

Чтобы предупредить возникновение подобных ошибок, следует установить решение посредством запуска программы установки.

При размещении решение без выполнения программы установки, программа установки не проверяет наличие или не установит необходимые компоненты.Программа установки проверяет наличие соответствующих версий необходимых компонентов и устанавливает их по мере необходимости.

Встроенные очевидные разделы реестра для изменения надстройки после выпуска проекта InstallShield Limited

Манифест раздел реестра, который является частью программы установки надстройки иногда изменится с .vsto к dll-манифест при построении проекта InstallShield Limited выпуска.

Для решения этой проблемы создайте проект InstallShield выпуска Limited в другом решении или используйте CompanyName.AddinName как значение раздела реестра, содержащего имя надстройки.

Установщик ClickOnce для решений Office не установит основные сборки взаимодействия

При запуске программы установки, которая создает ClickOnce для решения Office, установщик для основных сборок взаимодействия office (PIAs) выполняется только при отсутствии основные сборки взаимодействия еще не установлены.

Если программа установки не установит основные сборки взаимодействия правильно, укажите их вручную путем запуска с именем o2007pia.msi файла установщика из каталога установки.

Повторно устанавливать решения Office, аргумент вне допустимого диапазона "

При необходимости переустановите решения Office, может появиться исключение ArgumentOutOfRangeException с сообщением об ошибке: Заданный аргумент находится вне диапазона допустимых значений.

Эта ситуация возникает при разном регистре URL-адреса местоположения установки.Например, эта ошибка возникала бы, если установленное решений Office https://fabrikam.com/ExcelSolution.vsto. в первый раз, а затем использовать https://fabrikam.com/excelsolution.vsto изначальных.

Чтобы избежать появления сообщения от, используйте одинаковые регистр при размещении решения Office.

Нельзя задать решение ClickOnce, открывая манифест развертывания из Интернета

Пользователи могут устанавливать решения Office, открывая манифест развертывания из Интернета.Однако некоторые установки служб IIS (IIS) блокируются расширение имени файла .vsto.Необходимо указать тип MIME в IIS перед их использованием. для развертывания решений Office.

Дополнительные сведения об определении типа MIME в IIS 6 см. в Настроить тип MIME (IIS 6.0) разделе.

Дополнительные сведения об определении типа MIME в IIS 7 см. в Добавление типа MIME (IIS7). разделе.

Установите расширение на VSTO и тип MIME значение application/x-ms-vsto.

См. также

Основные понятия

Устранение неполадок развертывания ClickOnce

Другие ресурсы

Развертывание решения Office