标签：文件 EmbedAllSources 符号 NuGet Roslyn 源代码 PDB 调试
本文来告诉大家如何在项目文件里面添加上 EmbedAllSources 属性，将自己的代码嵌入到 PDB 符号文件里面，让开发者们在调试的时候，可以看到库的源代码
是否记得 PDB 符号文件的作用？符号文件将会记录着 DLL 文件里面的二进制内容和源代码之间的对应，根据 PDB 符号文件将可以关联上 DLL 和源代码。假设此时既有 PDB 符号文件，又有源代码，那自然就可以在调试的时候进入源代码进行调试
为了减少误解，必须说明的是，有 PDB 符号文件，可以方便进行代码关联调试。对于 .NET 的应用，没有 PDB 符号文件，依然可以愉快调试，原因是 .NET 的 DLL 里面自带了足量的信息。但是有 PDB 符号文件的话，调试更好评
默认的发布的库，都是不会带上源代码的，此时空有 PDB 符号文件，还不能愉快调试源代码。好在咱可以使用 EmbedAllSources 属性，将源代码嵌入到 PDB 符号文件里面，此时在 VisualStudio 2019 调试，将可以通过 PDB 文件调试进入到对应的源代码
将源代码放入到 PDB 符号文件的方法很简单，只需要在 csproj 项目文件添加如下代码即可
<EmbedAllSources>true</EmbedAllSources>
默认的 NuGet 包是不带 PDB 符号文件的，官方推荐将 PDB 符号文件打到 snupkg 里面再推送。如果期望只作为一个 NuGet 包，可以加上如下代码也将符号文件放入 NuGet 里面。使用下面代码可以将 PDB 符号文件放入 NuGet 包，也将源代码打包压缩嵌入在 PDB 符号文件里面
<PropertyGroup>
<EmbedAllSources>true</EmbedAllSources>
<!-- Include symbol files (*.pdb) in the built .nupkg -->
<AllowedOutputExtensionsInPackageBuildOutputFolder>$(AllowedOutputExtensionsInPackageBuildOutputFolder);.pdb</AllowedOutputExtensionsInPackageBuildOutputFolder>
</PropertyGroup>
更改之后的 csproj 项目文件内容大概如下
<Project Sdk="Microsoft.NET.Sdk.WindowsDesktop">
<PropertyGroup>
<TargetFrameworks>net45;netcoreapp3.1</TargetFrameworks>
<GeneratePackageOnBuild>true</GeneratePackageOnBuild>
<UseWpf>True</UseWpf>
<UseWindowsForms>True</UseWindowsForms>
</PropertyGroup>
<PropertyGroup>
<GenerateDocumentationFile>true</GenerateDocumentationFile>
<EmbedAllSources>true</EmbedAllSources>
<!-- Include symbol files (*.pdb) in the built .nupkg -->
<AllowedOutputExtensionsInPackageBuildOutputFolder>$(AllowedOutputExtensionsInPackageBuildOutputFolder);.pdb</AllowedOutputExtensionsInPackageBuildOutputFolder>
</PropertyGroup>
加上了 EmbedAllSources 就可以看到输出的 PDB 符号文件的体积比之前更大，原因是加上了源代码文件
在有嵌入源代码的符号文件，就可以在调试的时候，自动进入到源代码。但是和有源代码的调试不同的在于，此时的源代码是不支持更改逻辑的。另一个不足在于当前只支持 cs 等代码文件，还不支持 xaml 文件
此功能其实也是 SourceLink 的一个功能，需要 VisualStudio 2019 新版本才能支持。如果自己的代码是开源的，也可以通过 SourceLink 链接到 GitHub 等的方式，这样可以减少 NuGet 包的下载大小。详细请看 dotnet 使用 SourceLink 将 NuGet 链接源代码到 GitHub 等仓库
其实将源代码放入 PDB 文件会比使用 SourceLink 链接到 GitHub 上更好，原因是从 GitHub 上拉代码的速度不如下一个大的 NuGet 文件
更多关于 Roslyn 请看 手把手教你写 Roslyn 修改编译
标签：文件,EmbedAllSources,符号,NuGet,Roslyn,源代码,PDB,调试 来源： https://www.cnblogs.com/lindexi/p/15131071.html
本站声明： 1. iCode9 技术分享网（下文简称本站）提供的所有内容，仅供技术学习、探讨和分享； 2. 关于本站的所有留言、评论、转载及引用，纯属内容发起人的个人观点，与本站观点和立场无关； 3. 关于本站的所有言论和文字，纯属内容发起人的个人观点，与本站观点和立场无关； 4. 本站文章均是网友提供，不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属；如您发现该文章侵犯了您的权益，可联系我们第一时间进行删除； 5. 本站为非盈利性的个人网站，所有内容不会用来进行牟利，也不会利用任何形式的广告来间接获益，纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。