FoxTalk
文档/项目配置

项目配置

FoxTalk 把所有运行时可变的配置收敛在两处: 服务端地址走 AppConfig (dart 端), App 品牌走 branding/app_brand.json (生成原生工程配置)。

lib/src/config/app_config.dart 是客户端的运行时配置入口, 含三段地址:

serverBaseUrl
服务端 origin (例: https://your-server.example), 用于拼图片 / 上传 / 业务接口。
apiBaseUrl
API v1 根路径 (例: https://your-server.example/v1/), api_client.dart 默认 base。
webBaseUrl
Web 资源根路径 (例: https://your-server.example/web/), 给原版 web 视图复用。

用 --dart-define 切服务端

默认地址 https://your-server.example 是 production, TF / App Store Archive 即使没带 --dart-define 也连 prod。本地连局域网服务端用 --dart-define 覆盖:

flutter run --dart-define=CHATIM_SERVER_BASE_URL=http://<LAN_IP>:8090

应用品牌与显示名

branding/app_brand.json 是品牌入口, 改这一个文件后跑工具会生成 ios/Flutter/AppBrand.xcconfig + Android string 资源, 同步显示名与 bundle name。

{
  "displayName": "FoxTalk",
  "bundleName": "foxtalk",
  "idLabel": "FoxTalk ID"
}

目录名 repo/TangSengDaoDaoFlutter/ 保留上游名称便于跟 sync, 对外品牌一律走这个文件。

iOS aps-environment

Runner.entitlements 内的 aps-environment 用于 APNs 推送, dev / prod 分别对应 development / production。Xcode 自动签名时不需要手动改, Archive 上传 App Store / TF 时会自动用 production; 真机 debug 跑会用 development。

last updated · 2026-06