dotNet符號文件(pdb),符號包(snupkg)和SourceLink

来源:https://www.cnblogs.com/ruipeng/p/18093758
-Advertisement-
Play Games

前言 本文的主題是 Visual Studio 調試 NuGet 包,以及符號包的概念,如何去發佈一個 NuGet 包,讓我們的 NuGet 包支持 SouceLink,這些都是我們開發中比較容易忽視的內容,但是熟悉了以後可以讓我們在調試中得心應手,也是開源項目開發的基礎篇。 demo 源代碼在文末 ...


前言

本文的主題是 Visual Studio 調試 NuGet 包,以及符號包的概念,如何去發佈一個 NuGet 包,讓我們的 NuGet 包支持 SouceLink,這些都是我們開發中比較容易忽視的內容,但是熟悉了以後可以讓我們在調試中得心應手,也是開源項目開發的基礎篇。

demo 源代碼在文末

pdb 符號文件

程式資料庫 (.pdb) 文件(也稱為符號文件)將項目源代碼中的標識符和語句映射到已編譯應用中的相應標識符和說明。 這些映射文件將調試器鏈接到源代碼,以進行調試。

在 Visual Studio 調試器(C#、C++、Visual Basic、F#)中指定符號 (.pdb) 和源文件

符號文件的工作方式

.pdb 文件保存調試和項目狀態信息,使用這些信息可以對應用的調試配置進行增量鏈接。 在調試時,Visual Studio 調試器使用 .pdb 文件來確定兩項關鍵信息:

  • 要在 Visual Studio IDE 中顯示的源文件名和行號。
  • 在應用中停止的斷點位置。

調試器只會載入與在生成應用時創建的 .pdb 文件完全匹配的 .pdb 文件(即原始 .pdb 文件或副本)。

我們隨便找一個自己代碼的類庫 Build 可以看一下
image

簡單的講:我們平時在 Visual Studio 中調試代碼 編譯後的dll 文件在和 VS 內代碼文件,斷點等各種調試操作都是跟.pdb 文件內記錄的信息做的映射。

符號包 (.snupkg)

創建符號包

符號包提供了一些關鍵信息,例如已編譯的代碼與源代碼之間的關聯、局部變數的名稱、堆棧跟蹤,代碼源文件映射等。 你可以使用符號包 (.snupkg) 來分發這些符號(.pdb),並改善 NuGet 包的調試體驗。

創建符號包

有兩種方式可以創建符號包

  • .csproj 文件添加屬性
<PropertyGroup>
    <IncludeSymbols>true</IncludeSymbols>
    <SymbolPackageFormat>snupkg</SymbolPackageFormat>
</PropertyGroup>
  • 打包時指定參數
dotnet pack MyPackage.csproj -p:IncludeSymbols=true -p:SymbolPackageFormat=snupkg

那我們創建一個類庫先用第二種命令行打包測試一下看看效果

image

可以看到我們的符號包已經成功創建了。

接下來我們看一下符號包裡面有什麼東西
這裡面用NuGetPackageExplorer本地工具,直接打開本地的包
image

可以看到我們的.pdb 文件已經被打包到符號包中

源鏈接將源代碼管理元數據添加到程式集和 NuGet 包,這麼做的好處是進一步的獲得最佳調試體驗,把源鏈接元數據跟符號包中的pdb文件綁定

github sourcelink

.NET 8 開始,.NET SDK 預設包含對以下來源控制提供商的源鏈接(Source Link)支持:

如果您的項目使用.NET SDK 8+並托管在上述提供商中,則無需引用任何 Source Link 包或設置任何構建屬性,Source Link 已預設啟用。

否則,您可以通過設置幾個屬性並添加適用於提供商的 Source Link 包的 PackageReference 來啟用項目中的 Source Link 體驗,這樣可以實現在指定的來源控制環境中進行無縫調試和源代碼導航。
配置如下

<Project>
 <PropertyGroup>
    <!-- Optional: Publish the repository URL in the built .nupkg (in the NuSpec <Repository> element) -->
    <PublishRepositoryUrl>true</PublishRepositoryUrl>

    <!-- Optional: Embed source files that are not tracked by the source control manager in the PDB -->
    <EmbedUntrackedSources>true</EmbedUntrackedSources>
  </PropertyGroup>
  <ItemGroup>
    <!-- Add PackageReference specific for your source control provider (see below) -->
  </ItemGroup>
</Project>

如果你在 dotNet 8+ 的環境中引用任何的源代碼管理包比如
github.com and GitHub Enterprise

<ItemGroup>
  <PackageReference Include="Microsoft.SourceLink.GitHub" Version="8.0.0" PrivateAssets="All"/>
</ItemGroup>

會禁用.NET SDK 中包含的 Source Link 功能。

本文的所有案例預設都是用 dotNet8 開發的 那按照說明如果代碼在 github 那預設可以不用安裝任何 SourceLinkpackage

接下來我們繼續測試一下在類庫中添加對應的屬性

先提交一下代碼,再打 pack
image

從這可以看出我們的 pdb 符號文件已經包含了 git 的源代碼信息。

推送 Nuget 包

發佈 Nuget 包
我們這裡使用dotnet cli推送
用命令行推送.nupkg包同名的.snupkg符號包預設也會被推送到 nuget.org

 dotnet nuget push dotNetParadise-SourceLink.1.0.1.nupkg -s https://api.nuget.org/v3/index.json --api-key %nugetApiKey%

image

現在 NuGet 包已經推送上去了第一次推送的包 NuGet 平臺需要對其進行索引病毒掃描等 大概需要幾分鐘

image

可以看到我們的符號包以及源代碼地址都已經在 NuGet 平臺顯示了。

VS 調試部分

前面做的部分實際上都是為了我們在給用戶用的時候方便調試,那我們來調試一下看看這個過程。
創建新項目->NuGet 安裝剛纔上傳的包

dotnet add package dotNetParadise-SourceLink --version 1.0.1

調試器查找符號文件的位置

  • 項目文件夾。

  • 在 DLL 或可執行 (.exe) 文件中指定的位置。

    • 預設情況下,如果你在電腦上已生成 DLL 或 .exe 文件,則鏈接器會將關聯的 .pdb 文件的完整路徑和文件名放入 DLL 或 .exe 文件中 。 調試器會檢查該位置是否存在符號文件。
  • 與 DLL 或 .exe 文件相同的文件夾。

  • 在調試器選項中為符號文件指定的任何位置。

    • 任何本地符號緩存文件夾。

    • 指定的網路、Internet 或本地符號伺服器和位置,例如 Microsoft 符號伺服器(如果選擇)。 Visual Studio 可從實現 symsrv 協議的符號伺服器下載調試符號文件。 Visual Studio Team Foundation Server 和 Windows 調試工具是可使用符號伺服器的兩個工具。

  • 可能會用到的符號伺服器包括:

    • 公共 Microsoft 符號伺服器:要調試在調用系統 DLL 或第三方庫時出 現的故障,通常需要系統 .pdb 文件。 系統 .pdb 文件包含 Windows DL、.exe 文件和設備驅動程式的符號 。 你可以從公共 Microsoft 符號伺服器獲取 Windows 操作系統、MDAC、IIS、ISA 和 .NET 的符號。

    • 內部網路或本地電腦上的符號伺服器:你的團隊或公司可為你自己的產品創建符號伺服器,並作為外部源符號的緩存。 你自己的電腦上可能具有符號伺服器。

    • 第三方符號伺服器:Windows 應用程式和庫的第三方提供程式可提供對 Internet 上的符號伺服器的訪問。

瞭解了這部分信息之後,我們的符號包是在 Nuget.org 中所以,需要在 Vs 中開啟如下配置
image

VS 工具->選項->調試->符號 開啟上面符號伺服器的選中,可以設置一個本地緩存的文件夾,另外下麵選擇僅載入指定模塊(如果開啟上面除了排除的全部載入大項目調試起來有點難受)

VS 工具->選項->調試-常規
image

第一步要禁用啟用僅我的代碼

第二部 啟用源伺服器的支持

到這兒基本上配置已經全部完成了

實戰測試一下
我們的類庫實際上是封裝了一個 MinimalApis 的自動註冊功能,感興趣的朋友可以去讀一下我之前的文章

public class TodoApi : IEndPoint
{
    public void MapEndPoints(IEndpointRouteBuilder app)
    {
        var group = app.MapGroupWithTags("Todo");
        group.MapGet("sayhello", (string name) => $"hello {name}");
    }
}

創建一個 apiprogram 調用類庫方法註冊一下

app.RegisterEndPoints();

image

可以看到很對 NuGet 類庫 源碼的調試就舒服多了,可以加斷點修改代碼,加類庫調試。

最後

簡要摘要:

本文介紹了在 Visual Studio中調試 NuGet 包的相關概念,包括 PDB 符號文件、符號包、Source Link 功能以及發佈支持 Source LinkNuGet 包。通過配置符號包和 Source Link,開發者可以更輕鬆地調試外部依賴項的源代碼,提高調試效率。

總結:

  • PDB 符號文件和符號包在調試中起著關鍵作用,幫助將源代碼映射到編譯後的應用程式,提供更詳細的調試信息。
  • Source Link 通過在程式集和 NuGet 包中添加源代碼管理元數據,實現了方便調試外部依賴項的功能。
  • 配置符號伺服器路徑和 Source Link 選項可以使 Visual Studio 更好地支持調試 NuGet 包的源代碼。

本文Demo 源代碼

希望本文能對你有幫助!

本文來自博客園,作者:董瑞鵬,轉載請註明原文鏈接:https://www.cnblogs.com/ruipeng/p/18093758


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 完美收官,本文是爬蟲實戰的最後一章了,所以儘管本文著重呈現爬蟲實戰,但其中有一大部分內容專註於數據分析。爬蟲只是整個過程的起點,其主要目的之一就是為後續數據分析等工作做好準備。通過對爬取的數據進行精確的清洗和分析,可以揭示其中隱藏的規律和趨勢,為決策提供有力支持。因此,爬蟲實戰並不僅僅是技術的展示,... ...
  • 前言 去年又重新刷了路遙的《平凡的世界》,最近也在朋友推薦下,來看了路遙的另一部成名作《人生》。 故事中的主人公高加林,雖生在農村,面朝黃土背朝天,卻不甘心像父輩一樣或者,一心想著擺脫民語的束縛,追求他的理想生活。 然而命運多舛,在他所想象的理想生活中,一次次跌倒,最終不得不承認自己的平凡,生活總得 ...
  • 1 定義 一個數據集是分散式的數據集合。Spark 1.6增加新介面Dataset,提供 RDD的優點:強類型、能夠使用強大lambda函數 Spark SQL優化執行引擎的優點 可從JVM對象構造Dataset,然後函數式轉換(map、flatMap、filter等)操作。Dataset API在 ...
  • 一、前言 隨著網路的發展,企業對於信息系統數據的保密工作愈發重視,不同身份、角色對於數據的訪問許可權都應該大相徑庭。 列如 1、不同登錄人員對一個數據列表的可見度是不一樣的,如數據列、數據行、數據按鈕等都可能不太一樣。 2、表單的靈活設計及呈現。 3、流程的靈活設計及呈現。 4、介面的調用信息者及性能 ...
  • 概述:WPF支持綁定到對象的屬性而不是欄位,主要因為屬性提供了更多控制和擴展性。屬性包含get和set方法,支持數據驗證和通知屬性更改,而欄位通常被認為是內部實現。使用屬性使WPF能夠更靈活、可控地與數據交互,提高代碼的可讀性和可維護性。 WPF(Windows Presentation Found ...
  • 概述:上述C#示例演示瞭如何在同步方法中調用非同步方法。通過使用`async`和`await`關鍵字,實現了同步方法對非同步方法的調用。建議使用`await`而不是`Result`來避免潛在的死鎖問題。這種模式在處理非同步任務時能夠提高代碼的可讀性和性能。 在C#中,從同步方法調用非同步方法的過程涉及到使用 ...
  • 一:背景 1. 講故事 前些天有一位朋友在公眾號上找到我,說他們的WinForm程式部署在20多台機器上,只有兩台機器上的程式會出現崩潰的情況,自己找了好久也沒分析出來,讓我幫忙看下怎麼回事,就喜歡這些有點調試基礎的,dump也不需要我指導怎麼去抓,接下來我們就上windbg開始分析吧。 二:Win ...
  • 構建類型是動態代碼生成過程中的關鍵一環,通過靈活運用 TypeBuilder 和相關工具,我們可以實現各種複雜類型的動態生成,為程式的靈活性和可擴展性提供有力支持。總的來說,本章節通過演示如何使用 Emit 來動態創建類型,包括定義欄位、方法、屬性和事件等, 幫助讀者理解如何在運行時生成和操作類型信... ...
一周排行
    -Advertisement-
    Play Games
  • 1、預覽地址:http://139.155.137.144:9012 2、qq群:801913255 一、前言 隨著網路的發展,企業對於信息系統數據的保密工作愈發重視,不同身份、角色對於數據的訪問許可權都應該大相徑庭。 列如 1、不同登錄人員對一個數據列表的可見度是不一樣的,如數據列、數據行、數據按鈕 ...
  • 前言 上一篇文章寫瞭如何使用RabbitMQ做個簡單的發送郵件項目,然後評論也是比較多,也是準備去學習一下如何確保RabbitMQ的消息可靠性,但是由於時間原因,先來說說設計模式中的簡單工廠模式吧! 在瞭解簡單工廠模式之前,我們要知道C#是一款面向對象的高級程式語言。它有3大特性,封裝、繼承、多態。 ...
  • Nodify學習 一:介紹與使用 - 可樂_加冰 - 博客園 (cnblogs.com) Nodify學習 二:添加節點 - 可樂_加冰 - 博客園 (cnblogs.com) 介紹 Nodify是一個WPF基於節點的編輯器控制項,其中包含一系列節點、連接和連接器組件,旨在簡化構建基於節點的工具的過程 ...
  • 創建一個webapi項目做測試使用。 創建新控制器,搭建一個基礎框架,包括獲取當天日期、wiki的請求地址等 創建一個Http請求幫助類以及方法,用於獲取指定URL的信息 使用http請求訪問指定url,先運行一下,看看返回的內容。內容如圖右邊所示,實際上是一個Json數據。我們主要解析 大事記 部 ...
  • 最近在不少自媒體上看到有關.NET與C#的資訊與評價,感覺大家對.NET與C#還是不太瞭解,尤其是對2016年6月發佈的跨平臺.NET Core 1.0,更是知之甚少。在考慮一番之後,還是決定寫點東西總結一下,也回顧一下.NET的發展歷史。 首先,你沒看錯,.NET是跨平臺的,可以在Windows、 ...
  • Nodify學習 一:介紹與使用 - 可樂_加冰 - 博客園 (cnblogs.com) Nodify學習 二:添加節點 - 可樂_加冰 - 博客園 (cnblogs.com) 添加節點(nodes) 通過上一篇我們已經創建好了編輯器實例現在我們為編輯器添加一個節點 添加model和viewmode ...
  • 前言 資料庫併發,數據審計和軟刪除一直是數據持久化方面的經典問題。早些時候,這些工作需要手寫複雜的SQL或者通過存儲過程和觸發器實現。手寫複雜SQL對軟體可維護性構成了相當大的挑戰,隨著SQL字數的變多,用到的嵌套和複雜語法增加,可讀性和可維護性的難度是幾何級暴漲。因此如何在實現功能的同時控制這些S ...
  • 類型檢查和轉換:當你需要檢查對象是否為特定類型,並且希望在同一時間內將其轉換為那個類型時,模式匹配提供了一種更簡潔的方式來完成這一任務,避免了使用傳統的as和is操作符後還需要進行額外的null檢查。 複雜條件邏輯:在處理複雜的條件邏輯時,特別是涉及到多個條件和類型的情況下,使用模式匹配可以使代碼更 ...
  • 在日常開發中,我們經常需要和文件打交道,特別是桌面開發,有時候就會需要載入大批量的文件,而且可能還會存在部分文件缺失的情況,那麼如何才能快速的判斷文件是否存在呢?如果處理不當的,且文件數量比較多的時候,可能會造成卡頓等情況,進而影響程式的使用體驗。今天就以一個簡單的小例子,簡述兩種不同的判斷文件是否... ...
  • 前言 資料庫併發,數據審計和軟刪除一直是數據持久化方面的經典問題。早些時候,這些工作需要手寫複雜的SQL或者通過存儲過程和觸發器實現。手寫複雜SQL對軟體可維護性構成了相當大的挑戰,隨著SQL字數的變多,用到的嵌套和複雜語法增加,可讀性和可維護性的難度是幾何級暴漲。因此如何在實現功能的同時控制這些S ...