312 lines
8.2 KiB
Bash
312 lines
8.2 KiB
Bash
|
#!/bin/bash
|
|||
|
|
|
|||
|
|
# PolyHermes Release 创建脚本
|
|||
|
|
# 功能：创建 tag、推送 tag、创建 GitHub Release（支持 pre-release）
|
|||
|
|
|
|||
|
|
set -e
|
|||
|
|
|
|||
|
|
# 颜色输出
|
|||
|
|
RED='\033[0;31m'
|
|||
|
|
GREEN='\033[0;32m'
|
|||
|
|
YELLOW='\033[1;33m'
|
|||
|
|
BLUE='\033[0;34m'
|
|||
|
|
NC='\033[0m' # No Color
|
|||
|
|
|
|||
|
|
# 打印信息
|
|||
|
|
info() {
|
|||
|
|
echo -e "${BLUE}[INFO]${NC} $1"
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
success() {
|
|||
|
|
echo -e "${GREEN}[SUCCESS]${NC} $1"
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
warn() {
|
|||
|
|
echo -e "${YELLOW}[WARN]${NC} $1"
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
error() {
|
|||
|
|
echo -e "${RED}[ERROR]${NC} $1"
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
# 显示使用说明
|
|||
|
|
usage() {
|
|||
|
|
cat << EOF
|
|||
|
|
用法: $0 [选项]
|
|||
|
|
|
|||
|
|
选项:
|
|||
|
|
-t, --tag TAG 版本号 tag（必需，格式：v1.0.0）
|
|||
|
|
-T, --title TITLE Release 标题（可选，默认使用 tag）
|
|||
|
|
-d, --description DESC Release 描述内容（可选）
|
|||
|
|
-f, --description-file FILE 从文件读取 Release 描述（可选）
|
|||
|
|
-p, --prerelease 标记为 Pre-release（会自动拼接 -beta 后缀，默认：false）
|
|||
|
|
-h, --help 显示此帮助信息
|
|||
|
|
|
|||
|
|
示例:
|
|||
|
|
# 创建正式版本
|
|||
|
|
$0 -t v1.0.1 -T "Release v1.0.1" -d "## 新功能\n- 功能1\n- 功能2"
|
|||
|
|
|
|||
|
|
# 创建 Pre-release（自动拼接 -beta）
|
|||
|
|
$0 -t v1.0.1 -T "Release v1.0.1-beta" -d "测试版本" --prerelease
|
|||
|
|
# 实际创建的 tag: v1.0.1-beta
|
|||
|
|
|
|||
|
|
# 从文件读取描述
|
|||
|
|
$0 -t v1.0.1 -f CHANGELOG.md --prerelease
|
|||
|
|
# 实际创建的 tag: v1.0.1-beta
|
|||
|
|
|
|||
|
|
版本号格式:
|
|||
|
|
- 必须格式: v数字.数字.数字 (例如: v1.0.0, v1.10.2, v1.1.12)
|
|||
|
|
- 如果指定 --prerelease，会自动拼接 -beta 后缀 (例如: v1.0.1 -> v1.0.1-beta)
|
|||
|
|
|
|||
|
|
EOF
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
# 验证版本号格式（只允许 v数字.数字.数字，不允许后缀）
|
|||
|
|
validate_tag() {
|
|||
|
|
local tag=$1
|
|||
|
|
# 匹配格式：v数字.数字.数字（不允许后缀）
|
|||
|
|
if [[ ! "$tag" =~ ^v[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
|
|||
|
|
error "版本号格式不正确：$tag"
|
|||
|
|
error "应为 v数字.数字.数字 (例如: v1.0.0, v1.10.2, v1.1.12)"
|
|||
|
|
error "如果创建 Pre-release，请使用 --prerelease 参数，脚本会自动拼接 -beta 后缀"
|
|||
|
|
exit 1
|
|||
|
|
fi
|
|||
|
|
return 0
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
# 检查必要的工具
|
|||
|
|
check_requirements() {
|
|||
|
|
# 检查 git
|
|||
|
|
if ! command -v git &> /dev/null; then
|
|||
|
|
error "未找到 git 命令，请先安装 git"
|
|||
|
|
exit 1
|
|||
|
|
fi
|
|||
|
|
|
|||
|
|
# 检查 GitHub CLI
|
|||
|
|
if ! command -v gh &> /dev/null; then
|
|||
|
|
error "未找到 GitHub CLI (gh) 命令"
|
|||
|
|
error "请先安装 GitHub CLI: https://cli.github.com/"
|
|||
|
|
exit 1
|
|||
|
|
fi
|
|||
|
|
|
|||
|
|
# 检查是否已登录 GitHub
|
|||
|
|
if ! gh auth status &> /dev/null; then
|
|||
|
|
error "未登录 GitHub，请先运行: gh auth login"
|
|||
|
|
exit 1
|
|||
|
|
fi
|
|||
|
|
|
|||
|
|
# 检查是否有未提交的更改
|
|||
|
|
if [[ -n $(git status --porcelain) ]]; then
|
|||
|
|
warn "检测到未提交的更改，建议先提交或暂存"
|
|||
|
|
read -p "是否继续？(y/N): " -n 1 -r
|
|||
|
|
echo
|
|||
|
|
if [[ ! $REPLY =~ ^[Yy]$ ]]; then
|
|||
|
|
info "已取消"
|
|||
|
|
exit 0
|
|||
|
|
fi
|
|||
|
|
fi
|
|||
|
|
|
|||
|
|
# 检查是否在正确的分支
|
|||
|
|
local current_branch=$(git branch --show-current)
|
|||
|
|
info "当前分支: $current_branch"
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
# 检查 tag 是否已存在
|
|||
|
|
check_tag_exists() {
|
|||
|
|
local tag=$1
|
|||
|
|
if git rev-parse "$tag" >/dev/null 2>&1; then
|
|||
|
|
error "Tag $tag 已存在（本地）"
|
|||
|
|
read -p "是否删除并重新创建？(y/N): " -n 1 -r
|
|||
|
|
echo
|
|||
|
|
if [[ $REPLY =~ ^[Yy]$ ]]; then
|
|||
|
|
git tag -d "$tag" || true
|
|||
|
|
git push origin ":refs/tags/$tag" || true
|
|||
|
|
info "已删除旧 tag: $tag"
|
|||
|
|
else
|
|||
|
|
error "已取消"
|
|||
|
|
exit 1
|
|||
|
|
fi
|
|||
|
|
fi
|
|||
|
|
|
|||
|
|
# 检查远程是否存在
|
|||
|
|
if git ls-remote --tags origin "$tag" | grep -q "$tag"; then
|
|||
|
|
error "Tag $tag 已存在于远程仓库"
|
|||
|
|
read -p "是否删除并重新创建？(y/N): " -n 1 -r
|
|||
|
|
echo
|
|||
|
|
if [[ $REPLY =~ ^[Yy]$ ]]; then
|
|||
|
|
git tag -d "$tag" || true
|
|||
|
|
git push origin ":refs/tags/$tag" || true
|
|||
|
|
info "已删除远程 tag: $tag"
|
|||
|
|
else
|
|||
|
|
error "已取消"
|
|||
|
|
exit 1
|
|||
|
|
fi
|
|||
|
|
fi
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
# 主函数
|
|||
|
|
main() {
|
|||
|
|
local TAG=""
|
|||
|
|
local TITLE=""
|
|||
|
|
local DESCRIPTION=""
|
|||
|
|
local DESCRIPTION_FILE=""
|
|||
|
|
local PRERELEASE=false
|
|||
|
|
|
|||
|
|
# 解析参数
|
|||
|
|
while [[ $# -gt 0 ]]; do
|
|||
|
|
case $1 in
|
|||
|
|
-t|--tag)
|
|||
|
|
TAG="$2"
|
|||
|
|
shift 2
|
|||
|
|
;;
|
|||
|
|
-T|--title)
|
|||
|
|
TITLE="$2"
|
|||
|
|
shift 2
|
|||
|
|
;;
|
|||
|
|
-d|--description)
|
|||
|
|
DESCRIPTION="$2"
|
|||
|
|
shift 2
|
|||
|
|
;;
|
|||
|
|
-f|--description-file)
|
|||
|
|
DESCRIPTION_FILE="$2"
|
|||
|
|
shift 2
|
|||
|
|
;;
|
|||
|
|
-p|--prerelease)
|
|||
|
|
PRERELEASE=true
|
|||
|
|
shift
|
|||
|
|
;;
|
|||
|
|
-h|--help)
|
|||
|
|
usage
|
|||
|
|
exit 0
|
|||
|
|
;;
|
|||
|
|
*)
|
|||
|
|
error "未知参数: $1"
|
|||
|
|
usage
|
|||
|
|
exit 1
|
|||
|
|
;;
|
|||
|
|
esac
|
|||
|
|
done
|
|||
|
|
|
|||
|
|
# 检查必需参数
|
|||
|
|
if [[ -z "$TAG" ]]; then
|
|||
|
|
error "缺少必需参数: --tag"
|
|||
|
|
usage
|
|||
|
|
exit 1
|
|||
|
|
fi
|
|||
|
|
|
|||
|
|
# 验证版本号格式（不允许后缀）
|
|||
|
|
validate_tag "$TAG"
|
|||
|
|
|
|||
|
|
# 如果指定了 --prerelease，自动拼接 -beta 后缀
|
|||
|
|
local BASE_TAG="$TAG"
|
|||
|
|
if [[ "$PRERELEASE" == "true" ]]; then
|
|||
|
|
TAG="${BASE_TAG}-beta"
|
|||
|
|
info "Pre-release 模式：tag 将自动拼接 -beta 后缀"
|
|||
|
|
info "基础版本: $BASE_TAG -> 实际 tag: $TAG"
|
|||
|
|
fi
|
|||
|
|
|
|||
|
|
# 检查工具和环境
|
|||
|
|
check_requirements
|
|||
|
|
|
|||
|
|
# 检查 tag 是否已存在（使用拼接后的 tag）
|
|||
|
|
check_tag_exists "$TAG"
|
|||
|
|
|
|||
|
|
# 设置默认标题
|
|||
|
|
if [[ -z "$TITLE" ]]; then
|
|||
|
|
TITLE="$TAG"
|
|||
|
|
fi
|
|||
|
|
|
|||
|
|
# 读取描述内容
|
|||
|
|
if [[ -n "$DESCRIPTION_FILE" ]]; then
|
|||
|
|
if [[ ! -f "$DESCRIPTION_FILE" ]]; then
|
|||
|
|
error "描述文件不存在: $DESCRIPTION_FILE"
|
|||
|
|
exit 1
|
|||
|
|
fi
|
|||
|
|
DESCRIPTION=$(cat "$DESCRIPTION_FILE")
|
|||
|
|
fi
|
|||
|
|
|
|||
|
|
# 如果没有描述，使用默认值
|
|||
|
|
if [[ -z "$DESCRIPTION" ]]; then
|
|||
|
|
if [[ "$PRERELEASE" == "true" ]]; then
|
|||
|
|
DESCRIPTION="Pre-release $TAG"
|
|||
|
|
else
|
|||
|
|
DESCRIPTION="Release $TAG"
|
|||
|
|
fi
|
|||
|
|
fi
|
|||
|
|
|
|||
|
|
# 显示即将执行的操作
|
|||
|
|
echo
|
|||
|
|
info "========================================="
|
|||
|
|
info " PolyHermes Release 创建"
|
|||
|
|
info "========================================="
|
|||
|
|
info "Tag: $TAG"
|
|||
|
|
info "Title: $TITLE"
|
|||
|
|
info "Pre-release: $PRERELEASE"
|
|||
|
|
info "Description:"
|
|||
|
|
echo "$DESCRIPTION" | sed 's/^/ /'
|
|||
|
|
info "========================================="
|
|||
|
|
echo
|
|||
|
|
|
|||
|
|
# 确认操作
|
|||
|
|
read -p "确认创建 Release？(y/N): " -n 1 -r
|
|||
|
|
echo
|
|||
|
|
if [[ ! $REPLY =~ ^[Yy]$ ]]; then
|
|||
|
|
info "已取消"
|
|||
|
|
exit 0
|
|||
|
|
fi
|
|||
|
|
|
|||
|
|
# 1. 创建 tag（基于当前 HEAD）
|
|||
|
|
info "创建 tag: $TAG"
|
|||
|
|
git tag "$TAG"
|
|||
|
|
success "Tag 创建成功: $TAG"
|
|||
|
|
|
|||
|
|
# 2. 推送 tag 到远程
|
|||
|
|
info "推送 tag 到远程..."
|
|||
|
|
git push origin "$TAG"
|
|||
|
|
success "Tag 推送成功"
|
|||
|
|
|
|||
|
|
# 3. 创建 GitHub Release
|
|||
|
|
info "创建 GitHub Release..."
|
|||
|
|
|
|||
|
|
local RELEASE_ARGS=(
|
|||
|
|
"$TAG"
|
|||
|
|
--title "$TITLE"
|
|||
|
|
--notes "$DESCRIPTION"
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
if [[ "$PRERELEASE" == "true" ]]; then
|
|||
|
|
RELEASE_ARGS+=(--prerelease)
|
|||
|
|
fi
|
|||
|
|
|
|||
|
|
if gh release create "${RELEASE_ARGS[@]}"; then
|
|||
|
|
success "GitHub Release 创建成功！"
|
|||
|
|
|
|||
|
|
# 获取 release URL
|
|||
|
|
local RELEASE_URL=$(gh release view "$TAG" --json url -q .url)
|
|||
|
|
info "Release URL: $RELEASE_URL"
|
|||
|
|
|
|||
|
|
echo
|
|||
|
|
success "========================================="
|
|||
|
|
success " Release 创建完成！"
|
|||
|
|
success "========================================="
|
|||
|
|
success "Tag: $TAG"
|
|||
|
|
success "Pre-release: $PRERELEASE"
|
|||
|
|
success "URL: $RELEASE_URL"
|
|||
|
|
success "========================================="
|
|||
|
|
echo
|
|||
|
|
info "GitHub Actions 将自动触发构建流程"
|
|||
|
|
|
|||
|
|
if [[ "$PRERELEASE" == "true" ]]; then
|
|||
|
|
warn "这是 Pre-release，GitHub Actions 不会发送 Telegram 通知"
|
|||
|
|
fi
|
|||
|
|
else
|
|||
|
|
error "GitHub Release 创建失败"
|
|||
|
|
error "请手动在 GitHub 上创建 Release: https://github.com/WrBug/PolyHermes/releases/new"
|
|||
|
|
exit 1
|
|||
|
|
fi
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
# 执行主函数
|
|||
|
|
main "$@"
|
|||
|
|
|