NuGet Updater
Открыть приложение: Обновить пакеты NuGet → (products.documentize.ai)
В одном предложении
NuGet Updater проверяет репозиторий GitHub на устаревшие пакеты NuGet и либо сообщает о них, либо поднимает версии и открывает pull request с отчётом о том, что изменено и что оставлено без изменений.
Чем он уникален
Он правит только значения версий там, где объявлены пакеты (центральный Directory.Packages.props, файлы .csproj, общие .props/.targets), проверяет каждое повышение на соответствие диапазонам версий, которые требуют ваши другие пакеты, и откатывает любое повышение, которое добавляет новые ошибки. В pull request перечислены все сделанные обновления и все несделанные — с причиной.
Когда использовать и когда нет
- Используйте для регулярной гигиены зависимостей или чтобы увидеть, что отстало, перед спринтом обновления.
- Не для проектов на
packages.config(не поддерживается). Версии, записанные как свойства MSBuild (например,$(MyVersion)), попадают в отчёт, но не меняются. - Чтобы увидеть, что новая версия меняет в API → Assembly Chat с Diff.
Прежде чем начать
- Репозиторий GitHub в виде
owner/nameили URL с проектами .NET в формате SDK, использующимиPackageReference. - Приватный репозиторий? Пригласите
arise-projectкак соавтора. Если у него есть право записи в репозиторий, ветка с обновлениями создаётся там; иначе pull request открывается из его форка. Рабочая копия удаляется по окончании задачи. - Необязательная политика: добавьте в корень репозитория файл
nugetnews.json, чтобы закрепить пакеты с указанием причины, игнорировать их или разрешить предварительные версии; можно использовать шаблоны вродеMicrosoft.Extensions.*.
Пошаговая инструкция
- Введите репозиторий GitHub; при желании Ветку и Решение (.sln).
- Выберите Режим, Минимальное обновление для включения, Максимум пакетов и Verify by (способ проверки).
- Запустите. Страница покажет отчёт.
- В режиме pull request откройте pull request, дайте вашему CI его собрать и слейте.
- Скачайте отчёт, если он нужен как файл.
Параметры
| Параметр | Что делает | По умолчанию | Рекомендуется |
|---|---|---|---|
| Решение (.sln) | Ограничивает запуск одним решением | все решения | Задавайте в монорепозиториях |
| Режим: Только отчёт | Перечисляет доступные обновления, ничего не меняет | выбрано на странице | Начинайте с него |
| Режим: Обновить и открыть запрос на слияние | Применяет повышения в новой ветке и открывает pull request | – | После прочтения отчёта |
| Режим: Смотреть еженедельно | Есть на странице, но пока не запланирован; такой запуск только формирует отчёт | – | Не рассчитывайте на него |
| Минимальное обновление для включения | Patch, Minor или Major: повышения меньше этого уровня пропускаются | Patch | Patch/Minor для безопасности |
| Максимум пакетов | Применить не более этого числа, начиная с наименьших повышений (от 1 до 500) | 100 | Уменьшите, чтобы pull request можно было проверить |
| Verify by (способ проверки) | Автоматический, Восстановить или Компилировать | Автоматический | Автоматический |
Что вы получите
- Отчёт в markdown (
nuget-updates.md) и отчёт на странице. - В режиме pull request: один коммит, меняющий только значения версий (плюс файлы блокировки, если ваше восстановление их обновляет). В описании перечислен каждый обновлённый пакет со старой и новой версией, а также откатанные или пропущенные — с причинами.
- Если сборку выполнить не удалось, pull request будет черновиком с пометкой «сборка не проверена».
Качество и ограничения
Детерминированная работа с зависимостями, а не творческий ИИ: версии берутся с nuget.org и из ваших ограничений. Проверка анализирует диапазоны зависимостей и, где доступен SDK .NET, восстанавливает затронутые проекты; когда открывается черновик, страница сообщает, что ничего не собиралось, так что решает ваш CI. Всё, кроме явного режима pull request, даёт только отчёт.
Хорошо сочетается с
- До: Assembly Chat, чтобы проверить изменения API при обновлении.
- После: Repo Docs, чтобы обновить документацию.
- Связанное: Refactor Assistant.
Типичные ошибки и их исправление
- Ожидали pull request, получили отчёт → выберите режим pull request.
- Пакет не обновился → он закреплён, игнорируется, лежит ниже вашего минимального повышения или зависящий от него пакет не принимает новую версию; прочитайте список остановленных.
- Версия вида
$(Property)не изменилась → так задумано; правьте вручную. - Pull request — черновик → ничего не собиралось; запустите свой CI.
То же в других каналах
Для этого приложения не проверено. См. каналы.
Попробуйте
Запустите Только отчёт на публичном репозитории .NET с Минимальным обновлением = Major. Сосчитайте обновления, затем запустите снова с Patch и посмотрите, как вырастет список. Никогда не начинайте с режима pull request на репозитории, которым вы не управляете.