Carbon Fiber Wiki

外观

Carbon Fiber App Template ​

Carbon Fiber 是一个面向 iOS 16+ 与 macOS 13+ 的 SwiftUI App 模板。它把项目生成、设置、本地化、外观、本地存储和验证流程整理为可复用基线，适合在此基础上快速派生具体产品。

从这里开始 ​

目标文档
了解模板提供什么项目概览
准备环境并完成首次构建快速开始
理解模块和数据流整体架构
创建一个真实产品实例化新 App
接入权限、网络或第三方 SDK隐私与能力接入

核心约束 ​

  • project.yml 是 Xcode 项目结构的唯一事实来源，生成的 *.xcodeproj 可以随时重建。
  • CarbonFiberApp 是模板占位名，派生应用必须在功能开发前完成整体实例化。
  • AppPreferences 统一管理语言、外观和首次运行状态。
  • 设置入口、跟随系统语言、英文回退、浅色/深色/系统外观必须在派生应用中持续可用。
  • 产品数据默认只保存在本机。新增账号、网络、分析、广告、跟踪、权限或后台能力前必须完成隐私评审。

常用命令 ​

bash
task verify       # 验证工具链并构建 iOS App
task test         # 构建 XCTest 测试包
task build:mac    # 构建 macOS App
task wiki:build   # 构建本 Wiki
task wiki:dev     # 启动 Wiki 本地开发服务

底层工程约束仍记录在仓库根目录的 AGENTS.md 和 docs/ 中；本 Wiki 是面向开发者的统一阅读入口。