ThisAssembly.Git 1.5.0

此包生成一个静态的 ThisAssembly.Git 类，其中包含以下 Git 属性的常量，来自当前项目

• 提交
• Sha（提交的前 9 个字符）
• 根（规范化为正斜杠）
• Url（如果 PublishRepositoryUrl=true）
• 分支（从 CI 环境变量中获取）

此包依赖于您项目安装的 Microsoft.SourceLink.* 包引用，具体取决于您的基于 Git 的源代码管理服务器（例如 GitHub、Azure DevOps、BitBucket 等）。

Branch 属性是由当前受支持的 CI 系统提供的环境变量填充的：GitHub Actions、Azure DevOps、AppVeyor、TeamCity、Travis CI、Circle CI、GitLab CI、Buddy 和 Jenkins。

只要 CI 系统提供拉取请求编号，分支名称就是 pr[NUMBER]，例如 pr123。这使得它可以轻松用作 semver 元数据标签。

注意：默认情况下，这些常量的值在“真实”构建过程中填充（也就是说，不是用于填充intellisense的IDE/设计时间构建）。这是为了防止对编辑器性能产生负面影响。然而，这意味着，当在IDE中检查这些属性时，它们似乎总是为空（尽管在运行时从不为空）。如果您想强制在设计时间构建中填充这些值，请将EnableSourceControlManagerQueries属性设置为true。此属性由dotnet/sourcelink定义和文档化。

在MSBuild级别，目标可以依赖于提供的InitializeGitInformation目标，该目标设置了以下命名的等效属性：

• RepositoryCommit
• RepositorySha
• RepositoryRoot
• RepositoryUrl
• RepositoryBranch

这些属性的名字是有意选择的，以便与nuget pack和nugetizer使用的属性匹配，用于填充相关的包元数据。

因此，如果您拥有GitHub仓库，安装这三个包将确保您拥有内置的正确元数据和可能的简单包装体验。

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>netstandard2.0</TargetFramework>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.SourceLink.GitHub" />
    <PackageReference Include="ThisAssembly.Git" />
    <PackageReference Include="NuGetizer" />
  </ItemGroup>
</Project>

将$(ThisAssemblyNamespace) MSBuild属性设置为设置生成的ThisAssembly类的根命名空间。否则，它将在全局命名空间中生成。

赞助商

了解更多关于GitHub Sponsors的信息