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

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

  • Статья

Область применения: Visual Studio

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

Сведения в этой статье относятся к проектам уровня документа и проектам надстроек набор средств Visual Studio для Office (VSTO). См. сведения о функциях, доступных по Приложение Office и типу проекта.

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

Средство просмотра событий в Windows можно использовать для просмотра сообщений об ошибках, которые фиксируются средой выполнения набор средств Visual Studio для Office при установке или удалении решений Office. Эти сообщения из журнала событий можно использовать для разрешения проблем развертывания и установки. Дополнительные сведения см. в разделе "Ведение журнала событий" для решений Office.

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

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

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

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

Проверка наличия обновлений занимает много времени

Средства 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 для Office и основные сборки взаимодействия Office в пакет установки в качестве необходимых компонентов, развернутых в решении Office. Сведения об установке основных сборок взаимодействия см. в статье "Настройка компьютера для разработки решений Office и практическое руководство. Установка основных сборок взаимодействия Office".

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

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

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

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

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

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

  1. В строке меню выберите "Проект", <"Свойства ProjectName>".
  2. На странице приложения выберите "Сведения о сборке".
  3. Задайте номер редакции( третье поле версии сборки) для подстановочной карточки (*). Например, "1.0.*". Затем нажмите кнопку OK.

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

Примечание.

Начиная с Visual Studio 2017, при попытке использовать подстановочные карточки в версии сборки возникнет ошибка сборки. Это связано с тем, что подстановочные карточки в версии сборки прервают детерминированную функцию MSBuild. Вам будет показано удалить подстановочные знаки из версии сборки или отключить детерминизм. Дополнительные сведения о детерминированной функции см. в разделе " Общие свойства проекта MSBuild" и "Настройка сборки"

Установка завершается ошибкой, если URI имеет символы, которые не являются US-ASCII

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

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

При сборке решения Office версия сборки регистрируется автоматически. Если вы ранее опубликовали и установили то же решение на компьютере разработки, набор средств Visual Studio для Office среда выполнения обнаруживает, что путь установки для опубликованной версии и встроенная версия отличаются после того, как решение будет построено, перестроено или опубликовано. В сообщении об ошибке говорится, что настройка не может быть установлена, так как в настоящее время установлена другая версия и не может быть обновлена из этого расположения". Разделы реестра обновляются всякий раз при перестроении решения. Таким образом, необходимо удалить предыдущую версию перед публикацией, отладкой или запуском новой версии.

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

Неохваченное исключение или метод не найден при установке решения

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

  • Метод не найден.
  • MissingMethodException.
  • Неперехваченное исключение.

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

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

Разделы реестра манифестов для надстроек изменяются после создания проекта InstallShield Limited Edition

Раздел реестра манифеста, который является частью программы установки надстройки VSTO, иногда изменяется с VSTO на .dll.manifest при сборке проекта InstallShield Limited Edition.

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

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

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

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

Переустановка решений Office приводит к исключению из диапазона аргумента

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

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

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

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

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

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

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

Ссылки