- config.json 改为按项目存储(projects.<id>),上传配置全局共用;旧单项目配置自动迁移为 readoor
- 新增项目管理(管理员):Git 仓库/凭据、源码目录、Xcode 工程、拷贝条目、配置替换方式、自定义字段、替换规则
- 通用配置替换:pbxproj 版本号与签名,patch_rules 支持 define / replace_line 及 ${app.X}、${server.X} 模板
- 请求通过 X-Project 头选择项目;打包任务记录 project_id,历史按项目过滤
- 前端顶部切换项目,App/服务器环境表单按项目显示字段
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2.8 KiB
2.8 KiB
iOS Build Server
FastAPI + Vue 3 iOS app auto-packaging service. Supports Ad_Hoc and App_Store builds with web UI, real-time logs, multi-user auth, and health monitoring.
Tech Stack
- Backend: Python 3.9+, FastAPI, SQLAlchemy (SQLite), JWT auth
- Frontend: Vue 3, Vite, Vue Router
- Tests: pytest (backend), vitest (frontend)
- Deploy: macOS launchd, deploy.sh management script
Key Commands
./start.sh # Dev mode (backend + frontend hot reload)
./deploy.sh build # Install deps + build frontend
./deploy.sh start/stop/restart/status
./deploy.sh test # Run all tests (backend + frontend)
Architecture
backend/routers/— API routes: auth, users, config, apps, tasksbackend/services/— build_service (packaging), build_queue (async queue), log_streamer (WebSocket)backend/deps.py— JWT auth dependency used by all protected routesbackend/config.py— loads .env, defines all config constantsfrontend/src/views/— BuildView, HistoryView, ConfigViewconfig.json— runtime config (apps, schemes, servers, upload, branches, versions) managed via web UI- Multi-project:
config.jsonis{"projects": {pid: {definition + data}}, "upload": {...}};backend/projects.pyholds project definitions (git, source_dir, xcode, copy_items, patcherreadoor/generic, patch_rules, app_fields/server_fields, obfuscation). Requests pick the project viaX-Projectheader (or?project=), bound in a ContextVar by middleware;load_config()returns the current project's data plusuploadand_project. Legacy flat config auto-migrates to projectreadoor(uses.envGit settings). Tasks storeproject_id; build dirs arebuild_{pid}_{task_id} - Versions are per-branch (within each project): every branch owns a track in
config["versions"]["tracks"], named after the branch (master/main keeps the historical namerelease);config["branch_track"]maps branch → track name, and each track'skindisrelease(build number auto-increments on App_Store) orfeature(never increments) - Tags are buildable refs too:
config["tags"](names never collide with branches), tracked inbranch_tracklike branches (default kindrelease); tasks store the name inbranchplusref_type(branch/tag), and tag builds check outrefs/tags/<tag>detached
Conventions
- All backend routes require JWT auth except
/api/auth/loginand/api/health - Admin-only routes: user management (
/api/users/*) and all of/api/config/*except/api/config/apps*(incl. project CRUD/api/config/projects*);GET /api/projectsis the public project list for any logged-in user - Config stored in
config.json(apps/schemes/servers),.env(infra), SQLitebuild_configtable (build settings) - Chinese UI and documentation throughout