edit | blame | history | raw

03-O — 输出成果

O = Output。本目录存放 Aligner 项目所有产出物。
IN git — 需要版本管理的都在这里。
Git 仓库根目录：03-O/。不要在项目根目录或 03-O/C1.source/ 单独初始化 Git 仓库。

目录结构

路径 内容 git
C1.source/ 源代码 — Sources/ + Tests/ + Package.swift ✅
C2.builds/ 构建输出 — 根目录只保留当前发布包目录、旧版归档、研发中间产物 ✅
C2.builds/Aligner-<Version>-build<YYYYMMDD.HHMM>/ 当前最新包 — 最新可分发 DMG + SHA256SUMS.txt ✅
C2.builds/X-旧版build成果/ 历史存档 — 旧 DMG / 旧发布包归档，不放旧 .app ✅
C2.builds/Z-研发中间产物/ 内部工作区 — 当前 .app、QA 报告、trace、截图样本、图标试验 ✅
C3.tools/ 工具脚本 — 打包脚本、窗口诊断 ✅
K1.业务知识/ 业务知识 — 窗口行为、Space 枚举、AX API、架构共识 ✅
K2.项目管理/ 项目管理知识 — SOP、协作规范、经验教训 ✅

Git 规则

  • 03-O/ 是唯一 Git 仓库根目录。
  • C1.source/、C3.tools/、K1.业务知识/、K2.项目管理/ 都随 03-O/ 一起版本管理。
  • C1.source/ 只是 SwiftPM / Xcode 工程根，不是 Git 根。
  • 过程文档 02-P/ 和输入材料 01-I/ 不进入该 Git 仓库。

C2.builds 规则

  • C2.builds/ 根目录永远保持清爽：只放一个当前最新包目录、X-旧版build成果/、Z-研发中间产物/。
  • 当前最新包目录命名为 Aligner-<Version>-build<YYYYMMDD.HHMM>/，目录内放当前 .dmg 和 SHA256SUMS.txt。
  • X-旧版build成果/ 只存历史可恢复包；旧 .app 不进入归档（避免 macOS 搜出一堆旧 App 影响系统表现）。
  • Z-研发中间产物/current/Aligner.app 是研发和 QA 脚本使用的当前可运行 .app，不是分发包。
  • Z-研发中间产物/qa-reports/ 存放 Round QA JSON、trace、XML、截图样本等中间产物，不允许散落在 C2.builds/ 根目录。
  • 可验收 / 可分发 DMG 命名格式：Aligner-<Version>-build<YYYYMMDD.HHMM>.dmg
  • DMG 文件名中的 version / build 必须与 Z-研发中间产物/current/Aligner.app/Contents/Info.plist 中的 CFBundleShortVersionString / CFBundleVersion 一致。
  • 本地开发包优先使用稳定代码签名身份。若只能使用 ad-hoc 签名，Accessibility / Screen Recording 的 TCC 授权可能在重打包后失效，表现为系统开关已打开但 App 内仍显示未授权。
  • C3.tools/package-app.sh 默认只打包不启动；需要打包后自动启动时显式设置 ALIGNER_OPEN_AFTER_BUILD=1。
  • C3.tools/check-signing.sh 可检查本机当前会使用的签名身份。推荐长期固定 Aligner Local Code Signing；未创建该身份时，可临时使用 ALIGNER_CODE_SIGN_IDENTITY 指定现有稳定本地签名身份。