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

2025-02-11

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

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

Общие ошибки

При попытке найти файл приложения, ничего не происходит или отрисовка XML в Internet Explorer, или вы получите диалоговое окно "Запуск или сохранение от имени"

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

Сначала убедитесь, что сервер настроен на связывание расширения приложения с типом контента "application/x-ms-application".

Если сервер настроен правильно, убедитесь, что на компьютере установлен платформа .NET Framework 2.0. Если установлен платформа .NET Framework 2.0, и вы по-прежнему видите эту проблему, попробуйте удалить и переустановить платформа .NET Framework 2.0, чтобы повторно зарегистрировать тип контента на клиенте.

Ошибка: "Не удается получить приложение. Файлы, отсутствующие в развертывании, или "Скачивание приложения было прервано, проверьте наличие сетевых ошибок и повторите попытку позже".

Это сообщение указывает, что не удается скачать один или несколько файлов, на которые не удается загрузить ссылку на манифесты ClickOnce. Самый простой способ отладки этой ошибки — попытаться скачать URL-адрес, который ClickOnce говорит, что он не может скачать. Ниже приведены некоторые возможные причины.

Если файл журнала говорит "(403) Запрещено" или "(404) Не найден", убедитесь, что веб-сервер настроен так, чтобы он не блокировать скачивание этого файла. Дополнительные сведения см. в разделе Вопросы настройки сервера и клиента в развертываниях ClickOnce.
Если файл конфигурации config блокируется сервером, см. сообщение об ошибке загрузки при попытке установить приложение ClickOnce с файлом конфигурации.
Определите, произошла ли эта ошибка, так как deploymentProvider URL-адрес в манифесте развертывания указывает на расположение, отличное от URL-адреса, используемого для активации.
Убедитесь, что все файлы присутствуют на сервере; Журнал ClickOnce должен сообщить вам, какой файл не найден.
Узнайте, возникают ли проблемы с сетевым подключением; Это сообщение можно получить, если клиентский компьютер перешел в автономный режим во время скачивания.

Ошибка скачивания при попытке установить приложение ClickOnce с файлом конфигурации

По умолчанию приложение на основе Windows Visual Basic включает файл app.config . Если вы попытаетесь установить с веб-сервера, использующего Windows Server 2003, может возникнуть проблема, так как эта операционная система блокирует установку файлов конфигурации по соображениям безопасности. Чтобы включить установку файла конфигурации, выберите "Использовать расширение ".deploy" в диалоговом окне "Параметры публикации".

Кроме того, необходимо задать типы контента (также известные как типы MIME) для файлов .application, manifest и .deploy . Дополнительные сведения см. в документации по веб-серверу.

Дополнительные сведения см. в разделе Windows Server: типы контента, заблокированные.

Ошибка: приложение неправильно отформатировано; Файл журнала содержит недопустимый XML-сигнатуру.

Убедитесь, что вы обновили файл манифеста и снова подписали его. Повторно опубликуйте приложение с помощью Visual Studio или используйте Mage для повторной подписи приложения.

Вы обновили приложение на сервере, но клиент не скачивает обновление.

Эту проблему можно решить, выполнив одну из следующих задач:

deploymentProvider Проверьте URL-адрес в манифесте развертывания. Убедитесь, что вы обновляете биты в том же расположении, на которое deploymentProvider указывает.
Проверьте интервал обновления в манифесте развертывания. Если этот интервал установлен в качестве периодического интервала, например один раз каждые шесть часов, ClickOnce не будет проверять обновление до тех пор, пока этот интервал не будет пройден. Манифест можно изменить для проверки обновления при каждом запуске приложения. Изменение интервала обновления — это удобный вариант во время разработки для проверки установки обновлений, но он замедляет активацию приложения.
Попробуйте снова запустить приложение на меню . ClickOnce, возможно, обнаружил обновление в фоновом режиме, но предложит установить биты на следующей активации.

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

Эта ошибка может возникать из-за того, что вы вручную редактировали манифесты развертывания и приложения и приводили к тому, что описание удостоверения сборки в одном манифесте не синхронизировано с другим. Удостоверение сборки состоит из его имени, версии, языка и региональных параметров и маркера открытого ключа. Изучите описания удостоверений в манифестах и исправьте все различия.

ClickOnce использует URL-адрес поставщика развертывания для получения обновлений для приложения. Убедитесь, что расположение, на которое указывает URL-адрес, правильно.

Ошибка. Не удается запустить приложение

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

Проблему можно устранить следующим способом.

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

Параметры PrivatePath в файле конфигурации приложения не учитываются

Чтобы использовать путь к privatePath (пути проверки fusion), приложение должно запросить разрешение на полное доверие. Попробуйте изменить манифест приложения, чтобы запросить полное доверие, а затем повторите попытку.

Во время удаления появится сообщение "Не удалось удалить приложение"

Обычно это сообщение указывает на то, что приложение уже удалено или хранилище повреждено. После нажатия кнопки "ОК" запись "Добавить и удалить программу " будет удалена.

Во время установки появится сообщение о том, что зависимости платформы не установлены

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

Публикация в Visual Studio

Сбой публикации в Visual Studio

Убедитесь, что у вас есть право на публикацию на сервере, на который вы нацелены. Например, если вы вошли на компьютер сервера терминала в качестве обычного пользователя, а не в качестве администратора, у вас, вероятно, нет прав, необходимых для публикации на локальном веб-сервере.

Если вы публикуете URL-адрес, убедитесь, что на целевом компьютере включены расширения сервера FrontPage.

