client_framework/docs/new_app_config_template.md

新应用配置模板

创建新应用时，请填写以下配置信息。

---

一、应用基本信息

配置项	值	说明
应用名称	填写应用名称	如：FunyMee AI
Android 包名	填写 Android 包名	如：com.funymeeai.app
iOS Bundle ID	填写 iOS Bundle ID	如：com.funymeeai.app
应用 ID（appId）	填写 appId	后台接口参数用

---

二、服务器配置

配置项	值	说明
预发布环境 URL	填写预发布环境 URL	如：https://pre-api.example.com
生产环境 URL	填写生产环境 URL	如：https://api.example.com
代理接口路径	填写代理接口路径	如：/v1/proxy

---

三、代理请求体字段配置

配置项	值	说明
appId 明文	填写字段名	如：hero_class
原始path	填写字段名	如：pet_species
"POST"或"GET"	填写字段名	如：power_level
映射后的Header字段名构造JSON	填写字段名	如：quest_rank
映射后的URL参数字段名构造JSON	填写字段名	如：battle_score
V2包装后的业务数据	填写字段名	如：loyalty_index
噪音字段名列表	填写字段名列表	如：['billing_addr', 'utm_term', 'cluster_id', ...]

---

四、V2 包装配置

配置项	值	说明
V2 层级	填写字段名	如：arsenal
V2 层级值	填写值	如：4
V2 层级路径	填写路径	如：['vault', 'tome', 'codex', 'grimoire', 'sanctum']
噪音字段名列表	填写字段名列表	如：['roar', 'clash', 'thunder', 'rumble', 'howl', 'growl']

---

五、安全配置

配置项	值	说明
AES 密钥	填写 16 字节 AES 密钥	用于请求加密，AES-128 需要 16 字符

密钥长度说明：

• AES-128：16 字节（16 个字符）
• AES-256：32 字节（32 个字符）

当前框架使用 AES-128-ECB 模式，密钥固定为 16 字符。

---

六、Adjust SDK 配置

配置项	值	说明
App Token	填写 Adjust App Token	Adjust Dashboard 获取
Environment	sandbox / production	测试用 sandbox，正式用 production

Adjust 事件 Token（如有自定义）

事件名称	事件 Token
首充	填写 token
购买	填写 token
注册	填写 token
$5.99 档位	填写 token
$9.99 档位	填写 token
$19.99 档位	填写 token
$49.99 档位	填写 token
$99.99 档位	填写 token

---

七、Facebook SDK 配置

配置项	值	说明
App ID	填写 Facebook App ID	Facebook Developer Console 获取
Client Token	填写 Client Token	Facebook Developer Console 获取

MethodChannel 名称：框架自动使用 {packageName}/facebook_sdk，无需配置

---

八、字段映射配置（可选）

如有特殊字段映射需求请填写，默认使用框架默认映射。

原始字段名	映射后字段名	说明

---

九、其他配置（如有）

配置项	值	说明
调试基础 URL 覆盖	填写调试用 URL	仅调试时使用，可留空

---

十、填写完成后的配置示例

// app_config.dart
class NewAppConfig extends AppConfig {
  @override
  String get appId => 'your_app_id';

  @override
  String get packageName => 'com.example.app';

  @override
  String get aesKey => 'your_16_char_key';  // AES-128 需要 16 字符

  @override
  String get preBaseUrl => 'https://pre-api.example.com';

  @override
  String get prodBaseUrl => 'https://api.example.com';

  @override
  String get proxyPath => '/v1/proxy';

  @override
  ProxyKeysConfig get proxyKeys => const ProxyKeysConfig(
    appIdField: 'hero_class',
    pathField: 'pet_species',
    methodField: 'power_level',
    headerField: 'quest_rank',
    paramsField: 'battle_score',
    bodyField: 'loyalty_index',
    noiseKeys: ['billing_addr', 'utm_term', 'cluster_id', 'lsn_value', 'accuracy_val', 'dir_path'],
  );

  @override
  String get v2LevelField => 'arsenal';

  @override
  int get v2LevelFixedValue => 4;

  @override
  List<String> get v2SanctumPath =>
      const ['vault', 'tome', 'codex', 'grimoire', 'sanctum'];

  @override
  List<String> get v2NoiseKeys =>
      const ['roar', 'clash', 'thunder', 'rumble', 'howl', 'growl'];
}

// main.dart
await AnalyticsService.init(
  AnalyticsConfig(
    packageName: 'com.example.app',
    adjustConfig: AdjustConfig(
      appToken: 'your_adjust_app_token',
      environment: AdjustEnv.sandbox,
    ),
    facebookConfig: FacebookConfig(
      appId: 'your_facebook_app_id',
      clientToken: 'your_facebook_client_token',
    ),
  ),
);

---

填写完成后发送给我，我将根据此配置创建完整的应用代码。