Skip to content

Commit 933dc89

Browse files
committed
ci: add .slnx solution, fix website build, update CI workflow
- Add src/GeneralUpdate-Samples.slnx solution file linking Hub and Server projects - Update .github/workflows/dotnet.yml to build both .NET solution and Docusaurus website - Remove .NET 8 setup (both projects now target net10.0) - Build Hub project (local DLLs are checked into src/Hub/libs/) - Fix broken markdown links in docs/guide/ and i18n/en/guide/ - Remove .md extension from cross-directory links (Docusaurus compat) - Replace deleted GeneralUpdate.ClientCore.md refs with GeneralUpdate.Core - Fix URL-encoded filename links (Quik%20start -> Quik start, File%20occupancy -> File occupancy) - Remove broken imgs/architecture.png reference
1 parent 9121857 commit 933dc89

12 files changed

Lines changed: 53 additions & 33 deletions

File tree

.github/workflows/dotnet.yml

Lines changed: 36 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
name: .NET
1+
name: Build & Verify
22

33
on:
44
push:
@@ -7,27 +7,49 @@ on:
77
branches: [ "main" ]
88

99
jobs:
10-
build:
11-
10+
# ═══════════════════════════════════════════════════════════════
11+
# .NET Solution Build
12+
# ═══════════════════════════════════════════════════════════════
13+
dotnet:
14+
name: .NET Build
1215
runs-on: ubuntu-latest
1316

1417
steps:
1518
- uses: actions/checkout@v4
1619

17-
- name: Setup .NET 8
18-
uses: actions/setup-dotnet@v4
19-
with:
20-
dotnet-version: 8.0.x
21-
2220
- name: Setup .NET 10
2321
uses: actions/setup-dotnet@v4
2422
with:
2523
dotnet-version: 10.0.x
2624

27-
- name: Build ServerSample
28-
run: dotnet build ./src/Server/ServerSample.sln
25+
- name: Restore dependencies
26+
run: dotnet restore ./src/GeneralUpdate-Samples.slnx
27+
28+
- name: Build solution
29+
run: dotnet build ./src/GeneralUpdate-Samples.slnx --no-restore -c Release
30+
31+
# ═══════════════════════════════════════════════════════════════
32+
# Docusaurus Website Build
33+
# ═══════════════════════════════════════════════════════════════
34+
website:
35+
name: Website Build
36+
runs-on: ubuntu-latest
37+
defaults:
38+
run:
39+
working-directory: ./website
40+
41+
steps:
42+
- uses: actions/checkout@v4
43+
44+
- name: Setup Node.js
45+
uses: actions/setup-node@v4
46+
with:
47+
node-version: '20'
48+
cache: 'npm'
49+
cache-dependency-path: website/package-lock.json
50+
51+
- name: Install dependencies
52+
run: npm ci
2953

30-
# Hub build requires local DLLs (libs/) or matching NuGet packages.
31-
# Enable when NuGet packages are published from latest GeneralUpdate source.
32-
# - name: Build Hub (NuGet mode)
33-
# run: dotnet build ./src/Hub/Hub.csproj -p:UseNuGet=true
54+
- name: Build website
55+
run: npm run build

website/docs/guide/Architecture.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,6 @@ sidebar_position: 1
88

99
GeneralUpdate 是一个跨平台 .NET 自动更新框架,采用**客户端-升级助手-服务端**三层架构。整个更新流程涉及多个独立进程和组件的协同工作。
1010

11-
![架构图](imgs/architecture.png)
12-
1311
---
1412

1513
## 整体架构
@@ -352,4 +350,4 @@ await new GeneralClientBootstrap()
352350
- **[Pipeline 详解](./Pipeline.md)** — 中间件管道工作原理
353351
- **[配置参考](./Configuration.md)** — 完整配置选项
354352
- **[安全指南](./Security.md)** — 安全架构详解
355-
- **[快速入门](../quickstart/Quik%20start.md)** — 5 分钟快速上手
353+
- **[快速入门](../quickstart/Quik start)** — 5 分钟快速上手

website/docs/guide/Configuration.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -527,4 +527,4 @@ public record BlackPolicy
527527
- **[系统架构](./Architecture.md)** — 了解整体架构
528528
- **[Pipeline 详解](./Pipeline.md)** — 中间件管道工作原理
529529
- **[安全指南](./Security.md)** — 安全配置
530-
- **[GeneralUpdate.Tools](../doc/GeneralUpdate.PacketTool.md)** — 配置生成工具
530+
- **[GeneralUpdate.Tools](../doc/GeneralUpdate.PacketTool)** — 配置生成工具

website/docs/guide/FAQ.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -221,7 +221,7 @@ await new GeneralClientBootstrap()
221221

222222
如果仍有占用:
223223
1. 检查是否有后台服务未关闭
224-
2. 使用 [文件占用指南](./File%20occupancy.md) 中的 `handle.exe` 排查
224+
2. 使用 [文件占用指南](./File occupancy) 中的 `handle.exe` 排查
225225
3. 考虑使用强制重启后更新策略
226226

