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

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

  • Статья

Применимо к: Visual Studio

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

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

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

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

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

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

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

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

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

Visual Studio 2010 Tools for Office runtime предоставляет запись реестра, которую администраторы могут использовать для установки значения времени ожидания для скачивания манифестов и решения.

Установка значения времени ожидания

  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 на компьютере разработки, используйте полное имя для всех расположений HTTP/HTTPS/FTP вместо localhost.

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

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

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

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

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

После изменения версии сборки можно продолжать подписывать сборку строгим именем, и 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, установщик для основных сборок взаимодействия (PIA) Office запускается только в том случае, если личные сведения еще не установлены.

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

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

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

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

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

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

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

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

Задайте расширение .vsto , а тип MIME — application/x-ms-vsto.

Ссылки