找物源码导读Cocos Creator 3.8 · assets/scripts
0%
已读 0 / 424
目录— 个文件
目录加载中…
…/bridge/config/ConfigDefine.ts
1import type { ConfigData } from "../../framework/core/config/ConfigFrameDefine";
2import type { PackageFeatureFlags } from "../package/PackageDefine";
3
4/** 每张公共配置独立命名,使用方自行选择平台或 A/B 版本。 */
5export enum ConfigName {
6 BundleVersionWechat = "BundleVersionWechat",
7 BundleVersionWeb = "BundleVersionWeb",
8 GameGlobal = "GameGlobal",
9 Feed = "Feed",
10 DailyChallenge = "DailyChallenge",
11 DailyChallengeCalendar = "DailyChallengeCalendar",
12 Hotspot = "Hotspot",
13 /** 热点实验的 B 组配置,原 Hotspot 保留为 A 组。 */
14 HotspotB = "HotspotB",
15 Achievement = "Achievement",
16 MainlineA = "MainlineA",
17 MainlineB = "MainlineB",
18 Guide = "Guide",
19 Stage = "Stage",
20}
21
22/** 公共配置静态清单;启动全部并发加载,不负责业务选择。 */
23// 运行时只读取此定义,不修改清单或条目。
24/** 包开关属于项目;框架只接收入口筛选后的配置清单。 */
25type ProjectConfigData = ConfigData & { FeatureFlagKey?: keyof PackageFeatureFlags };
26export const ConfigDataMap: ProjectConfigData[] = [
27 { Name: ConfigName.BundleVersionWechat, LocalAssetName: "weChatBundleMd5", RemotePath: "GameConfig/weChatBundleMd5.json" },
28 { Name: ConfigName.BundleVersionWeb, LocalAssetName: "webBundleMd5", RemotePath: "GameConfig/webBundleMd5.json" },
29 { Name: ConfigName.GameGlobal, LocalAssetName: "findRemoteConfig", RemotePath: "GameConfig/findRemoteConfig.json" },
30 { Name: ConfigName.Feed, LocalAssetName: "FeedConfig", RemotePath: "GameConfig/FeedConfig.json" },
31 { Name: ConfigName.DailyChallenge, LocalAssetName: "DailyChallengeConfig", RemotePath: "GameConfig/DailyChallengeConfig.json" },
32 // 每日挑战日历保留包内加载,不请求远端配置。
33 { Name: ConfigName.DailyChallengeCalendar, LocalAssetName: "DailyChallengeCalendarConfig" },
34 { Name: ConfigName.Hotspot, LocalAssetName: "HotspotConfig", RemotePath: "GameConfig/HotspotConfig.json" },
35 // B 表复用远程优先、失败回退包内的加载规则。
36 { Name: ConfigName.HotspotB, LocalAssetName: "HotspotConfig_1", RemotePath: "GameConfig/HotspotConfig_1.json", FeatureFlagKey: "enableHotspotAB" },
37 { Name: ConfigName.Achievement, LocalAssetName: "achiveConfig" },
38 { Name: ConfigName.MainlineA, LocalAssetName: "findConfig", RemotePath: "GameConfig/findConfig.json" },
39 { Name: ConfigName.MainlineB, LocalAssetName: "findConfig_1", RemotePath: "GameConfig/findConfig_1.json" },
40 { Name: ConfigName.Guide, LocalAssetName: "findGuideConfig" },
41 { Name: ConfigName.Stage, LocalAssetName: "findStageConfig" },
42];
讲解43 行
公共配置清单人工通读

ConfigDefine.ts

定义公共配置表的名字枚举与加载清单。ConfigName 是每张表的唯一标识,ConfigDataMap 描述包内资源名、远端路径与所属包开关;GameEntry.ConfigureConfig 过滤这份清单后传给框架配置管理器并发加载。

先核对 ConfigName 与 ConfigDataMap 是否一一对应,再重点看带 FeatureFlagKey 和只写 LocalAssetName 的两类条目。

特殊处理与易错点

5注释每张公共配置独立命名,使用方自行选择平台或 A/B 版本。
14注释热点实验的 B 组配置,原 Hotspot 保留为 A 组。
25注释公共配置静态清单;启动全部并发加载,不负责业务选择。
33注释每日挑战日历保留包内加载,不请求远端配置。
36注释B 表复用远程优先、失败回退包内的加载规则。