释放
- 作者仓库星标 2,459
- 作者仓库 vorta
- 领域
- 工程开发
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @borgbase · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- macOS
- 运行环境要求
- Python
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 命令执行
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
第一阶段:预检查
在开始之前,验证存储库是否已准备好:如果有未提交的更改,请停止并要求用户先解决它们。
第四阶段:等待 CI
监控测试工作流程:等待测试通过后再继续。如果测试失败,请停止并通知用户。
第 6 阶段:PyPi 发布
注意:使用 `command op` 绕过 1Password CLI 的 shell 功能问题。这会构建 sdist 并通过 twine 上传到 PyPi。如果`op`失败,请提供手动说明:
第 8 阶段:发布发布
验证发布看起来正确后: 向用户提供发布 URL。
第 9 阶段:更新 GitHub 页面 (Appcast)
更新 Sparkle appcast 以实现 macOS 自动更新。注意: gh-pages 分支没有预提交配置,因此提交可能会失败。处理这个:如果由于预提交而提交失败,请手动完成:
# Vorta Release Workflow
Guide the user through all release steps interactively. Confirm before each destructive operation.
## Phase 1: Pre-checks
Before starting, verify the repository is ready:
```bash
git status # Must be clean, on master branch
```
If there are uncommitted changes, stop and ask the user to resolve them first.
## Phase 2: Version Bump
### 2.1 Get the new version number
Ask the user for the new version number (e.g., `0.12.0`). Verify it follows semver format.
### 2.2 Update version file
Edit `src/vorta/_version.py`:
```python
__version__ = "X.Y.Z" # New version
```
### 2.3 Update translations (optional)
Note: Use `command op` to bypass shell function issues with 1Password CLI.
```bash
command op run -- make translations-update
```
If this fails (e.g., 1Password not configured), ask user if they want to skip or fix it.
### 2.4 Update metadata and create commit + tag
Note: `make bump-version` has a preflight check that requires a clean tree, but we've already edited `_version.py`. Perform the steps manually instead:
1. Update appdata.xml with new version and today's date:
```bash
# Edit src/vorta/assets/metadata/com.borgbase.Vorta.appdata.xml
# Change: <release version="vX.Y.Z" date="YYYY-MM-DD" ...>
```
2. Create commit and tag:
```bash
git add src/vorta/_version.py src/vorta/assets/metadata/com.borgbase.Vorta.appdata.xml
git commit -m "Bump version to vX.Y.Z"
git tag -a vX.Y.Z -m "TAG_MESSAGE_HERE"
```
Prompt the user for the tag message (brief summary of changes).
## Phase 3: Push to Upstream
```bash
git push upstream master
git push upstream vX.Y.Z
```
## Phase 4: Wait for CI
Monitor the test workflow:
```bash
gh run list --workflow=test.yml --limit=1
gh run watch <run-id> --exit-status
```
Wait for tests to pass before proceeding. If tests fail, stop and notify the user.
## Phase 5: Create GitHub Release
### 5.1 Generate changelog
```bash
make changelog
```
Format the output as a bullet list for release notes, excluding:
- Version bump commits
- CI-only changes
- Minor dev tooling updates
### 5.2 Create draft release
```bash
gh release create vX.Y.Z --draft --title "vX.Y.Z" --notes "CHANGELOG_HERE"
```
Show the user the draft URL for review.
## Phase 6: PyPi Release
Note: Use `command op` to bypass shell function issues with 1Password CLI.
```bash
command op run -- make pypi-release
```
This builds the sdist and uploads to PyPi via twine.
If `op` fails, provide manual instructions:
```bash
uv run python -m build --sdist
uv run twine upload dist/vorta-X.Y.Z.tar.gz
```
## Phase 7: macOS Builds
### 7.1 Trigger both architecture builds
Default Borg version: 1.4.3 (ask user if they want different)
```bash
# ARM build (Apple Silicon) - uses macos-14
gh workflow run build-macos.yml -f branch=master -f macos_version=macos-14 -f borg_version=1.4.3
# Intel build - uses macos-15-intel (x86_64 runner)
gh workflow run build-macos.yml -f branch=master -f macos_version=macos-15-intel -f borg_version=1.4.3
```
### 7.2 Wait for builds to complete
```bash
# List recent workflow runs to get run IDs
gh run list --workflow=build-macos.yml --limit=2
# Watch both runs
gh run watch <arm-run-id> --exit-status
gh run watch <intel-run-id> --exit-status
```
### 7.3 Download artifacts
```bash
rm -rf ./release-artifacts && mkdir -p ./release-artifacts
gh run download <arm-run-id> -D ./release-artifacts
gh run download <intel-run-id> -D ./release-artifacts
```
### 7.4 Upload to GitHub release
Note: Artifacts are in nested directories (e.g., `./release-artifacts/Vorta-vX.Y.Z-arm.dmg/Vorta-vX.Y.Z-arm.dmg`)
```bash
gh release upload vX.Y.Z \
"./release-artifacts/Vorta-vX.Y.Z-arm.dmg/Vorta-vX.Y.Z-arm.dmg" \
"./release-artifacts/Vorta-vX.Y.Z-intel.dmg/Vorta-vX.Y.Z-intel.dmg"
```
### 7.5 Cleanup
```bash
rm -rf ./release-artifacts
```
## Phase 8: Publish Release
After verifying the release looks correct:
```bash
gh release edit vX.Y.Z --draft=false
```
Provide the release URL to the user.
## Phase 9: Update GitHub Pages (Appcast)
Update the Sparkle appcast for macOS auto-updates.
Note: The gh-pages branch doesn't have pre-commit config, so commits may fail. Handle this:
```bash
make update-appcast
```
If the commit fails due to pre-commit, complete manually:
```bash
# If already on gh-pages from failed make target:
PRE_COMMIT_ALLOW_NO_CONFIG=1 git commit -m "Update appcast for vX.Y.Z"
git push upstream gh-pages
git checkout master
```
## Completion
Summarize what was done:
- Version bumped to vX.Y.Z
- Tag pushed to upstream
- GitHub release published: [link]
- PyPi package uploaded
- macOS DMGs (ARM + Intel) attached to release
- Appcast updated for auto-updates
章节与文件索引
按说明文件中的顺序排列。
第一阶段:预检查
2.1 获取新版本号
2.2 更新版本文件
2.3 更新翻译(可选)
2.4 更新元数据并创建commit+tag
文件/命令 -> 0.12.0 · src/vorta/_version.py · command op · make bump-version · _version.py · ./release-artifacts/Vorta-vX.Y.Z-arm.dmg/Vorta-vX.Y.Z-arm.dmg
内容校验值 -> 2e98324323e8
当前原文的自动摘译,尚未人工审校。
2.1 获取新版本号
询问用户新版本号(例如,
0.12.0)。验证它遵循 semver 格式。2.2 更新版本文件
编辑
src/vorta/_version.py:2.3 更新翻译(可选)
注意:使用
command op绕过 1Password CLI 的 shell 功能问题。如果失败(例如,未配置 1Password),请询问用户是否要跳过或修复它。2.4 更新元数据并创建commit+tag
注意:
make bump-version有一个需要干净树的预检检查,但我们已经编辑了_version.py。请手动执行以下步骤: 使用新版本和今天的日期更新 appdata.xml: 创建提交和标签: 提示用户输入标签消息(更改的简要摘要)。