From 4a45efcec76cbe047d069aef04e315082ff0775d Mon Sep 17 00:00:00 2001 From: Jacob <hlnie@tohours.com> Date: 星期一, 12 十月 2026 18:04:20 +0800 Subject: [PATCH] Merge branch 'master' into sit --- BAT使用说明.md | 133 ++++++++++++++++++++++++++++++++++++++++++++ 1 files changed, 133 insertions(+), 0 deletions(-) diff --git "a/BAT\344\275\277\347\224\250\350\257\264\346\230\216.md" "b/BAT\344\275\277\347\224\250\350\257\264\346\230\216.md" new file mode 100644 index 0000000..0b2cb61 --- /dev/null +++ "b/BAT\344\275\277\347\224\250\350\257\264\346\230\216.md" @@ -0,0 +1,133 @@ +# 4 涓� bat 浣跨敤璇存槑 + +椤圭洰鏍圭洰褰曚笅 4 涓弻鍑诲嵆鐢ㄧ殑鎵瑰鐞嗭紝鎸夌敤閫斿垎涓ょ被锛� + +| 鎴戞兂鍋氱殑浜� | 鐢ㄥ摢涓� bat | +| --- | --- | +| 鍑哄皬绋嬪簭鍙戣鐗堬紝骞惰嚜鍔ㄥ湪寰俊寮�鍙戣�呭伐鍏烽噷鎵撳紑 | `publish-sit.bat`锛堟祴璇曪級/ `publish-prod.bat`锛堢敓浜э級 | +| 鍦� HBuilderX 閲屻�岃繍琛� 鈫� 杩愯鍒板皬绋嬪簭妯℃嫙鍣ㄣ�嶈皟璇� | 鍏堝垏鐜锛歚switch-sit.bat` / `switch-prod.bat` | + +> 涓�鍙ヨ瘽鍖哄垎锛歚publish-*` 浜у嚭 `unpackage/dist/build/mp-weixin` 鍙戣浜х墿锛岀紪璇戞湡 appid 鐢辫剼鏈敞鍏ワ紝**涓嶆敼浠撳簱閲岀殑浠讳綍鏂囦欢**锛沗switch-*` 鏀圭殑鏄� HBuilderX 鐨勭紪璇戣緭鍏� `manifest.json`锛屼緵 GUI 缂栬瘧/璋冭瘯鐢ㄣ�� + +--- + +## 1. 涓�娆℃�у墠鎻� + +1. Node.js锛堝懡浠よ `node -v` 鍙敤锛� +2. HBuilderX锛堟彁渚涘懡浠よ `cli.exe`锛� +3. 寰俊寮�鍙戣�呭伐鍏凤紝涓� **璁剧疆 鈫� 瀹夊叏璁剧疆 鈫� 鏈嶅姟绔彛 = 寮�鍚�**锛堜笉寮�鏃� `cli.bat open` 浼氬け璐ワ紝鑴氭湰浼氶檷绾ф彁绀轰綘鎵嬪姩瀵煎叆锛� + +**宸ュ叿璺緞涓嶉渶瑕侀厤缃�**锛岃剼鏈寜椤哄簭鑷姩鏌ユ壘锛屽懡涓悗鎶婃墍鍦ㄧ洰褰曞姞鍏ユ湰娆¤繘绋嬬殑 `PATH`锛堜究浜庢寜鍚嶅瓧鐩存帴璋冪敤锛夛細 + +1. 鐜鍙橀噺 `HBUILDERX_CLI` / `WX_DEVTOOLS_CLI` +2. 绯荤粺 `PATH` +3. 甯歌瀹夎鐩綍锛坄Program Files`銆乣Program Files (x86)`銆佺敤鎴风洰褰曘�佹闈€�佷笅杞姐�佸悇纾佺洏甯歌杞欢鐩綍鈥︼級 +4. 纾佺洏娴呭眰鎵弿锛堚墹2 灞傦紝鍙壂鏈湴鍥哄畾纾佺洏锛岃烦杩囩郴缁熺洰褰曪級 + +鎵句笉鍒版椂鐩存帴鎶ラ敊骞剁粰鍑哄姙娉曪細 + +```bat +set PATH=%PATH%;<HBuilderX 鎴� 寰俊寮�鍙戣�呭伐鍏� 鐨勫畨瑁呯洰褰�> +set HBUILDERX_CLI=<HBuilderX cli.exe 瀹屾暣璺緞> +set WX_DEVTOOLS_CLI=<寰俊寮�鍙戣�呭伐鍏� cli.bat 瀹屾暣璺緞> +``` + +--- + +## 2. publish-sit.bat / publish-prod.bat + +鍙屽嚮 = 鍙戣骞惰嚜鍔ㄦ墦寮�銆傚疄闄呮墽琛� 4 姝ワ細 + +| 姝ラ | 鍋氫粈涔� | 鍏蜂綋鍛戒护 | +| --- | --- | --- | +| 0 | 鐢熸垚 `manifest.json`锛堟ā鏉� `manifest.json.demo` + 璇ョ幆澧� appid锛� | 鍐呯疆閫昏緫 | +| 1 | HBuilderX CLI 鍙戣缂栬瘧 | `cli.exe publish --platform mp-weixin --project <椤圭洰鏍�>` | +| 2 | 鍥炲啓浜х墿 appid锛堝厹搴曟牎姝ｏ級 | 鍐欏叆 `unpackage/dist/build/mp-weixin/project.config.json` | +| 3 | 寰俊寮�鍙戣�呭伐鍏� CLI 鎵撳紑浜х墿 | `cli.bat open --project <浜х墿鐩綍>` | + +- 鍙戣浜х墿锛歚unpackage/dist/build/mp-weixin` +- 缂栬瘧鏃ュ織鍦� **HBuilderX 鎺у埗鍙�**閲岀湅 +- 浠讳竴姝ュけ璐ワ紝绐楀彛浼氭墦鍗� `[FAILED] ...`锛堥��鍑虹爜闈� 0锛� + +### 鍙姞鐨勫弬鏁帮紙`%*` 鍘熸牱浼犵粰 `scripts/publish.js`锛� + +| 鍙傛暟 | 浣滅敤 | +| --- | --- | +| `--dry-run` | 鍙墦鍗板皢瑕佹墽琛岀殑鍛戒护锛屼笉鍋氫换浣曞啓鎿嶄綔 | +| `--no-open` | 鍙紪璇戯紝涓嶆墦寮�寰俊寮�鍙戣�呭伐鍏凤紙姝ょ鎯呭喌涓嶈姹傚畨瑁呭紑鍙戣�呭伐鍏凤級 | +| `--no-gen` | 璺宠繃鐢熸垚 `manifest.json`锛堣姹傚畠宸插瓨鍦紱閫傚悎浣犳墜宸ョ淮鎶� manifest 鐨勫満鏅級 | +| 鍏朵粬鍙傛暟 | 鍘熸牱閫忎紶缁� HBuilderX cli | + +鐢ㄦ硶绀轰緥锛堝湪鍛戒护琛岀獥鍙ｉ噷锛夛細 + +```bat +publish-sit.bat --dry-run +publish-prod.bat --no-open +``` + +绛変环鍛戒护锛歚npm run release:sit` / `npm run release:prod` / `node scripts/publish.js sit` + +--- + +## 3. switch-sit.bat / switch-prod.bat + +鍙屽嚮 = 鎸夎鐜閲嶆柊鐢熸垚 `manifest.json`锛坄manifest.json.demo` + 璇ョ幆澧� appid锛夈�� + +- 绛変环鍛戒护锛歚npm run env:sit` / `npm run env:prod` / `node scripts/set-env.js sit` +- **鍒囧畬蹇呴』鍋氫袱浠朵簨**锛氣憼 鍦� HBuilderX 閲岄噸鏂扮紪璇戜竴娆★紱鈶� 鍦ㄥ井淇″紑鍙戣�呭伐鍏烽噷閲嶆柊鎵撳紑璇ラ」鐩紙appid 鍙樻洿闇�閲嶅紑锛� +- 骞傜瓑锛氬唴瀹瑰凡涓�鑷存椂鎻愮ず銆屾棤闇�閲嶅啓銆嶏紝鍙斁蹇冮噸澶嶅弻鍑� +- 閫傜敤鍦烘櫙锛氬湪 HBuilderX GUI 閲岀洿鎺ヨ繍琛�/璋冭瘯锛堢紪璇戞湡 appid 鍙栬嚜 `manifest.json`锛夛紝鎴栭渶瑕佸嚭 App 鍖咃紙椤跺眰 DCloud appid锛� + +### 涓や釜鐜鐨勫彇鍊� + +| 鐜 | 灏忕▼搴� appid锛坄mp-weixin.appid`锛� | DCloud appid锛堥《灞傦級 | 鎺ュ彛鍦板潃 | +| --- | --- | --- | --- | +| sit | `wx7e443c60d08449de` | `__UNI__3D0C5FE` | `https://sit.tohours.com/crmeb/front` | +| prod | `wx15d029cdf2e92a9f` | `__UNI__CE0C605` | `https://acmall.bluedeer.com.cn/crmeb/front` | + +鏁版嵁婧愶細`config/env/sit.js`銆乣config/env/prod.js`锛堝敮涓�鏁版嵁婧愶紝鏀硅繖涓ゅ鍗冲彲锛屼袱涓枃浠堕敭鍚嶄繚鎸佷竴鑷达級銆� + +--- + +## 4. 涓轰粈涔堣窇瀹� git 鏄共鍑�鐨� + +`manifest.json` 鏄�**鐢熸垚鐗�**锛宍project.config.json` 涓� `unpackage/` 宸插拷鐣ワ細 + +``` +manifest.json.demo锛堝叆搴擄紝妯℃澘锛� 鈹�鈹�娉ㄥ叆鐜 appid鈹�鈹�鈻� manifest.json锛堝凡蹇界暐锛屼笉鍏ュ簱锛� +``` + +鎵�浠ュ彂琛屻�佸垏鐜閮戒笉浼氫骇鐢� git 鏀瑰姩锛宍git status` 鍙細鏈変綘鑷繁鏀圭殑婧愮爜銆� + +涓ょ偣娉ㄦ剰锛� + +1. 鏂� clone 鐨勬満鍣�**娌℃湁 `manifest.json`锛孒BuilderX 鎵撲笉寮�椤圭洰** 鈥斺�� 鍏堣窇涓�娆� `switch-sit.bat`锛堟垨浠绘剰 `publish-*.bat`锛夋妸瀹冪敓鎴愬嚭鏉ャ�� +2. 鍦� HBuilderX GUI 閲岀洿鎺ユ敼鐨� manifest 閰嶇疆钀藉湪**鐢熸垚鐗�**涓婏紝涓嬫鐢熸垚浼氳妯℃澘鍐呭瑕嗙洊锛堣剼鏈細鎵撳嵃璀﹀憡锛夈�傞渶瑕侀暱鏈熶繚鐣欑殑鏀瑰姩锛岃鍐欒繘 `manifest.json.demo`銆� + +--- + +## 5. 鎺ュ彛鍦板潃涓轰粈涔堣嚜鍔ㄥ寰椾笂 + +`config/env/index.js` 鐨勮瘑鍒『搴忥細鎵嬪姩 `OVERRIDE_ENV` > 灏忕▼搴� appid 鑷姩璇嗗埆 > H5 鍩熷悕璇嗗埆 > 榛樿 prod锛屽澶栧鍑� `ENV_NAME` / `IS_SIT` / `IS_PROD`銆� + +涔熷氨鏄�岀敤鍝釜 appid 缂栬瘧銆嶅氨绛変簬銆岀敤鍝鎺ュ彛銆嶏紝涓嶄細鍑虹幇鎺ュ彛涓庣幆澧冮敊閰� 鈥斺�� 浣犲彧闇�瑕侀�夊 bat銆� + +--- + +## 6. 甯歌闂 + +| 鐜拌薄 | 澶勭悊 | +| --- | --- | +| 绐楀彛鎶� `'鈥�' is not recognized as an internal or external command` 涓斿甫涓枃涔辩爜 | bat 鍐呮贩鐢� UTF-8 涓枃鏃讹紝cmd 鎸変唬鐮侀〉瑙ｆ瀽浼氶敊浣嶃�傜幇鍦� 4 涓� bat **鍏ㄩ儴鏄� ASCII**锛屼腑鏂囨彁绀虹敱 Node 鎵撳嵃銆傝嚜宸辨敼 bat 鏃朵笉瑕佸姞涓枃锛岃鍔犲氨鐢� Node 杈撳嚭 | +| `鏈壘鍒� HBuilderX 鍛戒护琛� cli.exe` / `鏈壘鍒板井淇″紑鍙戣�呭伐鍏峰懡浠よ cli.bat` | 鎸夋姤閿欓噷鐨勪袱绉嶅姙娉曞鐞嗭細鍔� `PATH` 鎴栬瀵瑰簲鐜鍙橀噺锛堣绗� 1 鑺傦級 | +| 鑷姩鎵撳紑澶辫触锛屾彁绀烘湭寮�鍚湇鍔＄鍙� | 寮�鍙戣�呭伐鍏� 鈫� 璁剧疆 鈫� 瀹夊叏璁剧疆 鈫� 鎵撳紑鏈嶅姟绔彛锛涙垨鎵嬪姩銆屽鍏ラ」鐩�嶉�� `unpackage\dist\build\mp-weixin` | +| 寮�鍙戣�呭伐鍏烽噷 appid 杩樻槸鏃х殑 | appid 鍙樻洿鍚庨渶瑕佸湪宸ュ叿閲�**閲嶆柊鎵撳紑**璇ラ」鐩� | +| `--no-gen 闇�瑕� manifest.json 宸插瓨鍦╜ | 鍏堣窇涓�娆� `switch-*.bat`锛屾垨鍘绘帀 `--no-gen` | +| `cli.exe 閫�鍑虹爜 鈥 | 缂栬瘧澶辫触锛岀湅 HBuilderX 鎺у埗鍙伴噷鐨勫叿浣撴姤閿� | + +--- + +## 7. 闄勬敞 + +- 4 涓� bat 閮戒細鍏� `cd /d "%~dp0"`锛屾墍浠ュ湪浠绘剰鐩綍鍙屽嚮鎴栧懡浠よ璋冪敤閮戒笉浼氳窇閿欎綅缃紱鏈熬 `pause` 鏂逛究鍙屽嚮鍚庢煡鐪嬭緭鍑恒�� +- 寰俊寮�鍙戣�呭伐鍏风敓鎴愮殑 `project.private.config.json` 鐩墠浠嶅叆搴擄紙鏈蹇界暐锛夈�傝嫢鎯宠繛瀹冧竴璧峰仛鍒伴浂鍣煶锛屽彲鑷鍔犲叆 `.gitignore` 骞舵墽琛� `git rm --cached project.private.config.json`銆� -- Gitblit v1.4.0