SuperAPI AI 工具集

dotnet-nuget-authoring

通用与其它

查看项目

更新于 10-16 02:33

技能介绍

用途:为 .NET 库作者提供 NuGet 包创作指导,基于 .NET 8.0+ 与随 SDK 附带的 NuGet 客户端,使用 dotnet pack 生成包,无需 .nuspec。

主要能力:

  1. SDK 风格 csproj 包属性与元数据,如 PackageId、Version、Authors、Description、PackageTags、PackageLicenseExpression、PackageReadmeFile、PackageIcon、RepositoryUrl 等;多项目仓库可用 Directory.Build.props 共享元数据。
  2. 源生成器打包:生成器 DLL 放入 analyzers/dotnet/cs/,而非 lib/;设置 IncludeBuildOutput=false、SuppressDependenciesWhenPacking=true,目标框架 netstandard2.0;需要向使用方注入 MSBuild 属性时使用 buildTransitive 的 props/targets。
  3. 多 TFM 包:用 TargetFrameworks 生成单包多程序集,按 TFM 条件引用依赖,配合 #if 条件编译。
  4. 符号包与确定性构建:IncludeSymbols、SymbolPackageFormat=snupkg、Deterministic、ContinuousIntegrationBuild、EmbedUntrackedSources;可用 dotnet nuget push 同时推送 nupkg 与 snupkg。
  5. 包签名:dotnet nuget sign 支持 PFX 证书或证书存储指纹,需时间戳;dotnet nuget verify 验证签名。
  6. 包验证:EnablePackageValidation、PackageValidationBaselineVersion、Microsoft.DotNet.ApiCompat.Task 8.0+ 做 API 兼容性检查,可用 CompatibilitySuppressions.xml 抑制已知破坏性变更。
  7. 版本策略:SemVer 2.0、预发布后缀、NBGV 集成。

使用方式:在 csproj 中配置上述属性后执行 dotnet pack;签名与验证使用 dotnet nuget sign/verify 命令。

限制与范围:不涵盖中央包管理、SourceLink、nuget.config、CI/CD 推送工作流、CLI 工具打包、Roslyn 分析器创作与发布生命周期,这些由其他技能处理。资料未提供具体收费、价格或平台信息。