使用 .NET Core 时是否需要 AssemblyInfo?
Do I need AssemblyInfo while working with .NET Core?
以前,AssemblyInfo.cs
文件由 Visual Studio 自动创建以包含程序集范围的属性,如 AssemblyVersion、AssemblyName 等。
在 .NET Core 和 ASP.NET Core 中,project.json
负责保存大部分信息。
所以问题是:我是否需要再用该属性标记我的程序集?
如果我不使用该属性标记程序集,我会陷入什么陷阱?
project.json 已替换 AssemblyInfo
.
AssemblyVersionAttribute
替换为 version
属性
version
Type: String
The Semver version of the project, also used for the NuGet package.
AssemblyNameAttribute
现在是 name
属性
name
Type: String
The name of the project, used for the assembly name as well as the name of the package. The top level folder name is used if this property is not specified.
等等
更新:随着 .NET Core Tools MSBuild 的发布,.csproj
已取代 project.json
。 AssemblyInfo.cs
文件回来了,但大部分设置已直接移至 .csproj
。有关详细信息,请参阅相关的 SO 问题: :
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net461</TargetFramework>
<Version>1.2.3.4</Version>
<Authors>Author 1</Authors>
<Company>Company XYZ</Company>
<Product>Product 2</Product>
<PackageId>MyApp</PackageId>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<FileVersion>3.0.0.0</FileVersion>
<NeutralLanguage>en</NeutralLanguage>
<Description>Description here</Description>
<Copyright>Copyright</Copyright>
<PackageLicenseUrl>License URL</PackageLicenseUrl>
<PackageProjectUrl>Project URL</PackageProjectUrl>
<PackageIconUrl>Icon URL</PackageIconUrl>
<RepositoryUrl>Repo URL</RepositoryUrl>
<RepositoryType>Repo type</RepositoryType>
<PackageTags>Tags</PackageTags>
<PackageReleaseNotes>Release</PackageReleaseNotes>
</PropertyGroup>
project.json
不是AssemblyInfo.cs
的直接替代品,所以如果你想定义一些你不能在project.json
中提供的值,仍然有必要。
从Issue https://github.com/aspnet/dnx/issues/2715中可以看出,开始时一些参数,如title
、description
、copyright
等被用来填充生成的 nuget 包的字段。随着问题 2715 的诞生,这些值可以 "flow into the Assembly"。这样您就不必在两个不同的地方配置这些字段。因此,如果您不想配置超过这些参数,则不需要 AssemblyInfo.cs
。
[InternalsVisibleTo]
等其他字段无法在 project.json
中配置。所以有些情况还是需要定义一个的
以前,AssemblyInfo.cs
文件由 Visual Studio 自动创建以包含程序集范围的属性,如 AssemblyVersion、AssemblyName 等。
在 .NET Core 和 ASP.NET Core 中,project.json
负责保存大部分信息。
所以问题是:我是否需要再用该属性标记我的程序集? 如果我不使用该属性标记程序集,我会陷入什么陷阱?
project.json 已替换 AssemblyInfo
.
AssemblyVersionAttribute
替换为 version
属性
version
Type: String
The Semver version of the project, also used for the NuGet package.
AssemblyNameAttribute
现在是 name
属性
name
Type: String
The name of the project, used for the assembly name as well as the name of the package. The top level folder name is used if this property is not specified.
等等
更新:随着 .NET Core Tools MSBuild 的发布,.csproj
已取代 project.json
。 AssemblyInfo.cs
文件回来了,但大部分设置已直接移至 .csproj
。有关详细信息,请参阅相关的 SO 问题:
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net461</TargetFramework>
<Version>1.2.3.4</Version>
<Authors>Author 1</Authors>
<Company>Company XYZ</Company>
<Product>Product 2</Product>
<PackageId>MyApp</PackageId>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<FileVersion>3.0.0.0</FileVersion>
<NeutralLanguage>en</NeutralLanguage>
<Description>Description here</Description>
<Copyright>Copyright</Copyright>
<PackageLicenseUrl>License URL</PackageLicenseUrl>
<PackageProjectUrl>Project URL</PackageProjectUrl>
<PackageIconUrl>Icon URL</PackageIconUrl>
<RepositoryUrl>Repo URL</RepositoryUrl>
<RepositoryType>Repo type</RepositoryType>
<PackageTags>Tags</PackageTags>
<PackageReleaseNotes>Release</PackageReleaseNotes>
</PropertyGroup>
project.json
不是AssemblyInfo.cs
的直接替代品,所以如果你想定义一些你不能在project.json
中提供的值,仍然有必要。
从Issue https://github.com/aspnet/dnx/issues/2715中可以看出,开始时一些参数,如title
、description
、copyright
等被用来填充生成的 nuget 包的字段。随着问题 2715 的诞生,这些值可以 "flow into the Assembly"。这样您就不必在两个不同的地方配置这些字段。因此,如果您不想配置超过这些参数,则不需要 AssemblyInfo.cs
。
[InternalsVisibleTo]
等其他字段无法在 project.json
中配置。所以有些情况还是需要定义一个的