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

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 (95) 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/clean-cache.js +5 -179
  15. package/core/engines/cocos/clean-cache.test.js +1 -75
  16. package/core/engines/cocos/cli-build.js +2 -116
  17. package/core/engines/cocos/cli.js +11 -38
  18. package/core/engines/cocos/constants.js +1 -21
  19. package/core/engines/cocos/creator-cli.js +1 -108
  20. package/core/engines/cocos/dev-server.js +4 -412
  21. package/core/engines/cocos/fs.js +1 -105
  22. package/core/engines/cocos/injects/3x/init.js +19 -438
  23. package/core/engines/cocos/injects/3x/main.js +2 -52
  24. package/core/engines/cocos/injects/libs/pako.js +1 -2
  25. package/core/engines/cocos/mcp-refresh.js +2 -76
  26. package/core/engines/cocos/merge.js +3 -148
  27. package/core/engines/cocos/pack.js +1 -187
  28. package/core/engines/cocos/preview-cache.js +2 -48
  29. package/core/engines/cocos/preview-cache.test.js +1 -32
  30. package/core/engines/cocos/preview-concat.js +5 -189
  31. package/core/engines/cocos/preview-concat.test.js +1 -73
  32. package/core/engines/cocos/preview-json-hook.js +1 -200
  33. package/core/engines/cocos/preview-json-pack.js +3 -376
  34. package/core/engines/cocos/preview-json-pack.test.js +2 -226
  35. package/core/engines/cocos/preview-proxy.js +1 -132
  36. package/core/engines/cocos/rebundle-preview.js +2 -54
  37. package/core/engines/cocos/strip-social-share.js +3 -115
  38. package/core/engines/cocos/theme-assets.js +2 -161
  39. package/core/engines/cocos/writable-cli.js +2 -248
  40. package/core/engines/cocos/writable-cli.test.js +1 -112
  41. package/core/engines/web/index.js +1 -20
  42. package/core/engines/web/vite.dev.js +17 -322
  43. package/core/engines/web/webpack.build.js +37 -522
  44. package/core/engines/web/webpack.common.js +11 -177
  45. package/core/engines/web/webpack.dev.js +6 -88
  46. package/core/index.js +7 -101
  47. package/core/injectors/apply.js +1 -94
  48. package/core/injectors/check-channel-matrix.js +2 -130
  49. package/core/injectors/spec.js +9 -217
  50. package/core/loaders/gltf-loader.js +28 -74
  51. package/core/options.js +16 -353
  52. package/core/plugins/AdikteevInjectorPlugin.js +4 -26
  53. package/core/plugins/BigoAdsInjectorPlugin.js +4 -21
  54. package/core/plugins/DAPIInjectorPlugin.js +2 -25
  55. package/core/plugins/DebuggerInjectionPlugin.js +3 -31
  56. package/core/plugins/ExitAPIInjectorPlugin.js +3 -56
  57. package/core/plugins/FflateCompressionPlugin.js +40 -231
  58. package/core/plugins/FontInjectionWebpackPlugin.js +4 -46
  59. package/core/plugins/LiftoffInjectorPlugin.js +4 -26
  60. package/core/plugins/MRAIDInjectorPlugin.js +2 -24
  61. package/core/plugins/MintegralInjectorPlugin.js +2 -25
  62. package/core/plugins/PangleInjectorPlugin.js +2 -24
  63. package/core/plugins/PlaycraftOrientationInjectorPlugin.js +3 -29
  64. package/core/plugins/SnapchatInjectorPlugin.js +4 -26
  65. package/core/plugins/SocialMediaInjectorPlugin.js +7 -119
  66. package/core/plugins/TikTokInjectorPlugin.js +2 -24
  67. package/core/plugins/UnityInjectorPlugin.js +8 -37
  68. package/core/plugins/ZipPlugin.js +20 -154
  69. package/core/plugins/socialMediaVitePlugin.js +2 -108
  70. package/core/utils/buildDefines.js +2 -30
  71. package/core/utils/buildTemplateString.js +5 -39
  72. package/core/utils/date.js +1 -16
  73. package/core/utils/fontRegistry.js +13 -81
  74. package/core/utils/fontResolver.js +37 -335
  75. package/core/utils/generateAdikteevHtmlWebpackPluginConfig.js +7 -42
  76. package/core/utils/generateBigabidHtmlWebpackPluginConfig.js +3 -30
  77. package/core/utils/generateInMobiHtmlWebpackPluginConfig.js +7 -43
  78. package/core/utils/getPlaycraftOrientationSuffix.js +2 -9
  79. package/core/utils/injectSDKPlugins.js +13 -68
  80. package/core/utils/logOptions.js +5 -46
  81. package/core/utils/mergeOptions.js +2 -21
  82. package/core/utils/obfuscateLevels.js +10 -0
  83. package/core/utils/obfuscateLevels.test.js +10 -0
  84. package/core/utils/parseArgvOptions.js +5 -125
  85. package/core/utils/resolveChannelFold2Zip.js +3 -15
  86. package/core/utils/validateThemeData.js +26 -227
  87. package/core/validators/pre-build-checker.js +25 -287
  88. package/core/validators/tracking-validator.js +40 -441
  89. package/core/validators/tracking-validator.test.js +2 -84
  90. package/core/vite.dev.js +1 -1
  91. package/core/webpack.build.js +1 -1
  92. package/core/webpack.common.js +1 -1
  93. package/core/webpack.dev.js +1 -1
  94. package/package.json +2 -3
  95. 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.12",
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