Skip to content

GITHUB_ACTIONS_GUIDE.md

Latest commit

 

History

History
105 lines (73 loc) · 2.92 KB

GITHUB_ACTIONS_GUIDE.md

File metadata and controls

105 lines (73 loc) · 2.92 KB
Raw

使用 GitHub Actions 验证编译

本指南说明如何把代码上传到 GitHub，并自动触发 iOS 编译验证。

第一步：在 GitHub 上创建仓库

  1. 打开 github.com → 登录账号
  2. 点击右上角 "+" → New repository
  3. 填写：
    • Repository name: IntervalTimer
    • Visibility: Public（免费账号的 macOS runner 只对 Public 仓库免费）
    • 不要勾选 Add a README
  4. 点击 Create repository
  5. 记下仓库地址，如：https://github.com/你的用户名/IntervalTimer.git

第二步：把代码上传到 GitHub

在云 IDE 的终端中执行以下命令：

# 进入项目目录
cd /mnt/4441865974/Python3/IntervalTimer

# 初始化 Git
git init
git add .
git commit -m "feat: 初始化 IntervalTimer 项目"

# 关联 GitHub 仓库（替换为你的用户名）
git remote add origin https://github.com/你的用户名/IntervalTimer.git

# 推送代码（首次需要输入 GitHub 用户名和 Token）
git branch -M main
git push -u origin main

⚠️ GitHub 密码已不支持，需要使用 Personal Access Token（PAT） 获取方式：GitHub → Settings → Developer settings → Personal access tokens → Generate new token 权限勾选：repo 即可

第三步：查看自动编译结果

推送成功后：

  1. 打开你的 GitHub 仓库页面

  2. 点击顶部 Actions 标签

  3. 可以看到名为 "iOS 编译验证" 的 workflow 正在运行

    🔍 逻辑模拟验证 (Python)   ──→  运行 Python 验证脚本
     ↓ 通过后
🔨 Xcode 编译验证 (macOS)  ──→  真实 xcodebuild 编译

  4. 等待约 3~8 分钟，看到全部绿色 ✅ 即代表编译通过

如何手动触发（不推送代码也能运行）

  1. 进入 GitHub 仓库 → Actions 标签
  2. 左侧选择 "iOS 编译验证"
  3. 右侧点击 "Run workflow" 按钮
  4. 选择分支 main → 点击绿色 "Run workflow"

结果说明

图标 含义
🟡 黄色旋转 正在运行中
✅ 绿色对勾 编译成功，代码无问题
❌ 红色叉号 编译失败，点进去查看错误

编译失败时如何查看错误

  1. 点击失败的 workflow run
  2. 点击 "🔨 Xcode 编译验证" job
  3. 展开 "执行编译" 步骤查看详细错误
  4. 或者下载 Artifacts 中的 build-log 文件

当前 workflow 包含的检查项

Job 1：Python 逻辑验证（约 30 秒）

  • ✅ 所有 Swift 文件结构完整性（128 项检查）
  • ✅ 核心业务逻辑正确性（152 个断言）

Job 2：Xcode 真实编译（约 5 分钟）

  • ✅ Swift 语法完全正确
  • ✅ 类型系统一致（协议、泛型、可选值）
  • ✅ 所有文件间依赖正确
  • ✅ iOS 16 SDK 兼容性

注：macOS runner 在 GitHub Free 账号下，Public 仓库每月有 2000 分钟免费额度，足够日常使用。