Merupakan library contoh untuk penggunaan source link. Dapat diunduh pada link berikut: Nuget Package
Step Source Link:
- Nyalakan debugging tools, Tools > Options > Debugging:
- Pada tab General: matikan "Enable Just My Code", lalu nyalakan "Enable Source Link Support"
- Pada tab Symbols: tambah symbol server yang menjadi sumber artifak
- sumber: https://endjin.com/blog/2022/05/debugging-nuget-packages-understanding-debugging-symbols-and-using-source-link
-
Pada class library, tambahkan package Source Link supaya dapat link antara nuget package dengan source code. Sebagai contoh: Microsoft.SourceLink.Github jika anda menggunakan github
-
Tambahkan beberapa metadata yang diperlukan pada file .csproj dari class library, best practice dapat dilihat pada halaman berikut: https://learn.microsoft.com/en-us/nuget/create-packages/package-authoring-best-practices
-
Pastikan project akan membuat symbol package berformat .snupkg, setelan ini dapat ditambahkan sebagai berikut:
<PropertyGroup>
<IncludeSymbols>True</IncludeSymbols>
<SymbolPackageFormat>snupkg</SymbolPackageFormat>
</PropertyGroup>- Jika anda tidak menggunakan CI/CD, beberapa hal yang harus diperhatikan:
- push source code terbaru dari class library ke repository sebelum melakukan pack
- clean project
- build project
- pack project
- file .nupkg dan .snupkg siap di upload
- Untuk mengecek apakah package sudah terhubung dengan symbol server, anda dapat menggunakan program Nuget Package Explorer yang dapat diunduh di sini: Nuget Package Explorer
- Pilih "Open Package From Online Feed (Ctrl + G)"
- Lalu cari nuget package yang ingin dicek
- Setelah itu anda bisa cek apakah package sudah terhubung dengan symbol server atau belum
- Setelah semuanya sudah siap, anda dapat melakukan debugging dengan library yang anda install dari nuget package manager