227227
### Q17: Linux/macOS 上文件权限怎么处理?

website/docs/guide/Packaging.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ sidebar_position: 6
2424
6. 填写包名和版本号
2525
7. 点击「构建」
2626

27-
详细说明请参考 [GeneralUpdate.Tools 文档](../doc/GeneralUpdate.PacketTool.md)
27+
详细说明请参考 [GeneralUpdate.Tools 文档](../doc/GeneralUpdate.PacketTool)
2828

2929
### 使用 Differential API 编程生成
3030

@@ -279,7 +279,7 @@ jobs:
279279

280280
## 相关资源
281281

282-
- **[GeneralUpdate.Tools](../doc/GeneralUpdate.PacketTool.md)** — 补丁包和配置生成工具
282+
- **[GeneralUpdate.Tools](../doc/GeneralUpdate.PacketTool)** — 补丁包和配置生成工具
283283
- **[权限指南](./Permission.md)** — Windows UAC 权限处理
284-
- **[快速入门](../quickstart/Quik%20start.md)** — 5 分钟快速上手
284+
- **[快速入门](../quickstart/Quik start)** — 5 分钟快速上手
285285
- **[系统架构](./Architecture.md)** — 了解整体打包部署架构

website/docs/guide/Pipeline.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -419,5 +419,5 @@ public class PrePostHookMiddleware : IMiddleware
419419
## 相关资源
420420

421421
- **[系统架构](./Architecture.md)** — 了解整体架构与管道在其中的位置
422-
- **[GeneralUpdate.Differential](../doc/GeneralUpdate.Differential.md)** — BSDiff 差分算法详解
422+
- **[GeneralUpdate.Differential](../doc/GeneralUpdate.Differential)** — BSDiff 差分算法详解
423423
- **[配置参考](./Configuration.md)** — 管道相关配置选项

website/docs/guide/Security.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -423,5 +423,5 @@ Bowl 在更新完成后监控新进程的运行状态:
423423

424424
- **[系统架构](./Architecture.md)** — 了解安全机制在整体架构中的位置
425425
- **[配置参考](./Configuration.md)** — 安全相关配置项
426-
- **[GeneralUpdate.Bowl](../doc/GeneralUpdate.Bowl.md)** — Bowl 崩溃监控
427-
- **[GeneralUpdate.ClientCore](../doc/GeneralUpdate.ClientCore.md)** — 客户端配置与安全选项
426+
- **[GeneralUpdate.Bowl](../doc/GeneralUpdate.Bowl)** — Bowl 崩溃监控
427+
- **[GeneralUpdate.Core](../doc/GeneralUpdate.Core)** — 客户端配置与安全选项

website/i18n/en/docusaurus-plugin-content-docs/current/guide/Architecture.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -225,4 +225,4 @@ await new GeneralClientBootstrap()
225225
- **[Pipeline Guide](./Pipeline.md)** — Middleware pipeline internals
226226
- **[Configuration Reference](./Configuration.md)** — All configuration options
227227
- **[Security Guide](./Security.md)** — Security architecture
228-
- **[Quick Start](../quickstart/Quik%20start.md)** — 5-minute quickstart
228+
- **[Quick Start](../quickstart/Quik start)** — 5-minute quickstart

website/i18n/en/docusaurus-plugin-content-docs/current/guide/Configuration.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -315,4 +315,4 @@ Auto-generated configuration file `generalupdate.manifest.json`:
315315
- **[Architecture](./Architecture.md)** — Overall system architecture
316316
- **[Pipeline Guide](./Pipeline.md)** — Middleware pipeline internals
317317
- **[Security Guide](./Security.md)** — Security configuration
318-
- **[GeneralUpdate.Tools](../doc/GeneralUpdate.PacketTool.md)** — Config generation tool
318+
- **[GeneralUpdate.Tools](../doc/GeneralUpdate.PacketTool)** — Config generation tool

website/i18n/en/docusaurus-plugin-content-docs/current/guide/Packaging.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ This guide covers how to package your application with its update system for dis
2323
6. Enter package name and version
2424
7. Click "Build"
2525

26-
See the [GeneralUpdate.Tools documentation](../doc/GeneralUpdate.PacketTool.md) for details.
26+
See the [GeneralUpdate.Tools documentation](../doc/GeneralUpdate.PacketTool) for details.
2727

2828
### Using the Differential API Programmatically
2929

@@ -215,7 +215,7 @@ Before deploying, verify:
215215

216216
## Related Resources
217217

218-
- **[GeneralUpdate.Tools](../doc/GeneralUpdate.PacketTool.md)** — Patch and config generation tool
218+
- **[GeneralUpdate.Tools](../doc/GeneralUpdate.PacketTool)** — Patch and config generation tool
219219
- **[Permission Guide](./Permission.md)** — Windows UAC permission handling
220-
- **[Quick Start](../quickstart/Quik%20start.md)** — 5-minute quickstart
220+
- **[Quick Start](../quickstart/Quik start)** — 5-minute quickstart
221221
- **[Architecture](./Architecture.md)** — Overall deployment architecture

0 commit comments

Comments
 (0)