Ошибка. Не удается создать веб-сайт "<сайт>". Компоненты для взаимодействия с расширениями сервера FrontPage не установлены

Убедитесь, что на компьютере, на котором выполняется публикация, установлен компонент разработки веб-приложений Microsoft Visual Studio. Для пользователей Express этот компонент по умолчанию не устанавливается.

Ошибка: не удалось найти файл Microsoft.Windows.Common-Controls, Version=6.0.0.0, Culture=, PublicKeyToken=6595b6414ccf1df, ProcessorArchitecture=, Type=win32'

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

Использование Mage

Вы попытались подписать сертификат в хранилище сертификатов и поле получения пустого сообщения

В диалоговом окне "Подписывание" необходимо:

Выберите "Подписать" с сохраненным сертификатом.
Выберите сертификат из списка; Первый сертификат не является выбранным по умолчанию.

Нажатие кнопки "Не подписывание" приводит к исключению

Эта проблема является известной ошибкой. Все манифесты ClickOnce должны быть подписаны. Просто выберите один из параметров подписи, а затем нажмите кнопку "ОК".

Дополнительные ошибки

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

Сообщение об ошибке	Description
Не удается запустить приложение. Обратитесь к издателю приложения. Не удается запустить приложение. Обратитесь к поставщику приложений за помощью.	Это универсальные сообщения об ошибках, которые возникают, когда приложение не может быть запущено, и ни одна другая конкретная причина не найдена. Часто это означает, что приложение каким-то образом повреждено или что хранилище ClickOnce повреждено.
Не удается продолжить. Приложение неправильно отформатировано. Обратитесь к издателю приложения за помощью. Проверка приложений не завершилась успешно. Не удается продолжить. Не удалось получить файлы приложения. Файлы повреждены в развертывании.	Один из файлов манифеста в развертывании является синтаксически недопустимым или содержит хэш, который не может быть согласован с соответствующим файлом. Эта ошибка также может указывать на то, что манифест, внедренный в сборку, поврежден. Повторно создайте развертывание и перекомпилируйте приложение или найдите и исправьте ошибки вручную в манифестах.
Не удается получить приложение. Ошибка проверки подлинности. Установка приложения не завершилась успешно. Не удается найти файлы приложений на сервере. Обратитесь к издателю приложения или администратору за помощью.	Невозможно скачать один или несколько файлов в развертывании, так как у вас нет разрешения на доступ к ним. Это может быть вызвано ошибкой 403 Запрещено, возвращаемой веб-сервером, что может произойти, если один из файлов в развертывании заканчивается расширением, которое делает веб-сервер рассматривать его как защищенный файл. Кроме того, каталог, содержащий один или несколько файлов приложения, может потребовать имени пользователя и пароля для доступа.
Не удается скачать приложение. Приложение отсутствует необходимые файлы. Обратитесь за помощью к поставщику приложений или системному администратору.	На сервере не удается найти один или несколько файлов, перечисленных в манифесте приложения. Убедитесь, что вы отправили все зависимые файлы развертывания и повторите попытку.
Загрузка приложения не выполнена. Проверьте сетевое подключение или обратитесь к системному администратору или поставщику сетевых служб.	ClickOnce не может установить сетевое подключение к серверу. Проверьте доступность сервера и состояние сети.
Сбой URLDownloadToCacheFile с помощью HRESULT "<number>". Произошла ошибка при попытке скачать< файл>.	Если пользователь установил параметр Расширенной безопасности Internet Explorer "Предупреждать, если изменяется между безопасным и небезопасным режимом" на целевом компьютере развертывания, и если установленный URL-адрес установки приложения ClickOnce перенаправляется с небезопасного сайта (или наоборот), установка завершится ошибкой, так как предупреждение Internet Explorer прерывает его. Чтобы устранить эту ошибку, можно выполнить одну из следующих задач: — Снимите параметр безопасности. — Убедитесь, что URL-адрес установки не перенаправляется таким образом, чтобы изменить режимы безопасности. — удалите перенаправление полностью и укажите фактический URL-адрес установки.
Произошла ошибка записи на жесткий диск. На диске может быть недостаточно места. Обратитесь за помощью к поставщику приложений или системному администратору.	Это может указывать на недостаточно места на диске для хранения приложения, но может также указывать на более общую ошибку ввода-вывода при попытке сохранить файлы приложения на диске.
Не удается запустить приложение. На диске недостаточно места.	Жесткий диск заполнен. Очистите место и повторите попытку запуска приложения.
Слишком много развернутых активаций одновременно пытается загрузить.	ClickOnce ограничивает количество разных приложений, которые могут запускаться одновременно. Это в значительной степени помогает защититься от вредоносных попыток наложения атак типа "отказ в обслуживании" на локальную службу ClickOnce; пользователи, которые пытаются запустить одно и то же приложение многократно, в быстром успешном выполнении, будут только в конечном итоге одним экземпляром приложения.
Сочетания клавиш не могут быть активированы по сети.	Сочетания клавиш к приложению ClickOnce можно запустить только на локальном жестком диске. Их нельзя запустить, открыв URL-адрес, указывающий на ярлыковый файл на удаленном сервере.
Приложение слишком большое, чтобы работать в Сети в частичном доверии. Обратитесь за помощью к поставщику приложений или системному администратору.	Приложение, которое выполняется в частичном доверии, не может превышать половину размера квоты веб-приложения, которая по умолчанию составляет 250 МБ.