Actualizador de NuGet (NuGet Updater)
Abrir la aplicación: Actualiza paquetes NuGet → (products.documentize.ai)
En una frase
NuGet Updater revisa un repositorio de GitHub en busca de paquetes NuGet desactualizados y, o bien los informa, o bien los actualiza y abre un pull request con un informe de lo que cambió y de lo que se dejó sin tocar.
Qué lo hace único
Edita solo los valores de versión donde se declaran los paquetes (el Directory.Packages.props central, los archivos .csproj, los .props/.targets compartidos), comprueba cada subida frente a los intervalos de versiones que exigen tus otros paquetes y revierte cualquier subida que añada errores nuevos. El pull request enumera cada actualización y cada actualización que no hizo, con el motivo.
Cuándo usarlo y cuándo no
- Úsalo para la higiene rutinaria de dependencias, o para ver qué va por detrás antes de un sprint de actualización.
- No sirve para proyectos con
packages.config(no compatible). Las versiones escritas como propiedades de MSBuild (como$(MyVersion)) se informan, pero no se cambian. - Para ver qué cambia una versión nueva en la API → Chat de Assembly (Assembly Chat) con Diff.
Antes de empezar
- Un repositorio de GitHub, como
owner/nameo URL, con proyectos de .NET de estilo SDK que usenPackageReference. - ¿Repositorio privado? Invita como colaborador a
arise-project. Si puede hacer push al repositorio, la rama de actualización se crea ahí; si no, el pull request se abre desde su fork. La copia de trabajo se elimina cuando termina el trabajo. - Política opcional: añade un archivo
nugetnews.jsonen la raíz del repositorio para fijar paquetes con un motivo, ignorarlos o permitir versiones preliminares, con comodines comoMicrosoft.Extensions.*.
Paso a paso
- Escribe el repositorio de GitHub; opcionalmente una rama y una solución (.sln).
- Elige el modo, la actualización mínima para incluir, los paquetes máximos y Verificar por.
- Ejecútalo. La página muestra un informe.
- En el modo pull request, abre el pull request, deja que tu CI lo compile y fusiónalo.
- Descarga el informe si lo quieres como archivo.
Opciones explicadas
| Opción | Qué hace | Valor por defecto | Recomendado |
|---|---|---|---|
| Solución (.sln) | Limita la ejecución a una solución | todas las soluciones | Defínela en monorepos |
| Modo: Solo informe | Enumera las actualizaciones disponibles, no cambia nada | seleccionado en la página | Empieza aquí |
| Modo: Actualizar y abrir una solicitud de extracción | Aplica las subidas en una rama nueva y abre un pull request | – | Después de leer el informe |
| Modo: Ver semanalmente | Se ofrece en la página, pero aún no está programado; una ejecución así solo informa | – | No cuentes con él |
| Actualización mínima para incluir | Parche, Menor o Mayor: se omiten las subidas más pequeñas que esta | Parche | Parche/Menor por seguridad |
| Paquetes máximos | Aplica como máximo esta cantidad, empezando por la subida más pequeña (de 1 a 500) | 100 | Redúcelo para tener pull requests revisables |
| Verificar por | Automático, Restaurar o Compilar | Automático | Automático |
Qué obtienes
- Un informe markdown (
nuget-updates.md) y un informe en la página. - En el modo pull request: un commit que cambia solo valores de versión (más los archivos de bloqueo si tu restauración los actualiza). La descripción enumera cada paquete actualizado con su versión antigua y nueva, y los revertidos u omitidos con sus motivos.
- Si no se pudo ejecutar ninguna compilación, el pull request es un borrador marcado como no verificado por compilación.
Calidad y límites
Trabajo determinista con dependencias, no IA creativa: las versiones proceden de nuget.org y de tus restricciones. La verificación comprueba los intervalos de dependencias y, donde hay un SDK de .NET disponible, restaura los proyectos afectados; la página dice que no se compiló nada cuando abre un borrador, así que decide tu CI. Cualquier cosa distinta de un modo pull request explícito solo produce un informe.
Funciona bien con
- Ejecuta antes de esta aplicación: Chat de Assembly (Assembly Chat) para comprobar los cambios de API de una actualización.
- Ejecuta después de esta aplicación: Documentos del repositorio (Repo Docs) para refrescar la documentación.
- Relacionado: Asistente de refactorización (Refactor Assistant).
Errores frecuentes y soluciones
- Esperaba un pull request y obtuve un informe → elige el modo pull request.
- Un paquete no se actualizó → está fijado, ignorado, fuera de tu subida mínima, o un paquete dependiente no acepta la versión nueva; lee la lista de los retenidos.
- Versión como
$(Property)sin cambios → es así por diseño; edítala a mano. - El pull request es un borrador → no se compiló nada; ejecuta tu CI.
Lo mismo en otros canales
No verificado para esta aplicación. Consulta canales.
Pruébalo
Ejecuta Solo informe sobre un repositorio público de .NET con Actualización mínima = Mayor. Cuenta las actualizaciones y vuelve a ejecutarlo con Parche para ver cómo crece la lista. No empieces nunca con el modo pull request en un repositorio que no controles.