При обновлении лицензионной политики Infragistics или переходе на альтернативные библиотеки компонентов перед разработчиками встает задача полной очистки проекта от пакетов Ignite UI. Часто стандартное удаление через менеджер пакетов оставляет следы в конфигурационных файлах, что приводит к ошибкам компиляции или увеличению размера финального бандла.
Ситуация усугубляется тем, что компоненты могут быть глубоко интегрированы в структуру приложения, требуя не только удаления зависимостей, но и ручной правки кода. Игнорирование этапов глубокой очистки может привести к конфликтам версий при установке новых библиотек интерфейса.
Данное руководство описывает алгоритм действий для различных стеков технологий, позволяя безопасно извлечь компоненты Ignite UI из кодовой базы. Рассмотрены методы работы с.NET, JavaScript и TypeScript проектами, а также способы устранения остаточных артефактов.
Удаление компонентов из проектов.NET и Visual Studio
В среде разработки Visual Studio процесс деинсталляции начинается с управления пакетами NuGet, которые являются основным способом поставки библиотек Infragistics для платформ WPF, WinForms и ASP.NET. Если просто удалить файлы DLL из папки bin, ссылки в проекте останутся активными, что вызовет ошибки сборки при следующем запуске IDE.
Для корректного удаления необходимо открыть диспетчер пакетов, выбрав пункт Сервис → Диспетчер пакетов NuGet → Управление пакетами для решения. В открывшемся окне следует перейти на вкладку «Установлено» и отфильтровать список по ключевому слову "Infragistics" или "Ignite", чтобы визуально идентифицировать все связанные компоненты.
Выделение конкретного пакета и нажатие кнопки «Удалить» запустит скрипт очистки, который удалит ссылки на сборки и внесет изменения в файлы проекта (.csproj). Однако в некоторых случаях, особенно при использовании старых версий Visual Studio, автоматический скрипт может не удалить записи из файла packages.config, что потребует ручного вмешательства.
Очистка конфигурационных файлов проекта
После выполнения стандартной процедуры удаления через интерфейс IDE рекомендуется провести аудит файла packages.config или непосредственно файла проекта .csproj. В этих файлах могут сохраниться строки импорта, которые препятствуют чистой сборке решения.
Откройте файл проекта в текстовом редакторе и найдите секцию <ItemGroup>, содержащую ссылки на пакеты. Удаление строк, содержащих идентификаторы Infragistics.Web.Core или Infragistics.WPF, является обязательным шагом для предотвращения попыток NuGet восстановить удаленные зависимости.
Если в проекте использовались специфические настройки сборки, связанные с Infragistics, они могут находиться в файле app.config или web.config. Стоит проверить секции <configurationSections> и <runtime> на наличие ссылок на сборки Infragistics и удалить их, если они больше не требуются для работы приложения.
📋 Удаление через NuGet
Эти файлы необходимо искать и удалять отдельно, проверяя папку Content или Resources в структуре проекта.
Очистка JavaScript и TypeScript проектов (npm/yarn)
В экосистеме JavaScript удаление Ignite UI для фреймворков Angular, React или Vue требует работы с менеджером пакетов node.js. Простое удаление папки node_modules не является решением, так как зависимости зафиксированы в файлах package.json и package-lock.json, и при следующей установке они будут загружены снова.
Процесс начинается с открытия терминала в корне проекта и выполнения команды удаления конкретного пакета. Для стандартной установки это обычно @infragistics/igniteui-angular, igniteui-webcomponents или специфичные пакеты для React. Команда npm uninstall package-name удалит запись из манифеста и физически уберет файлы из директории модулей.
После удаления основного пакета необходимо проверить список зависимостей на наличие смежных библиотек, таких как igniteui-trial-watermark или утилиты для локализации. Часто эти пакеты устанавливаются отдельно и остаются в проекте, занимая место и потенциально вызывая конфликты именования.
Работа с конфигурацией Angular и Webpack
Если Ignite UI был интегрирован в проект Angular, вероятно, были внесены изменения в файл angular.json. В секции styles и scripts могли быть добавлены пути к CSS и JS файлам библиотеки, которые теперь ведут в никуда и вызывают ошибки при сборке.
Необходимо открыть angular.json и удалить строки, содержащие ссылки на node_modules/igniteui-angular или аналогичные пути. Также стоит проверить файл tsconfig.json на наличие путей (paths), указывающих на модули Infragistics, и убрать их для предотвращения ошибок разрешения модулей TypeScript.
В проектах, использующих Webpack напрямую или через eject, требуется проверка конфигурации плагинов. Плагин CopyWebpackPlugin мог быть настроен на копирование шрифтов или изображений Ignite UI в папку дистрибутива, и эти настройки нужно удалить вручную из webpack.config.js.
Особое внимание следует уделить глобально установленным CLI инструментам, если они использовались для генерации проектов. Хотя они не влияют на рантайм, их наличие в системе может создавать путаницу при создании новых проектов или использовании генераторов кода.
Удаление плагинов и расширений IDE
Разработчики часто устанавливают расширения для Visual Studio или VS Code, такие как Infragistics NuGet Package Manager или сниппеты кода, которые облегчают работу с Ignite UI. Эти расширения не удаляются вместе с пакетами проекта и остаются активными в среде разработки.
В Visual Studio переход в меню Расширения → Управление расширениями позволяет увидеть список установленных инструментов. Поиск по слову "Infragistics" выявит все связанные компоненты, которые можно дезактивировать или удалить. После удаления расширения часто требуется перезагрузка IDE или даже всей операциной системы для полного освобождения файлов.
Для пользователей Visual Studio Code процесс аналогичен: необходимо открыть панель расширений (Ctrl+Shift+X), найти плагины Infragistics и нажать «Удалить». Важно также проверить настройки редактора (settings.json), где могли быть прописаны пути к исполняемым файлам или конфигурации IntelliSense для Ignite UI.
Очистка кэша и временных файлов
IDE и менеджеры пакетов активно используют кэширование для ускорения работы. При удалении библиотек старые версии файлов могут оставаться в локальном кэше NuGet (%userprofile%\.nuget\packages) или npm (%appdata%\npm-cache).
Очистка кэша NuGet выполняется командой dotnet nuget locals all --clear в терминале. Это освободит дисковое пространство и гарантирует, что при повторной установке зависимостей не будут использоваться поврежденные или устаревшие файлы из кэша.
Для npm аналогичной командой является npm cache clean --force. Выполнение этой операции особенно полезно, если в процессе удаления возникали ошибки или если планируется перенос проекта на другую машину, где кэш чист.
| Расположение кэша | Путь по умолчанию (Windows) | Команда очистки |
|---|---|---|
| NuGet | %userprofile%\.nuget\packages |
dotnet nuget locals all --clear |
| NPM | %appdata%\npm-cache |
npm cache clean --force |
Анализ остаточных файлов и реестра
Даже после выполнения всех процедур удаления в системе могут остаться следы присутствия Ignite UI. Это особенно актуально для Windows, где компоненты могли регистрироваться в реестре или оставлять файлы конфигурации в системных папках.
Проверка реестра Windows требует осторожности. Необходимо открыть редактор реестра (regedit) и перейти в ветку HKEY_CURRENT_USER\Software\Infragistics. Если планируется полное удаление продуктов Infragistics, эту ветку можно удалить, но только если другие приложения не используют общие компоненты.
Также стоит проверить переменные окружения. Иногда установщики добавляют пути к бинарным файлам в переменную PATH. Удаление этих записей предотвратит случайный запуск устаревших улит и очистит системное окружение.
Поиск скрытых зависимостей в коде
Автоматические инструменты не всегда находят жестко прописанные ссылки в коде. Используйте функцию «Найти в файлах» в IDE для поиска строк using Infragistics, import { IgxGridModule } или подключений CSS файлов.
Особое внимание уделите файлам HTML и Razor, где компоненты могли быть добавлены как теги. Наличие таких тегов после удаления библиотеки приведет к падению приложения при рендеринге интерфейса.
Проверка файлов глобальных стилей (styles.css, site.scss) также необходима. Часто туда импортируются темы Ignite UI, которые после удаления пакетов перестанут компилироваться и вызовут ошибки сборщика.
📋 Поиск остатков
Если проект использует Docker, необходимо пересобрать образы контейнеров. Слои образа могли закэшировать установленные пакеты, и без пересборки (docker build --no-cache) удаленные компоненты останутся внутри контейнера.
Типичные ошибки при удалении
- Удаление только папки node_modules или bin — это приводит к тому, что при следующей сборке пакетный менеджер видит записи в конфигурационных файлах и восстанавливает удаленные библиотеки, сводя усилия к нулю.
- Игнорирование файлов блокировки (lock files) — если не обновить или не удалить
package-lock.jsonилиpackages.lock.json, версия пакета останется зафиксированной, и CI/CD пайплайны могут продолжить использовать старую версию. - Оставление импортов в глобальных файлах — удаление пакета из зависимостей без удаления строк импорта в
main.ts,program.csилиapp.module.tsгарантированно вызовет ошибку компиляции "Module not found". - Нарушение порядка удаления — попытка удалить базовые библиотеки Infragistics до удаления зависимых от них компонентов может вызвать ошибки в скриптах uninstaller, прервав процесс на полпути.
Полная очистка проекта
- ✅ Снижение размера бандла
- ❌ Риск удалить нужные конфигурации:Требуется время на ручной аудит
Резюме
Процесс удаления Ignite UI требует комплексного подхода, включающего не только стандартную деинсталляцию пакетов, но и глубокую очистку конфигурационных файлов, кэша и кодовой базы. Игнорирование любого из этапов может привести к нестабильной работе среды разработки или ошибкам при сборке проекта.
Регулярная проверка проекта на наличие осиротевших зависимостей и использование специализированных команд очистки кэша помогают поддерживать проект в чистоте. Правильное выполнение всех шагов гарантирует, что переход на другие библиотеки или обновление лицензий пройдет без технических осложнений.