SourceLink
SourceLink es una tecnología que permite a los desarrolladores depurar el código fuente de los ensamblados de .NET de NuGet. SourceLink se ejecuta al crear el paquete NuGet e inserta metadatos de control de código fuente dentro de los ensamblados y el paquete. Los desarrolladores que descarguen el paquete y tengan SourceLink habilitado en Visual Studio pueden entrar en su código fuente. SourceLink proporciona metadatos de control de origen para crear una excelente experiencia de depuración.
Demostración de SourceLink
Uso de SourceLink
Puede encontrar instrucciones para el uso de SourceLink en el repositorio de GitHub dotnet/sourcelink.
Puede usar la aplicación de escritorio Explorador de paquetes NuGet o el sitio web nuget.info para confirmar que los metadatos de SourceLink se han insertado correctamente en el paquete. Compruebe que los metadatos de Repository
están presentes con un identificador de confirmación y que los archivos .pdb se encuentran con los .dll de cada destino.
✔️ ES RECOMENDABLE usar SourceLink para agregar metadatos de control de código fuente a los ensamblados y los paquetes NuGet.
Sugerencia
Puede mejorar aún más la experiencia de depuración de los desarrolladores mediante la adición de atributos del depurador a los tipos.
- DebuggerDisplayAttribute puede personalizar cómo se muestra una clase o un campo en las ventanas de variables del depurador.
- DebuggerStepThroughAttribute indica al depurador que recorra el código en lugar de ejecutarlo paso a paso.
- DebuggerBrowsableAttribute controla si se muestra un miembro en las ventanas de variables del depurador.
✔️ ES RECOMENDABLE publicar archivos de símbolos (*.pdb
).
Para obtener la mejor experiencia de depuración, la biblioteca debe publicar archivos de símbolos, además de usar SourceLink. Para más información sobre los archivos de símbolos y los paquetes de símbolos, consulte Paquetes de símbolos.
✔️ CONSIDERE la posibilidad de habilitar compilaciones deterministas.
Las compilaciones deterministas permiten comprobar que el binario resultante se compiló a partir del origen especificado y proporcionan trazabilidad. Para más información sobre las compilaciones deterministas y las instrucciones para habilitarlas, consulte Compilaciones deterministas.