Tauri 桌面应用开发与发布完整流程

      # 使用官方脚手架
npm create tauri-app@latest

# 选择配置
✔ Project name · my-app
✔ Choose which language to use for your frontend · TypeScript / JavaScript
✔ Choose your package manager · npm
✔ Choose your UI template · React
✔ Choose your UI flavor · TypeScript
    

      cd my-app
git init
git add .
git commit -m "Initial commit: Create Tauri project with React + TypeScript"
    

      # 在 GitHub 创建仓库后
git remote add origin https://github.com/username/repo-name.git
git branch -M main
git push -u origin main
    

      # 安装依赖（首次或依赖变更时）
npm install

# 启动开发服务器
npm run tauri:dev
    

      1. 编写代码
   ↓
2. 本地测试（npm run tauri:dev）
   ↓
3. 修复 Bug / 调整功能
   ↓
4. 重复 1-3 直到功能完成
   ↓
5. 提交代码（见下一节）
    

      # 构建生产版本
npm run tauri:build

# 构建产物位置
# macOS: src-tauri/target/release/bundle/dmg/
# Windows: src-tauri/target/release/bundle/msi/
    

      # 查看修改内容
git status
git diff

# 确保没有遗漏重要文件
# 确保没有提交敏感信息（密钥、配置等）
    

      # 暂存所有修改
git add .

# 或选择性暂存
git add src/components/Feature.tsx
git add src-tauri/src/commands/api.rs
    

      # 格式：<type>: <subject>
#
# type 类型：
# - feat: 新功能
# - fix: Bug 修复
# - docs: 文档更新
# - style: 代码格式调整（不影响功能）
# - refactor: 重构（不新增功能也不修复 Bug）
# - perf: 性能优化
# - test: 测试相关
# - chore: 构建/工具配置

# 示例：
git commit -m "feat: Add dark mode toggle to settings"
git commit -m "fix: Resolve image upload timeout issue"
git commit -m "docs: Update README with installation instructions"
    

      git commit -m "$(cat <<'EOF'
feat: Add batch image processing with progress tracking

- Implement concurrent upload with configurable limit (max 5)
- Add real-time progress bar for each image
- Handle upload failures with retry mechanism
- Update UI to show processing status

Closes #42
EOF
)"
    

      # 推送到主分支
git push

# 首次推送新分支
git push -u origin feature-branch-name
    

      # 1. package.json
{
  "version": "0.3.0"  # 修改这里
}

# 2. src-tauri/Cargo.toml
[package]
version = "0.3.0"  # 修改这里

# 3. src-tauri/tauri.conf.json
{
  "version": "0.3.0"  # 修改这里
}
    

      主版本号.次版本号.修订号  (MAJOR.MINOR.PATCH)

- MAJOR: 不兼容的 API 变更（如 1.0.0 → 2.0.0）
- MINOR: 向下兼容的功能新增（如 1.2.0 → 1.3.0）
- PATCH: 向下兼容的 Bug 修复（如 1.2.3 → 1.2.4）

示例：
0.1.0 → 0.1.1  (Bug 修复)
0.1.1 → 0.2.0  (新功能)
0.9.0 → 1.0.0  (正式版本)
    

      # 暂存版本文件
git add package.json src-tauri/Cargo.toml src-tauri/tauri.conf.json

# 提交（使用统一格式）
git commit -m "chore: Bump version to 0.3.0"

# 推送到远程
git push
    

      # 创建带版本号的 tag
git tag v0.3.0

# 推送 tag 到远程
git push origin v0.3.0

# 验证 tag 已创建
git tag -l
    

      gh release create v0.3.0 \
  --title "v0.3.0 - Feature Name" \
  --notes "$(cat <<'EOF'
## ✨ New Features
- Add support for batch image processing
- Implement progress tracking for uploads

## 🐛 Bug Fixes
- Fix timeout issue on slow networks
- Resolve metadata encoding errors

## 📝 Documentation
- Update README with new configuration options

---
**Full Changelog**: https://github.com/username/repo/compare/v0.2.0...v0.3.0
EOF
)"
    

      # 查看远程 releases
gh release list

# 查看特定 release 详情
gh release view v0.3.0
    

      # 1. 切换到 main 分支
git checkout main
git pull

# 2. 修复 Bug
# ... 编辑代码 ...

# 3. 提交修复
git add .
git commit -m "fix: Resolve critical crash on startup"
git push

# 4. 发布补丁版本
# 更新版本号（如 0.3.0 → 0.3.1）
# 编辑 package.json, Cargo.toml, tauri.conf.json

git add package.json src-tauri/Cargo.toml src-tauri/tauri.conf.json
git commit -m "chore: Bump version to 0.3.1"
git push

# 5. 创建 tag 和 release
git tag v0.3.1
git push origin v0.3.1
gh release create v0.3.1 --title "v0.3.1 - Hotfix" --notes "Fix critical startup crash"
    

      # 1. 找到要回滚的版本
git log --oneline

# 2. 创建回滚分支
git checkout -b revert-to-v0.2.0 v0.2.0

# 3. 更新版本号（如 0.3.0 → 0.2.1）
# 编辑 3 个版本文件

# 4. 提交并发布
git add .
git commit -m "chore: Revert to v0.2.0 due to critical issue"
git push -u origin revert-to-v0.2.0

# 5. 创建 PR 合并回 main
gh pr create --title "Revert to v0.2.0" --body "Emergency rollback"
    

      main (生产分支)
├── develop (开发分支)
│   ├── feature/dark-mode
│   ├── feature/export-data
│   └── fix/upload-timeout
└── hotfix/critical-bug
    

      # 1. 创建功能分支
git checkout -b feature/dark-mode

# 2. 开发功能
# ... 编写代码 ...

# 3. 提交到功能分支
git add .
git commit -m "feat: Add dark mode toggle"
git push -u origin feature/dark-mode

# 4. 创建 Pull Request
gh pr create \
  --title "Add dark mode support" \
  --body "Implements dark mode with user preference persistence"

# 5. Code Review 后合并到 main
gh pr merge --squash
    

      # 拉取最新代码
git pull

# 如果有冲突，解决后
git add .
git commit -m "Merge remote changes"
git push
    

      name: Release Build

on:
  push:
    tags:
      - 'v*'

jobs:
  build:
    strategy:
      matrix:
        platform: [macos-latest, windows-latest]

    runs-on: ${{ matrix.platform }}

    steps:
      - uses: actions/checkout@v4

      - name: Setup Node
        uses: actions/setup-node@v4
        with:
          node-version: 20

      - name: Setup Rust
        uses: dtolnay/rust-toolchain@stable

      - name: Install dependencies
        run: npm install

      - name: Build Tauri app
        run: npm run tauri:build

      - name: Upload artifacts
        uses: actions/upload-artifact@v4
        with:
          name: app-${{ matrix.platform }}
          path: src-tauri/target/release/bundle/
    

      # 修改遗漏的文件
# 然后修正最后一次提交
git add src-tauri/Cargo.toml
git commit --amend --no-edit
git push --force
    

      # 删除本地 tag
git tag -d v0.3.0

# 删除远程 tag
git push origin --delete v0.3.0

# 重新创建
git tag v0.3.0
git push origin v0.3.0
    

      # 查看 commit 差异
git log v0.2.0..v0.3.0 --oneline

# 查看代码差异
git diff v0.2.0..v0.3.0

# 查看特定文件的差异
git diff v0.2.0..v0.3.0 -- src/App.tsx