@playcraft/devkit 1.0.31-beta.11 → 1.0.31-beta.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (101) hide show
  1. package/cli/bin/playable-scripts.js +6 -53
  2. package/cli/commands/build.js +32 -241
  3. package/cli/commands/builds.js +2 -13
  4. package/cli/commands/dev.js +1 -22
  5. package/cli/commands/pack.js +40 -320
  6. package/cli/commands/vite-dev.js +1 -7
  7. package/core/artifacts/emit-fonts.test.js +1 -0
  8. package/core/artifacts/emit.js +4 -98
  9. package/core/artifacts/fflate.js +1 -31
  10. package/core/artifacts/zip.js +1 -39
  11. package/core/batch-build.js +147 -1261
  12. package/core/constants.js +2 -20
  13. package/core/cos-uploader.js +23 -289
  14. package/core/engines/cocos/adapter-vfs-path.test.js +1 -0
  15. package/core/engines/cocos/clean-cache.js +5 -179
  16. package/core/engines/cocos/clean-cache.test.js +1 -75
  17. package/core/engines/cocos/cli-build.js +2 -116
  18. package/core/engines/cocos/cli.js +11 -38
  19. package/core/engines/cocos/constants.js +1 -21
  20. package/core/engines/cocos/creator-cli.js +1 -108
  21. package/core/engines/cocos/dev-server.js +4 -412
  22. package/core/engines/cocos/fs.js +1 -105
  23. package/core/engines/cocos/injects/3x/init.js +19 -438
  24. package/core/engines/cocos/injects/3x/main.js +2 -52
  25. package/core/engines/cocos/injects/libs/pako.js +1 -2
  26. package/core/engines/cocos/mcp-refresh.js +2 -76
  27. package/core/engines/cocos/merge-inline.test.js +1 -0
  28. package/core/engines/cocos/merge.js +9 -148
  29. package/core/engines/cocos/omit-playable-weight.js +10 -0
  30. package/core/engines/cocos/omit-playable-weight.test.js +2 -0
  31. package/core/engines/cocos/pack.js +1 -187
  32. package/core/engines/cocos/preview-cache.js +2 -48
  33. package/core/engines/cocos/preview-cache.test.js +1 -32
  34. package/core/engines/cocos/preview-concat.js +6 -189
  35. package/core/engines/cocos/preview-concat.test.js +1 -73
  36. package/core/engines/cocos/preview-json-hook.js +1 -200
  37. package/core/engines/cocos/preview-json-pack.js +3 -376
  38. package/core/engines/cocos/preview-json-pack.test.js +2 -226
  39. package/core/engines/cocos/preview-proxy.js +1 -132
  40. package/core/engines/cocos/rebundle-preview.js +2 -54
  41. package/core/engines/cocos/strip-social-share.js +3 -115
  42. package/core/engines/cocos/theme-assets.js +2 -161
  43. package/core/engines/cocos/theme-levels.js +1 -0
  44. package/core/engines/cocos/writable-cli.js +2 -248
  45. package/core/engines/cocos/writable-cli.test.js +1 -112
  46. package/core/engines/web/index.js +1 -20
  47. package/core/engines/web/vite.dev.js +17 -322
  48. package/core/engines/web/webpack.build.js +37 -522
  49. package/core/engines/web/webpack.common.js +11 -177
  50. package/core/engines/web/webpack.dev.js +6 -88
  51. package/core/index.js +7 -101
  52. package/core/injectors/apply.js +1 -94
  53. package/core/injectors/check-channel-matrix.js +2 -130
  54. package/core/injectors/spec.js +10 -217
  55. package/core/loaders/gltf-loader.js +28 -74
  56. package/core/options.js +16 -353
  57. package/core/plugins/AdikteevInjectorPlugin.js +4 -26
  58. package/core/plugins/BigoAdsInjectorPlugin.js +4 -21
  59. package/core/plugins/DAPIInjectorPlugin.js +2 -25
  60. package/core/plugins/DebuggerInjectionPlugin.js +3 -31
  61. package/core/plugins/ExitAPIInjectorPlugin.js +3 -56
  62. package/core/plugins/FflateCompressionPlugin.js +160 -307
  63. package/core/plugins/FflateCompressionPlugin.test.js +13 -0
  64. package/core/plugins/FontInjectionWebpackPlugin.js +4 -46
  65. package/core/plugins/LiftoffInjectorPlugin.js +4 -26
  66. package/core/plugins/MRAIDInjectorPlugin.js +2 -24
  67. package/core/plugins/MintegralInjectorPlugin.js +2 -25
  68. package/core/plugins/PangleInjectorPlugin.js +2 -24
  69. package/core/plugins/PlaycraftOrientationInjectorPlugin.js +3 -29
  70. package/core/plugins/SnapchatInjectorPlugin.js +4 -26
  71. package/core/plugins/SocialMediaInjectorPlugin.js +7 -119
  72. package/core/plugins/TikTokInjectorPlugin.js +2 -24
  73. package/core/plugins/UnityInjectorPlugin.js +8 -37
  74. package/core/plugins/ZipPlugin.js +20 -154
  75. package/core/plugins/socialMediaVitePlugin.js +2 -108
  76. package/core/utils/buildDefines.js +2 -30
  77. package/core/utils/buildTemplateString.js +5 -39
  78. package/core/utils/date.js +1 -16
  79. package/core/utils/fontRegistry.js +13 -81
  80. package/core/utils/fontResolver.js +37 -335
  81. package/core/utils/generateAdikteevHtmlWebpackPluginConfig.js +8 -42
  82. package/core/utils/generateBigabidHtmlWebpackPluginConfig.js +3 -30
  83. package/core/utils/generateInMobiHtmlWebpackPluginConfig.js +7 -43
  84. package/core/utils/getPlaycraftOrientationSuffix.js +2 -9
  85. package/core/utils/injectSDKPlugins.js +13 -68
  86. package/core/utils/logOptions.js +5 -46
  87. package/core/utils/mergeOptions.js +2 -21
  88. package/core/utils/obfuscateLevels.js +14 -0
  89. package/core/utils/obfuscateLevels.test.js +10 -0
  90. package/core/utils/parseArgvOptions.js +5 -125
  91. package/core/utils/resolveChannelFold2Zip.js +3 -15
  92. package/core/utils/validateThemeData.js +26 -227
  93. package/core/validators/pre-build-checker.js +25 -287
  94. package/core/validators/tracking-validator.js +40 -441
  95. package/core/validators/tracking-validator.test.js +2 -84
  96. package/core/vite.dev.js +1 -1
  97. package/core/webpack.build.js +1 -1
  98. package/core/webpack.common.js +1 -1
  99. package/core/webpack.dev.js +1 -1
  100. package/package.json +2 -3
  101. package/README.md +0 -262
