Уточните, какой ярлык обещает пакет: рабочий стол, меню «Пуск», текущий пользователь или все пользователи. Затем проверьте журнал установки и строку ярлыка в MSI. Успешная установка файлов ещё не означает, что компонент ярлыка был выбран и установлен в ожидаемую область.
Если пакет использует другой установщик, применяйте его модель компонентов и журналов. Названия полей ниже относятся к Windows Installer MSI. Ручное создание ярлыка подходит для проверки запуска, но не исправляет жизненный цикл установки, обновления и удаления.
Строка Shortcut связывает несколько решений
| Поле MSI | Что установить при разборе |
|---|---|
| Directory_ | Куда создаётся файл ярлыка |
| Component_ | Какой компонент управляет установкой |
| Target | Что должен запускать ярлык |
| Arguments | Какие параметры передаются |
| WkDir | Какая рабочая папка предусмотрена |
По документации Microsoft ярлык создаётся или удаляется в зависимости от состояния связанного компонента; у компонента должен быть допустимый key path. Для advertised и non-advertised ярлыков Target имеет разный смысл. Источник проверен 28 октября 2026 года. Нельзя исправлять оба типа одинаковой подстановкой абсолютного пути в пакет.
Условная карта диагностики:
Shortcut row -> Component_ -> состояние установки
Directory_ -> фактический каталог назначения
Target -> ожидаемая цель по типу ярлыка
Arguments -> параметры запуска
WkDir -> рабочая папка
Сверять нужно установленный пакет, а не старый проект сборки.Отсутствие ярлыка и неработающий ярлык — разные ветви. Если файл .lnk существует, откройте его свойства и сравните цель с реальным местом установки. Если файла нет, сначала исследуйте выбор компонента, условие установки и каталог назначения, а не переписывайте параметры запуска приложения.
Установщик мог работать от имени другого пользователя
Сопоставьте выбранную область развёртывания с человеком, который проверяет результат. При административной установке путь пользовательского ярлыка может оказаться не тем, который предполагал автор пакета. Зафиксируйте контекст запуска, настройки пакета и фактический профиль, не делая вывод только по наличию прав администратора.
Не используйте жёстко заданный путь вида C:\Users\имя\Desktop. Расположение рабочего стола определяется системой и окружением пользователя. Применяйте предусмотренные установщиком каталоги назначения; затем смотрите их разрешённое значение в журнале конкретной установки. Переадресованный рабочий стол — отдельный тестовый сценарий.
Убедитесь, что ярлык действительно включён в выбранную функцию пакета. Опциональная функция могла быть пропущена, а компонент — сохранён из прежнего состояния. Добавлять после установки произвольный скрипт копирования значит создавать второго владельца ярлыка: при удалении и ремонте поведение станет менее предсказуемым.
Чистая установка и обновление проверяют разные пути
- На чистом тестовом профиле установить выбранные функции пакета.
- Найти ярлык в обещанном месте и запустить приложение.
- Повторить проверку для второго пользователя согласно области установки.
- Обновить предыдущую версию и проверить цель ярлыка.
- Выполнить штатное удаление и сравнить оставшиеся элементы.
При обновлении следите, не удаляет ли старая версия ярлык, который только что создала новая. Исправление зависит от последовательности обновления и владения компонентами. Сохраните логи обеих фаз; один финальный экран «готово» не показывает, какой пакет выполнил последнее действие.
Проверьте запуск из ярлыка с обычными правами и ожидаемыми параметрами. Программа может случайно зависеть от рабочей папки установщика. Тогда ярлык появляется корректно, но открывает пустое окно или не находит ресурсы. Такую ошибку следует разбирать отдельно от создания .lnk.
Перед передачей задачи подготовьте версию MSI, выбранную область, журнал установки и обезличенную строку Shortcut со связанным компонентом. Приёмочный результат включает место ярлыка, правильную цель и предсказуемое поведение после обновления и удаления. Это позволяет исправить пакет один раз для всех следующих установок.