Carbon Fiber Wiki

外观

快速开始 ​

环境要求 ​

开发 App 需要 macOS、Xcode、XcodeGen 和 Task。开发 Wiki 还需要 Node.js 20 或更高版本与 npm。

先检查 Apple 开发工具链：

bash
task doctor

该命令会检查 xcodegen、xcodebuild、Swift 工具链和 iOS Info.plist。

首次构建 ​

如果当前目录仍是模板仓库，可以直接验证模板：

bash
task verify
task test
task build:mac

task verify 会重新生成 Xcode 工程并构建 iOS 模拟器版本。task test 使用 build-for-testing，不会因为本机模拟器未启动而阻塞基础验证。

启动 App ​

bash
task ios:run

命令会优先选择已连接的 iOS 真机；没有真机时，回退到 Taskfile 配置的模拟器。可以通过 Task 变量覆盖设备与系统版本：

bash
IOS_SIMULATOR_NAME='iPhone 16e' \
IOS_SIMULATOR_OS='26.2' \
task ios:run

启动 Wiki ​

首次安装锁定依赖：

bash
task wiki:install

启动本地开发服务：

bash
task wiki:dev

构建发布产物：

bash
task wiki:build

VitePress 把 Keli Apps 部署产物写入 wiki/dist/。该目录和依赖目录均不提交到 Git。

Keli Apps 托管 ​

当前 Wiki 部署在：

text
https://apps.keli.tech/x/carbon-fiber-wiki/

wiki/apps.yaml 是托管清单。首次发布完成后，后续更新使用显式更新命令：

bash
task wiki:package
task wiki:publish

task wiki:publish 会重新构建站点并执行 keli-cli publish ./wiki --update。

开始产品开发前 ​

不要直接在 CarbonFiberApp 占位名上继续开发真实产品。先按实例化新 App统一修改项目名、目标名、源码目录、测试目录、Bundle ID、展示名和 Wiki 内容。