Day 5 - 版本与发布

主版本.次版本.修订版本

1.0.0

dotnet run

dotnet build -c Release
dotnet publish -c Release

artifacts/
  ProductManager-1.0.0/
    可执行程序和依赖文件

VERSION.txt
RELEASE_NOTES_1.0.0.md

dotnet publish -c Release -o ./artifacts/ProductManager-1.0.0

<PropertyGroup>
  <OutputType>WinExe</OutputType>
  <TargetFramework>net8.0</TargetFramework>
  <Nullable>enable</Nullable>
  <BuiltInComInteropSupport>true</BuiltInComInteropSupport>
  <ApplicationManifest>app.manifest</ApplicationManifest>
  <AvaloniaUseCompiledBindingsByDefault>true</AvaloniaUseCompiledBindingsByDefault>
  <Version>1.0.0</Version>
  <AssemblyVersion>1.0.0.0</AssemblyVersion>
  <FileVersion>1.0.0.0</FileVersion>
  <InformationalVersion>1.0.0</InformationalVersion>
</PropertyGroup>

<Version>1.0.0</Version>
<AssemblyVersion>1.0.0.0</AssemblyVersion>
<FileVersion>1.0.0.0</FileVersion>
<InformationalVersion>1.0.0</InformationalVersion>

1.0.0

dotnet restore
dotnet build -c Release

dotnet test

dotnet publish -c Release -o ./artifacts/ProductManager-1.0.0

artifacts/ProductManager-1.0.0/

dotnet publish -c Release -r osx-arm64 --self-contained true -o ./artifacts/ProductManager-1.0.0-osx-arm64

dotnet publish -c Release -r win-x64 --self-contained true -o ./artifacts/ProductManager-1.0.0-win-x64

dotnet publish -c Release -r linux-x64 --self-contained true -o ./artifacts/ProductManager-1.0.0-linux-x64

# ProductManager 1.0.0 发布说明
 
发布日期：2026-06-12
 
## 本次发布内容
 
- 新增商品列表。
- 新增商品创建、编辑、删除功能。
- 新增商品搜索和筛选功能。
- 新增本地 JSON 保存。
- 新增 CSV 导入和导出。
- 新增操作日志。
- 新增角色权限判断。
- 新增发布检查清单。
 
## 本次修复
 
- 修复商品名称为空时仍可保存的问题。
- 修复价格小于等于 0 时提示不清楚的问题。
- 修复保存中重复点击导致重复提交的问题。
 
## 运行方式
 
1. 解压发布目录。
2. 打开发布目录。
3. 运行可执行文件。
 
## 已知问题
 
- CSV 导入失败时，当前只显示失败数量，暂时不显示每一行失败原因。
- 数据当前保存在本地文件，多台电脑之间不会自动同步。
- 删除商品后暂时不能一键撤销。
 
## 验证记录
 
- `dotnet restore` 已通过。
- `dotnet build -c Release` 已通过。
- `dotnet publish -c Release` 已通过。
- 新增、编辑、删除、搜索、保存已经手动验证。

<PropertyGroup>
    <Version>1.0.0</Version>
    <AssemblyVersion>1.0.0.0</AssemblyVersion>
    <FileVersion>1.0.0.0</FileVersion>
</PropertyGroup>

string version = typeof(Program).Assembly
    .GetName()
    .Version?
    .ToString() ?? "unknown";
 
Console.WriteLine(version);

dotnet clean
dotnet restore
dotnet build -c Release
dotnet test -c Release
dotnet publish -c Release -o artifacts/1.0.0

1. 理解版本号 `1.0.0` 的含义
2. 区分 `Debug` 和 `Release`
3. 区分框架依赖发布和自包含发布

<PropertyGroup>
  <Version>1.0.0</Version>
  <AssemblyVersion>1.0.0.0</AssemblyVersion>
  <FileVersion>1.0.0.0</FileVersion>
</PropertyGroup>

应用和文件都显示 1.0.0

dotnet test -c Release
dotnet publish src/Hmi.App -c Release -r win-x64 --self-contained true
tar -a -c -f Hmi.App-1.0.0-win-x64.zip -C publish .

测试、发布、打包顺序固定

releases/
  1.0.0/
    Hmi.App-1.0.0-win-x64.zip
    SHA256.txt
    release-notes.md

每个版本有独立完整资料

1.0.1

dotnet restore
dotnet build -c Release
dotnet publish -c Release -o ./artifacts/ProductManager-1.0.1

dotnet publish -c Release -r osx-arm64 --self-contained true -o ./artifacts/ProductManager-1.0.1-osx-arm64

# ProductManager 1.0.1 发布说明
 
发布日期：2026-06-12
 
## 本次发布内容
 
- 这是 `1.0.0` 之后的修复版本。
 
## 本次修复
 
- 修复保存失败时错误提示不够明确的问题。
- 修复空列表时页面没有提示的问题。
- 修复发布说明缺少已知问题的问题。
 
## 运行方式
 
1. 解压发布目录。
2. 打开发布目录。
3. 运行可执行文件。
 
## 已知问题
 
- CSV 导入失败时，暂时只显示失败数量。
- 删除商品后暂时不能一键撤销。
 
## 验证记录
 
- `dotnet restore` 已通过。
- `dotnet build -c Release` 已通过。
- `dotnet publish -c Release` 已通过。
- 已验证新增商品。
- 已验证空名称错误提示。
- 已验证空列表提示。

# ProductManager 1.0.1 发布前检查清单
 
- [ ] 版本号已经改为 `1.0.1`。
- [ ] `VERSION.txt` 已经改为 `1.0.1`。
- [ ] `dotnet restore` 执行成功。
- [ ] `dotnet build -c Release` 执行成功。
- [ ] `dotnet publish -c Release` 执行成功。
- [ ] 发布目录存在。
- [ ] 发布目录里有可执行文件。
- [ ] 新增商品功能已验证。
- [ ] 空名称错误提示已验证。
- [ ] 空列表提示已验证。
- [ ] 发布说明已经更新。