@@ -1 +1 @@
1
- module.exports = require('./engines/web/webpack.common.js');
1
+ "use strict";module.exports=require("./engines/web/webpack.common.js");
@@ -1 +1 @@
1
- module.exports = require('./engines/web/webpack.dev.js');
1
+ "use strict";module.exports=require("./engines/web/webpack.dev.js");
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@playcraft/devkit",
3
- "version": "1.0.31-beta.11",
3
+ "version": "1.0.31-beta.14",
4
4
  "description": "HTML5 Playable Ads 构建工具,支持多广告渠道打包",
5
5
  "main": "core/index.js",
6
6
  "module": "core/index.js",
@@ -15,7 +15,6 @@
15
15
  "defines.d.ts"
16
16
  ],
17
17
  "scripts": {
18
- "build": "node scripts/build.js",
19
18
  "deploy": "npm run build && cd dist && npm publish --registry https://registry.npmjs.org/ --access public",
20
19
  "deploy:beta": "npm run build && cd dist && npm publish --registry https://registry.npmjs.org/ --access public --tag beta"
21
20
  },
@@ -86,4 +85,4 @@
86
85
  "publishConfig": {
87
86
  "registry": "https://registry.npmjs.org/"
88
87
  }
89
- }
88
+ }
package/README.md DELETED
@@ -1,262 +0,0 @@
1
- # @tencent/playable-scripts
2
-
3
- HTML5 Playable Ads 构建工具,支持多广告渠道打包。
4
-
5
- ## 特性
6
-
7
- - 🚀 **一键构建** - 轻松为不同广告渠道生成构建包
8
- - ⚡ **自动优化** - 包含压缩、Tree-shaking 和死代码消除
9
- - 🗜️ **fflate 压缩** - 编译时压缩,运行时解压,体积减少 40-60%
10
- - 🎯 **多渠道支持** - 支持 Google Ads、Meta、AppLovin、Unity、IronSource、BigoAds 等
11
- - 🎨 **主题系统** - 支持多主题批量构建
12
- - 🔄 **并发构建** - 智能并发,大幅提升构建效率
13
-
14
- ## 快速开始
15
-
16
- ### 安装
17
-
18
- ```bash
19
- tnpm install --save-dev @tencent/playable-scripts
20
- ```
21
-
22
- ### 配置 package.json
23
-
24
- ```json
25
- {
26
- "scripts": {
27
- "dev": "playable-scripts dev",
28
- "build": "playable-scripts build",
29
- "builds": "playable-scripts builds"
30
- }
31
- }
32
- ```
33
-
34
- ### 启动开发服务器
35
-
36
- ```bash
37
- npm run dev # 默认预览模式
38
- npm run dev bigoads # 指定渠道调试(简写)
39
- npm run dev -- --network social_media # 指定渠道调试(完整参数)
40
- npm run dev -- --port 8080 # 指定端口
41
- ```
42
-
43
- ### 构建指定渠道
44
-
45
- ```bash
46
- npm run build google # Google Ads
47
- npm run build facebook # Meta
48
- npm run build unity # Unity Ads
49
- npm run build bigoads # BigoAds
50
- ```
51
-
52
- ### 批量构建
53
-
54
- ```bash
55
- npm run builds # 构建所有渠道
56
- npm run builds -- -t "theme1,theme2" # 指定主题
57
- npm run builds -- -c "google,facebook" # 指定渠道
58
- npm run builds -- --parallel 4 # 指定并发数
59
-
60
- # Windows PowerShell 兼容格式(推荐)
61
- npm run builds -- "theme1" "google" # 位置参数:主题 渠道
62
- npm run builds -- --themes="theme1,theme2" --channels="google,facebook"
63
- ```
64
-
65
- ## 支持的广告渠道
66
-
67
- | 渠道 | 命令 | 协议 |
68
- |------|------|------|
69
- | Preview (预览) | `preview` | none |
70
- | Google Ads | `google` | none |
71
- | Meta (Facebook) | `facebook` | none(ZIP,仅 index.html,上限 5MB) |
72
- | AppLovin | `applovin` | mraid |
73
- | Unity Ads | `unity` | mraid |
74
- | IronSource | `ironsource` | mraid/dapi |
75
- | TikTok / Pangle | `tiktok` | none |
76
- | BigoAds | `bigoads` | bigo-mraid |
77
- | Adikteev | `adikteev` | mraid |
78
- | Moloco | `moloco` | none |
79
- | Liftoff | `liftoff` | mraid (ZIP) |
80
- | InMobi | `inmobi` | mraid |
81
- | Snapchat | `snapchat` | snapchat |
82
- | Remerge | `remerge` | mraid (ZIP) |
83
- | Mintegral | `mintegral` | none |
84
-
85
- ## CLI 参数
86
-
87
- | 参数 | 描述 | 默认值 |
88
- |------|----------------|-----------|
89
- | **广告渠道** | 目标广告渠道 | `preview` |
90
- | `--out-dir` | 输出目录 | `dist` |
91
- | `--obfuscate-level` | 代码混淆等级 (1-4) | `4` |
92
- | `--fflate-compression` | 启用 fflate 压缩 | `true` |
93
- | `--protocol` | 广告协议 | 渠道自动决定 |
94
- | `--zip` | ZIP 输出结果 | `false` |
95
- | `--port` | 开发服务器端口 | `3000` |
96
- | `--open` | 自动打开浏览器 | `false` |
97
- | `--language` | 语言代码 | `en` |
98
- | `--is-channel-fold2zip ` | 所有渠道输出为 ZIP 结果 | `false` |
99
-
100
- ## 配置文件
101
-
102
- 支持两种配置文件(推荐使用 `builds.config.js`):
103
-
104
- ### builds.config.js(推荐)
105
-
106
- ```javascript
107
- module.exports = {
108
- // 项目基本信息
109
- projectName: 'My-Game', // 可选,默认 'Phaser Game'
110
- googlePlayUrl: 'https://play.google.com/...', // 可选
111
- appStoreUrl: 'https://apps.apple.com/...', // 可选
112
-
113
- // 渠道配置
114
- channels: ['google', 'facebook', 'unity'], // 可选,有默认值
115
-
116
- // 主题配置(可选)
117
- themes: {
118
- enabled: true, // 默认 false
119
- sourceDir: 'src/theme', // 默认 'src/theme'
120
- entryFile: 'src/theme/index.ts', // 默认 'src/theme/index.ts'
121
- whitelist: null, // 可选,过滤函数
122
- },
123
-
124
- // 文件命名配置(可选)
125
- naming: {
126
- language: 'EN', // 默认 'EN'
127
- format: '无', // 默认 '无'
128
- supplier: 'AIX', // 默认 'AIX'
129
- follower: 'ZQL', // 默认 'ZQL'
130
- generator: null, // 可选,自定义生成函数
131
- },
132
-
133
- // 构建配置(可选)
134
- build: {
135
- outputDir: 'dist-all', // 默认 'dist-all'
136
- tempDirPrefix: 'dist-temp', // 默认 'dist-temp'
137
- continueOnError: true, // 默认 true
138
- cleanTemp: true, // 默认 true
139
- parallel: undefined, // 默认自动计算(CPU核心数-1,最小2最大8)
140
- },
141
- cosConfig: {
142
- enabled: true, // 是否启用 COS 上传
143
- SecretId: 'YOUR_SECRET_ID', // 腾讯云 SecretId
144
- SecretKey: 'YOUR_SECRET_KEY', // 腾讯云 SecretKey
145
- Bucket: 'your-bucket-1234567890', // COS 存储桶名称
146
- Region: 'ap-guangzhou', // COS 区域
147
- CdnDomain: 'your-cdn-domain.com', // CDN 域名(用于生成访问链接)
148
- PathPrefix: 'playable/preview', // COS 路径前缀(可选)
149
- },
150
- // 打包参数(可选)
151
- obfuscateLevel: 4, // 默认 4
152
- fflateCompression: false, // 默认 true
153
- };
154
- ```
155
-
156
- ### build.json(向后兼容)
157
-
158
- ```json
159
- {
160
- "app": "AppName",
161
- "name": "ConceptName",
162
- "google_play_url": "https://play.google.com/...",
163
- "app_store_url": "https://apps.apple.com/..."
164
- }
165
- ```
166
-
167
- ### 配置优先级
168
-
169
- ```
170
- 命令行参数 > build.json > builds.config.js > 默认值
171
- ```
172
-
173
- ## 代码混淆等级
174
-
175
- | 等级 | 名称 | 说明 | 体积影响 |
176
- |------|------|------|----------|
177
- | **1** | terser-only | 仅 Terser 压缩 | 基准 |
178
- | **2** | basic | 控制流平坦化 + 字符串编码 | +5~10% |
179
- | **3** | dead-code | 等级 2 + 死代码注入 | +15~25% |
180
- | **4** | maximum | 全部拉满(默认) | +30~50% |
181
-
182
- ## fflate 压缩
183
-
184
- | 指标 | 效果 |
185
- |------|------|
186
- | **压缩率** | 66-68% |
187
- | **体积减少** | 40-60% |
188
- | **解压速度** | 3-5ms |
189
- | **兼容性** | 99%+ 浏览器 |
190
-
191
- ## 批量构建
192
-
193
- ### 特性
194
-
195
- 1. **智能并发** - 自动根据 CPU 核心数优化(默认:核心数-1,最小2最大8)
196
- 2. **独立临时目录** - 每个任务使用独立目录,避免冲突
197
- 3. **主题切换** - 自动切换主题入口文件
198
- 4. **错误容忍** - 单个失败不影响其他构建
199
-
200
- ### 命令行参数
201
-
202
- | 参数 | 缩写 | 描述 | 示例 |
203
- |------|------|------|------|
204
- | `--themes` | `-t` | 指定主题列表(逗号分隔) | `-t "theme1,theme2"` |
205
- | `--channels` | `-c` | 指定渠道列表(逗号分隔) | `-c "google,facebook"` |
206
- | `--parallel` | `-p` | 指定并发数 | `-p 4` |
207
- | 位置参数 | - | 第一个参数=主题,第二个=渠道 | `"theme1" "google"` |
208
- | `=` 格式 | - | Windows PowerShell 兼容 | `--themes="theme1"` |
209
-
210
- **注意**:
211
- - **Mac/Linux**:所有格式均可使用
212
- - **Windows PowerShell**:推荐使用位置参数或 `--themes=value` 格式
213
- - **Windows CMD**:所有格式均可使用
214
-
215
- ### 输出结构
216
-
217
- ```
218
- dist-all/
219
- ├── theme1/
220
- │ ├── theme1-EN-无-3月-20260304-AIX-ZQL-google.zip
221
- │ └── theme1-EN-无-3月-20260304-AIX-ZQL-facebook.zip
222
- └── theme2/
223
- └── ...
224
- ```
225
-
226
- 产物直接放在主题目录下,不再套一层 `主题名_渠道名` 文件夹。文件名本身已包含渠道名。
227
-
228
- ## 全局变量
229
-
230
- 构建时自动注入:
231
-
232
- | 变量 | 描述 | 示例 |
233
- |------|------|------|
234
- | `__DEV__` | 开发模式标志 | `true` / `false` |
235
- | `AD_NETWORK` | 当前广告渠道 | `"google"`, `"bigoads"` |
236
- | `AD_PROTOCOL` | 当前广告协议 | `"none"`, `"mraid"` |
237
- | `GOOGLE_PLAY_URL` | Google Play 链接 | `"https://..."` |
238
- | `APP_STORE_URL` | App Store 链接 | `"https://..."` |
239
-
240
- ## 配套 SDK
241
-
242
- 配合 `@tencent/playable-sdk` 使用:
243
-
244
- ```bash
245
- tnpm install @tencent/playable-sdk
246
- ```
247
-
248
- ```javascript
249
- import { sdk } from '@tencent/playable-sdk';
250
-
251
- sdk.init((width, height) => {
252
- new Game(width, height);
253
- });
254
-
255
- sdk.start(); // 游戏开始
256
- sdk.finish(); // 游戏结束
257
- sdk.install(); // 跳转商店
258
- ```
259
-
260
- ## 许可证
261
-
262
- MIT License