Устранение неполадок, связанных с развертыванием решения Office (система 2007)
Обновлен: Июль 2008
Применение |
|---|
Сведения в данном разделе относятся только к указанным проектам Visual Studio Tools for Office и версиям приложений Microsoft Office. Тип проекта
Версия Microsoft Office
Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов. |
В данном разделе содержатся советы по решению типичных проблем, с которыми можно столкнуться при развертывании решений Microsoft Office с помощью Visual Studio Tools for Office.
Изменение имени сборки приводит к конфликтам
При изменении значения Имя сборки на странице ПриложениеКонструктора проектов после развертывания решения средства публикации изменяют пакет установки таким образом, чтобы остался один файл Setup.exe и два манифеста развертывания. Развертывание двух файлов манифеста может привести к указанным ниже последствиям.
Если конечный пользователь установит обе версии, приложение загрузит обе надстройки.
Если надстройка была установлена до изменения имени сборки, конечный пользователь не сможет получать обновления.
Чтобы избежать подобных последствий, не изменяйте значение Имя сборки после развертывания решения.
Проверка обновлений занимает продолжительное время
В среде Visual Studio Tools for Office, версия 3.0 (cреда выполнения) for Office, версия 3.0 используется раздел реестра, с помощью которого администраторы могут задать время ожидания для загрузки манифестов и решения.
Задание времени ожидания
Перейдите к следующему разделу реестра:
HKEY_CURRENT_USER\Software\Microsoft\VSTA
В подразделе реестра AddInTimeout укажите время ожидания в миллисекундах.
Если подраздел реестра AddInTimeout не существует, создайте его и присвойте тип DWORD.
Не удается обновить или опубликовать решение в сетевую общую папку
Решения Office, размещенные в сетевой общей папке, могут выводить в процессе обновления вводящее в заблуждение сообщение, если файл Setup.exe решения заблокирован в процессе при публикации обновления. Сообщение может выглядеть следующим образом: "Не удается добавить файл "setup.exe" на веб-узел. Файл "setup.exe" уже существует на этом веб-узле".
Чтобы предотвратить блокировку файла, можно предоставить конечным пользователям права только на чтение общей папки. Тем не менее, если в общей папке имеются документы, они также станут доступны конечным пользователям только для чтения.
Необходимые компоненты для выпуска 2007 системы Microsoft Office не устанавливаются
В качестве необходимых компонентов, развертываемых вместе с решением Visual Studio Tools for Office, в пакет установки можно добавить платформу Microsoft .NET Framework, среду выполнения Visual Studio Tools for Office и основные сборки взаимодействия Microsoft Office. Дополнительные сведения об установке основных сборок взаимодействия см. в разделах Установка средств Visual Studio для Office и Практическое руководство. Установка основных сборок взаимодействия Microsoft Office.
Публикация с использованием узла Localhost может привести к проблемам с установкой
При использовании узла "https://localhost" в качестве местоположения публикации или установки для решений уровня документа, Мастер публикации в Visual Studio Tools for Office не преобразует строку в имя компьютера. Это означает, что решение можно установить только на компьютер разработчика. Чтобы развернутые решения могли использовать службы IIS на компьютере разработчика, используйте вместо "localhost" полные имена для всех местоположений, доступ к которым осуществляется по протоколам HTTP, HTTPS и FTP.
Вместо обновленных сборок загружаются кэшированные сборки
Fusion, загрузчик сборки платформы .NET Framework, загружает кэшированную копию сборок, если путь выходных файлов проекта указывает на сетевую общую папку, сборка подписана строгим именем, а версия сборки для настройки не изменилась. При обновлении сборки, удовлетворяющей указанным выше условиям, пользователь не увидит обновления до следующего запуска проекта, поскольку будет загружена кэшированная копия.
Visual Studio можно настроить таким образом, чтобы загрузчик Fusion загружал сборки каждый раз при запуске проекта.
Загрузка сборки вместо кэшированных копий
В меню Проект выберите пункт **Свойства:**имя_проекта.
На странице Приложение нажмите кнопку Сведения о сборке.
В первом поле Версия сборки введите звездочку (*).
Нажмите кнопку ОК.
После изменения версии сборки можно продолжить подписывание сборки строгим именем, и загрузчик Fusion загрузит последнюю версию настройки.
XML-схемы в настройках на уровне документа не регистрируются
При присоединении к документу XML-схемы в проекте на уровне документа для выпуска 2007 системы Microsoft Office схема не регистрируется в библиотеке пользователя. Для этого необходимо создать отдельный файл установщика. Дополнительные сведения см. в разделе Схемы и данные XML (Инструменты Visual Studio для Office).
Если универсальный код ресурса (URI) содержит знаки не из набора US-ASCII, происходит сбой установки
При публикации решения Visual Studio Tools for Office в местоположение по протоколам HTTP, HTTPS и FTP путь не может содержать знаки Юникод не из набора US-ASCII. Наличие таких знаков может привести к непредсказуемому поведению программы установки. Используйте в пути установки знаки из набора US-ASCII.
При публикации и установке решения на компьютер разработчика появляется предложение удалить решение вручную
При построении решения Visual Studio Tools for Office построенная версия регистрируется автоматически. Если на компьютере разработчика ранее было опубликовано и установлено то же самое решение, Visual Studio Tools for Office после следующего построения, повторного построения или публикации обнаруживает, что пути установки для опубликованной версии и построенной версии различаются. Сообщение об ошибке выглядит следующим образом: "Не удается установить настройку, поскольку установлена другая версия, которую нельзя обновить из данного местоположения". Поскольку при повторном построении решения разделы реестра обновляются, перед публикацией, отладкой или запуском новой версии необходимо удалить предыдущую.
Чтобы это сообщение не появлялось, создайте для тестирования развернутого решения на компьютере разработчика другую учетную запись пользователя. Вместо этого можно также удалить версию решения из списка установленный на компьютере программ, прежде чем приступать к публикации, отладке или повторному построению решения.
Ошибка "Не удалось перехватить исключение" или "Метод не обнаружен" при установке решения
В процессе установки решений Office, разработанных с использованием Visual Studio 2008 с пакетом обновления 1 (SP 1), посредством открытия манифеста развертывания (VSTO-файл), приложения Office, документа или рабочей книги, могут появиться следующие сообщения об ошибках:
"Метод не обнаружен";
"Отсутствует исключение метода";
"Не удалось перехватить исключение".
Чтобы предупредить возникновение подобных ошибок, следует установить решение посредством запуска программы установки.
Для решений Office, разработанных с помощью Visual Studio 2008 с пакетом обновления 1 (SP1), требуется пакет обновлений 1 (SP1) для среды выполнения Visual Studio Tools for Office 3.0. Программа установки проверяет наличие соответствующих версий необходимых компонентов, включая пакет обновлений 1 (SP 1) для среды выполнения, и устанавливает их по мере необходимости. Однако при установке решения без запуска программы установки, установщик не будет выполнять проверку наличия необходимых компонентов и их установку.
Изменение разделов реестра манифеста для надстроек по завершении построения программы установки установщика Windows
Раздел реестра манифеста, являющийся частью программы установки надстройки, в отдельных случаях при построении программы установки установщика Windows может изменить VSTO-файл манифеста на DLL-файл.
Для решения этой проблемы следует создать программу установки в другом решении, либо использовать значение CompanyName.AddinName в качестве значения раздела реестра, в котором содержится имя надстройки.
При использовании Visual Studio 2008 с пакетом обновлений 1 (SP 1) решать данную проблему таким способом необязательно.
Установщик ClickOnce для решений Office не устанавливает основные сборки взаимодействия
При запуске программы установки, созданной ClickOnce для решения Office, установщик основных сборок взаимодействия Office запускается только в случае отсутствия установленных основных сборок взаимодействия.
Если программа установки неправильно устанавливает основные сборки взаимодействия, следует установить основные сборки взаимодействия вручную путем запуска файла установщика с именем o2007pia.msi из каталога установки.
См. также
Основные понятия
Устранение неполадок развертывания ClickOnce
Развертывание решений Office (система 2007)
Ссылки
Устранение неполадок (раздел "Инструкции" пакета Visual Studio Tools for Office)
Журнал изменений
Дата |
Журнал |
Причина |
|---|---|---|
Июль 2008 |
Дополнительные сведения о сценариях устранения неполадок. |
Изменение функции SP1. |