feat.新增了插件开发文档

2026-06-23 09:54:25 +08:00 · 2026-04-13 19:54:37 +08:00
parent ce5acf5bd7
commit 1b22e9df4a
23 changed files with 4770 additions and 1 deletions
--- a/develop/06-CI-CD与自动化/03-自动打包与发布.md
+++ b/develop/06-CI-CD与自动化/03-自动打包与发布.md
@@ -0,0 +1,156 @@
+# 03-自动打包与发布
+
+配置 GitHub Actions 自动打包 .laapp 并发布到 GitHub Releases。
+
+---
+
+## 🎯 发布工作流
+
+```yaml
+# .github/workflows/release.yml
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+env:
+  DOTNET_VERSION: '10.0.x'
+
+jobs:
+  build-and-release:
+    runs-on: windows-latest
+    
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: ${{ env.DOTNET_VERSION }}
+      
+      - name: Get Version
+        id: version
+        run: |
+          $version = $env:GITHUB_REF -replace 'refs/tags/v', ''
+          echo "VERSION=$version" >> $env:GITHUB_OUTPUT
+      
+      - name: Restore
+        run: dotnet restore
+      
+      - name: Build
+        run: dotnet build --configuration Release --no-restore
+      
+      - name: Package
+        run: |
+          $version = "${{ steps.version.outputs.VERSION }}"
+          Rename-Item -Path "bin/Release/net10.0/MyPlugin.laapp" -NewName "MyPlugin-$version.laapp"
+      
+      - name: Create Release
+        uses: softprops/action-gh-release@v1
+        with:
+          files: bin/Release/net10.0/*.laapp
+          generate_release_notes: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+
+---
+
+## 📋 发布流程
+
+### 1. 创建标签
+
+```bash
+# 创建版本标签
+git tag -a v1.0.0 -m "Release version 1.0.0"
+
+# 推送标签到 GitHub
+git push origin v1.0.0
+```
+
+### 2. 自动触发
+
+推送标签后，GitHub Actions 会自动：
+1. 检出代码
+2. 构建项目
+3. 打包 .laapp
+4. 创建 Release
+5. 上传产物
+
+### 3. 查看 Release
+
+在 GitHub 仓库页面 → Releases 查看自动创建的发布。
+
+---
+
+## 🔧 高级配置
+
+### 预发布版本
+
+```yaml
+- name: Create Release
+  uses: softprops/action-gh-release@v1
+  with:
+    files: bin/Release/net10.0/*.laapp
+    prerelease: ${{ contains(github.ref, 'beta') || contains(github.ref, 'alpha') }}
+```
+
+### 生成变更日志
+
+```yaml
+- name: Generate Changelog
+  id: changelog
+  uses: mikepenz/release-changelog-builder-action@v4
+  with:
+    configuration: .github/changelog-config.json
+  env:
+    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+- name: Create Release
+  uses: softprops/action-gh-release@v1
+  with:
+    body: ${{ steps.changelog.outputs.changelog }}
+    files: bin/Release/net10.0/*.laapp
+```
+
+---
+
+## 💡 最佳实践
+
+### 版本号管理
+
+```yaml
+- name: Update Version
+  run: |
+    $version = "${{ github.ref_name }}" -replace '^v', ''
+    $json = Get-Content plugin.json | ConvertFrom-Json
+    $json.version = $version
+    $json | ConvertTo-Json | Set-Content plugin.json
+```
+
+### 多文件发布
+
+```yaml
+- name: Create Release
+  uses: softprops/action-gh-release@v1
+  with:
+    files: |
+      bin/Release/net10.0/*.laapp
+      README.md
+      LICENSE
+```
+
+---
+
+## 🎯 下一步
+
+学习多平台构建：
+
+👉 **[04-多平台构建策略](04-多平台构建策略.md)**
+
+---
+
+*最后更新：2026年4月*