# 新应用配置模板

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

***

## 一、应用基本信息

| 配置项           | 值                  | 说明                  |
| ------------- | ------------------ | ------------------- |
| 应用名称          | `填写应用名称`           | 如：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`，无需配置

***

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

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

| 原始字段名  | 映射后字段名 | 说明     |
| ------ | ------ | ------ |
| <br /> | <br /> | <br /> |

***

## 九、其他配置（如有）

| 配置项         | 值           | 说明         |
| ----------- | ----------- | ---------- |
| 调试基础 URL 覆盖 | `填写调试用 URL` | 仅调试时使用，可留空 |
| <br />      | <br />      | <br />     |

***

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

```dart
// 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',
    ),
  ),
);
```

***

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