From c9c263dc43ad90f95f24a036cee9e6b47afb596c Mon Sep 17 00:00:00 2001 From: skyouc Date: 星期六, 21 十二月 2024 18:44:20 +0800 Subject: [PATCH] 新建盐城德森项目 --- uni_modules/uni-upgrade-center-app/readme.md | 240 ++++++++++++++++++++++++++++++------------------------------ 1 files changed, 120 insertions(+), 120 deletions(-) diff --git a/uni_modules/uni-upgrade-center-app/readme.md b/uni_modules/uni-upgrade-center-app/readme.md index fa102c9..ee39e49 100644 --- a/uni_modules/uni-upgrade-center-app/readme.md +++ b/uni_modules/uni-upgrade-center-app/readme.md @@ -1,121 +1,121 @@ -# uni-upgrade-center - App - -### 姒傝堪 - -> 缁熶竴绠$悊App鍙夾pp鍦╜Android`銆乣iOS`骞冲彴涓奰App瀹夎鍖卄鍜宍wgt璧勬簮鍖卄鐨勫彂甯冨崌绾� - -> 鏈彃浠朵负uni鍗囩骇涓績瀹㈡埛绔鏌ユ洿鏂帮紝鍚庡彴绠$悊绯荤粺璇风偣鍑绘煡鐪� [uni-upgrade-center - Admin](https://ext.dcloud.net.cn/plugin?id=4470) - -### uni鍗囩骇涓績 - 瀹㈡埛绔鏌ユ洿鏂版彃浠� - - 涓�閿紡妫�鏌ユ洿鏂帮紝鍚屾椂鏀寔鏁村寘鍗囩骇涓巜gt璧勬簮鍖呮洿鏂� - - 濂界湅銆佸疄鐢ㄣ�佸彲鑷畾涔夌殑瀹㈡埛绔彁绀烘 - -## 瀹夎鎸囧紩 - -1. 渚濊禆鏁版嵁搴揱opendb-app-versions`锛屽鏋滄病鏈夋搴擄紝璇峰湪浜戞湇鍔$┖闂翠腑鍒涘缓銆� - -2. 浣跨敤`HBuilderX 3.1.0+`锛屽洜涓鸿浣跨敤鍒癭uni_modules` - -3. 鍦ㄦ彃浠跺競鍦烘墦寮�鏈彃浠堕〉闈紝鍦ㄥ彸渚х偣鍑籤浣跨敤 HBuilderX 瀵煎叆鎻掍欢`锛岄�夋嫨瑕佸鍏ョ殑椤圭洰鐐瑰嚮纭畾 - -4. 缁戝畾涓�涓湇鍔$┖闂� - -5. 鎵惧埌`/uni_modules/uni-upgrade-center-app/uniCloud/cloudfunctions/check-version`锛屽彸閿笂浼犻儴缃� - -6. 鍦╜pages.json`涓坊鍔犻〉闈㈣矾寰勩��**娉細璇蜂笉瑕佽缃负pages.json涓涓�椤�** -```json -"pages": [ - // 鈥︹�﹀叾浠栭〉闈㈤厤缃� - { - "path": "uni_modules/uni-upgrade-center-app/pages/upgrade-popup", - "style": { - "disableScroll": true, - "app-plus": { - "backgroundColorTop": "transparent", - "background": "transparent", - "titleNView": false, - "scrollIndicator": false, - "popGesture": "none", - "animationType": "fade-in", - "animationDuration": 200 - - } - } - } -] -``` - -7. 灏哷@/uni_modules/uni-upgrade-center-app/utils/check-update`import鍒伴渶瑕佺敤鍒扮殑鍦版柟锛岃皟鐢ㄤ竴涓嬪嵆鍙� - -8. 鍗囩骇寮规鍙嚜琛岀紪鍐欙紝涔熷彲浠ヤ娇鐢╜uni.showModal`锛屾垨浣跨敤鐜版湁鐨勫崌绾у脊妗嗘牱寮忥紝濡傛灉涓嶆弧瓒砋I闇�姹傝鑷鏇挎崲璧勬簮鏂囦欢銆傚湪`utils/check-update.js`涓兘鏈夊疄渚嬨�� - -9. wgt鏇存柊鏃讹紝鎵撳寘鍓嶈鍔″繀灏唌anifest.json涓殑鐗堟湰淇敼涓烘洿楂樼増鏈�� - -### 鏇存柊涓嬭浇瀹夎`check-update.js` - -*璇ュ嚱鏁板湪utils鐩綍涓�* - -1. 濡傛灉鏄潤榛樻洿鏂帮紝鍒欎笉浼氭墦寮�鏇存柊寮规锛屼細鍦ㄥ悗鍙颁笅杞藉悗瀹夎锛屼笅娆″惎鍔ㄥ簲鐢ㄧ敓鏁� - -2. 濡傛灉鏄� iOS锛屽垯浼氱洿鎺ユ墦寮�AppStore鐨勯摼鎺� - -3. 鍏朵粬鎯呭喌锛屼細灏哷check-version`杩斿洖鐨勭粨鏋滀繚瀛樺湪localStorage涓紝骞惰烦杞繘鍏upgrade-popup.vue`鎵撳紑鏇存柊寮规 - -### 妫�鏌ユ洿鏂板嚱鏁癭check-version` - -*璇ュ嚱鏁板湪uniCloud/cloudfunctions鐩綍涓�* - -1. 浣跨敤妫�鏌ユ洿鏂伴渶瑕佷紶閫掍笁涓弬鏁� `appid`銆乣appVersion`銆乣wgtVersion` - -2. `appid` 浣跨敤 plus.runtime.appid 鑾峰彇锛�*娉細鐪熸満杩愯鏃朵负鍥哄畾鍊糎Builder锛屽湪璋冭瘯鐨勬椂鍊欒浣跨敤鏈湴璋冭瘯浜戝嚱鏁�* - -3. `appVersion` 浣跨敤 plus.runtime.version 鑾峰彇 - -4. `wgtVersion` 浣跨敤 plus.runtime.getProperty(plus.runtime.appid,(wgtInfo) => { wgtInfo.version }) 鑾峰彇 - -5. `check-version`浜戝嚱鏁板唴閮ㄤ細鑷姩鑾峰彇 App 骞冲彴 - - -**Tips** - -1. `check-version`浜戝嚱鏁板唴閮ㄦ湁鐗堟湰瀵规瘮鍑芥暟锛坈ompare锛夈�� - - 浣跨敤澶氭寮忕増鏈牸寮忥紙濡傦細"3.0.0.0.0.1.0.1", "3.0.0.0.0.1"锛夈�傚鏋滀笉婊¤冻瀵规瘮瑙勫垯锛岃鑷淇敼銆� - - 濡傛灉淇敼锛岃灏�*pages/upgrade-popup.vue*涓�*compare*鍑芥暟涓�骞朵慨鏀� - -## 椤圭洰浠g爜璇存槑 - -### 鏇存柊寮规 -- `upgrade-popup.vue` - 鏇存柊搴旂敤锛� - - 濡傛灉浜戝嚱鏁癭check-version`杩斿洖鐨勫弬鏁拌〃鏄庨渶瑕佹洿鏂帮紝鍒欏皢鍙傛暟淇濆瓨鍦╨ocalStorage涓紝甯︾潃閿�艰烦杞椤甸潰 - - 杩涘叆鏃朵細鍏堜粠localStorage涓皾璇曞彇鍑轰箣鍓嶅瓨鐨勫畨瑁呭寘璺緞锛堟鍖呬笉浼氭槸寮哄埗瀹夎绫诲瀷鐨勫寘锛� - - 濡傛灉鏈夊凡缁忎繚瀛樼殑鍖咃紝鍒欏拰浼犺繘鏉ョ殑 `version` 杩涜姣旇緝锛屽鏋滅浉绛夊垯瀹夎銆傚ぇ浜庡拰灏忎簬閮戒笉杩涜瀹夎锛屽洜涓篴dmin绔彲鑳戒細璋冩暣鍖呯殑鐗堟湰銆備笉绗﹀悎鏇存柊浼氬皢姝ゅ寘鍒犻櫎 - - 濡傛灉鏈湴娌℃湁鍖呮垨鑰呭寘涓嶇鍚堝畨瑁呮潯浠讹紝鍒欒繘琛屼笅杞藉畨瑁呭寘 - - 鐐瑰嚮涓嬭浇浼氭湁杩涘害鏉°�佸凡涓嬭浇澶у皬鍜屼笅杞藉寘鐨勫ぇ灏� - - 涓嬭浇瀹屾垚浼氭彁绀哄畨瑁咃細 - - 濡傛灉鏄� wgt 鍖咃紝瀹夎鏃跺垯浼氭彁绀� 姝e湪瀹夎鈥︹�� 鍜� 瀹夎瀹屾垚銆傚畨瑁呭畬鎴愪細鎻愮ず鏄惁閲嶅惎 - - 濡傛灉鏄� 鍘熺敓瀹夎鍖咃紝鍒欑洿鎺ヨ烦鍑哄幓瑕嗙洊瀹夎 - - 涓嬭浇杩囩▼涓紝濡傛灉閫�鍑轰細鎻愮ず鏄惁鍙栨秷涓嬭浇銆傚鏋滄槸寮哄埗鏇存柊锛屽垯鍙細鎻愮ず姝e湪涓嬭浇璇风◢鍚庯紝姝ゆ椂涓嶅彲閫�鍑� - - 濡傛灉鏄笅杞藉畬鎴愪簡娌℃湁瀹夎灏遍��鍑猴紝鍒欎細灏嗕笅杞藉畬鎴愮殑鍖呬繚瀛樺湪鏈湴銆傚皢鍖呯殑鏈湴璺緞鍜屽寘version淇濆瓨鍦╨ocalStorage涓� - -### 宸ュ叿绫� utils -- `call-check-version` - - 璇锋眰浜戝嚱鏁癭check-version`鎷垮彇鐗堟湰妫�娴嬬粨鏋� -- `check-update` - - 璋冪敤`call-check-version`骞舵牴鎹粨鏋滃垽鏂槸鍚︽樉绀烘洿鏂板脊妗� - -### 浜戝嚱鏁� -- `check-version` - 妫�鏌ュ簲鐢ㄦ洿鏂帮細 - - 鏍规嵁浼犲弬锛屽厛妫�娴嬩紶鍙傛槸鍚﹀畬鏁达紝appid appVersion wgtVersion 蹇呬紶 - - 鍏堜粠鏁版嵁搴撳彇鍑烘墍鏈夎骞冲彴锛堜細浠庝笂涓嬫枃璇诲彇骞冲彴淇℃伅锛夌殑鎵�鏈夌嚎涓婂彂琛屾洿鏂� - - 鍐嶄粠鎵�鏈夌嚎涓婂彂琛屾洿鏂颁腑鍙栧嚭鐗堟湰鏈�澶х殑涓�鐗堛�傚鏋滃彲浠ワ紝灏介噺鍏堟娴媤gt鐨勭嚎涓婂彂琛岀増鏇存柊 - - 浣跨敤涓婁竴姝ュ彇鍑虹殑鐗堟湰鍖呯殑鐗堟湰鍙� 鍜屼紶鍙� appVersion銆亀gtVersion 鏉ユ娴嬫槸鍚︽湁鏇存柊銆傚繀椤诲悓鏃跺ぇ浜庤繖涓ら」锛屽洜涓轰笂涓�娆″彲鑳芥槸wgt鐑洿鏂帮紝鍚﹀垯杩斿洖鏆傛棤鏇存柊 - - 濡傛灉搴撲腑 wgt鍖� 鐗堟湰澶т簬浼犲弬 appVersion锛屼絾鏄笉婊¤冻 min_uni_version < appVersion锛屽垯涓嶄細浣跨敤wgt鏇存柊锛屼細鎺ョ潃鍒ゆ柇搴撲腑 app鍖卾ersion 鏄惁澶т簬 appVersion - - 杩斿洖缁撴灉锛� - - |code|message| - |:-:|:-:| - |0|褰撳墠鐗堟湰宸茬粡鏄渶鏂扮殑锛屼笉闇�瑕佹洿鏂皘 - |101|wgt鏇存柊| - |102|鏁村寘鏇存柊| - |-101|鏆傛棤鏇存柊鎴栨鏌ppid鏄惁濉啓姝g‘| +# uni-upgrade-center - App + +### 姒傝堪 + +> 缁熶竴绠$悊App鍙夾pp鍦╜Android`銆乣iOS`骞冲彴涓奰App瀹夎鍖卄鍜宍wgt璧勬簮鍖卄鐨勫彂甯冨崌绾� + +> 鏈彃浠朵负uni鍗囩骇涓績瀹㈡埛绔鏌ユ洿鏂帮紝鍚庡彴绠$悊绯荤粺璇风偣鍑绘煡鐪� [uni-upgrade-center - Admin](https://ext.dcloud.net.cn/plugin?id=4470) + +### uni鍗囩骇涓績 - 瀹㈡埛绔鏌ユ洿鏂版彃浠� + - 涓�閿紡妫�鏌ユ洿鏂帮紝鍚屾椂鏀寔鏁村寘鍗囩骇涓巜gt璧勬簮鍖呮洿鏂� + - 濂界湅銆佸疄鐢ㄣ�佸彲鑷畾涔夌殑瀹㈡埛绔彁绀烘 + +## 瀹夎鎸囧紩 + +1. 渚濊禆鏁版嵁搴揱opendb-app-versions`锛屽鏋滄病鏈夋搴擄紝璇峰湪浜戞湇鍔$┖闂翠腑鍒涘缓銆� + +2. 浣跨敤`HBuilderX 3.1.0+`锛屽洜涓鸿浣跨敤鍒癭uni_modules` + +3. 鍦ㄦ彃浠跺競鍦烘墦寮�鏈彃浠堕〉闈紝鍦ㄥ彸渚х偣鍑籤浣跨敤 HBuilderX 瀵煎叆鎻掍欢`锛岄�夋嫨瑕佸鍏ョ殑椤圭洰鐐瑰嚮纭畾 + +4. 缁戝畾涓�涓湇鍔$┖闂� + +5. 鎵惧埌`/uni_modules/uni-upgrade-center-app/uniCloud/cloudfunctions/check-version`锛屽彸閿笂浼犻儴缃� + +6. 鍦╜pages.json`涓坊鍔犻〉闈㈣矾寰勩��**娉細璇蜂笉瑕佽缃负pages.json涓涓�椤�** +```json +"pages": [ + // 鈥︹�﹀叾浠栭〉闈㈤厤缃� + { + "path": "uni_modules/uni-upgrade-center-app/pages/upgrade-popup", + "style": { + "disableScroll": true, + "app-plus": { + "backgroundColorTop": "transparent", + "background": "transparent", + "titleNView": false, + "scrollIndicator": false, + "popGesture": "none", + "animationType": "fade-in", + "animationDuration": 200 + + } + } + } +] +``` + +7. 灏哷@/uni_modules/uni-upgrade-center-app/utils/check-update`import鍒伴渶瑕佺敤鍒扮殑鍦版柟锛岃皟鐢ㄤ竴涓嬪嵆鍙� + +8. 鍗囩骇寮规鍙嚜琛岀紪鍐欙紝涔熷彲浠ヤ娇鐢╜uni.showModal`锛屾垨浣跨敤鐜版湁鐨勫崌绾у脊妗嗘牱寮忥紝濡傛灉涓嶆弧瓒砋I闇�姹傝鑷鏇挎崲璧勬簮鏂囦欢銆傚湪`utils/check-update.js`涓兘鏈夊疄渚嬨�� + +9. wgt鏇存柊鏃讹紝鎵撳寘鍓嶈鍔″繀灏唌anifest.json涓殑鐗堟湰淇敼涓烘洿楂樼増鏈�� + +### 鏇存柊涓嬭浇瀹夎`check-update.js` + +*璇ュ嚱鏁板湪utils鐩綍涓�* + +1. 濡傛灉鏄潤榛樻洿鏂帮紝鍒欎笉浼氭墦寮�鏇存柊寮规锛屼細鍦ㄥ悗鍙颁笅杞藉悗瀹夎锛屼笅娆″惎鍔ㄥ簲鐢ㄧ敓鏁� + +2. 濡傛灉鏄� iOS锛屽垯浼氱洿鎺ユ墦寮�AppStore鐨勯摼鎺� + +3. 鍏朵粬鎯呭喌锛屼細灏哷check-version`杩斿洖鐨勭粨鏋滀繚瀛樺湪localStorage涓紝骞惰烦杞繘鍏upgrade-popup.vue`鎵撳紑鏇存柊寮规 + +### 妫�鏌ユ洿鏂板嚱鏁癭check-version` + +*璇ュ嚱鏁板湪uniCloud/cloudfunctions鐩綍涓�* + +1. 浣跨敤妫�鏌ユ洿鏂伴渶瑕佷紶閫掍笁涓弬鏁� `appid`銆乣appVersion`銆乣wgtVersion` + +2. `appid` 浣跨敤 plus.runtime.appid 鑾峰彇锛�*娉細鐪熸満杩愯鏃朵负鍥哄畾鍊糎Builder锛屽湪璋冭瘯鐨勬椂鍊欒浣跨敤鏈湴璋冭瘯浜戝嚱鏁�* + +3. `appVersion` 浣跨敤 plus.runtime.version 鑾峰彇 + +4. `wgtVersion` 浣跨敤 plus.runtime.getProperty(plus.runtime.appid,(wgtInfo) => { wgtInfo.version }) 鑾峰彇 + +5. `check-version`浜戝嚱鏁板唴閮ㄤ細鑷姩鑾峰彇 App 骞冲彴 + + +**Tips** + +1. `check-version`浜戝嚱鏁板唴閮ㄦ湁鐗堟湰瀵规瘮鍑芥暟锛坈ompare锛夈�� + - 浣跨敤澶氭寮忕増鏈牸寮忥紙濡傦細"3.0.0.0.0.1.0.1", "3.0.0.0.0.1"锛夈�傚鏋滀笉婊¤冻瀵规瘮瑙勫垯锛岃鑷淇敼銆� + - 濡傛灉淇敼锛岃灏�*pages/upgrade-popup.vue*涓�*compare*鍑芥暟涓�骞朵慨鏀� + +## 椤圭洰浠g爜璇存槑 + +### 鏇存柊寮规 +- `upgrade-popup.vue` - 鏇存柊搴旂敤锛� + - 濡傛灉浜戝嚱鏁癭check-version`杩斿洖鐨勫弬鏁拌〃鏄庨渶瑕佹洿鏂帮紝鍒欏皢鍙傛暟淇濆瓨鍦╨ocalStorage涓紝甯︾潃閿�艰烦杞椤甸潰 + - 杩涘叆鏃朵細鍏堜粠localStorage涓皾璇曞彇鍑轰箣鍓嶅瓨鐨勫畨瑁呭寘璺緞锛堟鍖呬笉浼氭槸寮哄埗瀹夎绫诲瀷鐨勫寘锛� + - 濡傛灉鏈夊凡缁忎繚瀛樼殑鍖咃紝鍒欏拰浼犺繘鏉ョ殑 `version` 杩涜姣旇緝锛屽鏋滅浉绛夊垯瀹夎銆傚ぇ浜庡拰灏忎簬閮戒笉杩涜瀹夎锛屽洜涓篴dmin绔彲鑳戒細璋冩暣鍖呯殑鐗堟湰銆備笉绗﹀悎鏇存柊浼氬皢姝ゅ寘鍒犻櫎 + - 濡傛灉鏈湴娌℃湁鍖呮垨鑰呭寘涓嶇鍚堝畨瑁呮潯浠讹紝鍒欒繘琛屼笅杞藉畨瑁呭寘 + - 鐐瑰嚮涓嬭浇浼氭湁杩涘害鏉°�佸凡涓嬭浇澶у皬鍜屼笅杞藉寘鐨勫ぇ灏� + - 涓嬭浇瀹屾垚浼氭彁绀哄畨瑁咃細 + - 濡傛灉鏄� wgt 鍖咃紝瀹夎鏃跺垯浼氭彁绀� 姝e湪瀹夎鈥︹�� 鍜� 瀹夎瀹屾垚銆傚畨瑁呭畬鎴愪細鎻愮ず鏄惁閲嶅惎 + - 濡傛灉鏄� 鍘熺敓瀹夎鍖咃紝鍒欑洿鎺ヨ烦鍑哄幓瑕嗙洊瀹夎 + - 涓嬭浇杩囩▼涓紝濡傛灉閫�鍑轰細鎻愮ず鏄惁鍙栨秷涓嬭浇銆傚鏋滄槸寮哄埗鏇存柊锛屽垯鍙細鎻愮ず姝e湪涓嬭浇璇风◢鍚庯紝姝ゆ椂涓嶅彲閫�鍑� + - 濡傛灉鏄笅杞藉畬鎴愪簡娌℃湁瀹夎灏遍��鍑猴紝鍒欎細灏嗕笅杞藉畬鎴愮殑鍖呬繚瀛樺湪鏈湴銆傚皢鍖呯殑鏈湴璺緞鍜屽寘version淇濆瓨鍦╨ocalStorage涓� + +### 宸ュ叿绫� utils +- `call-check-version` + - 璇锋眰浜戝嚱鏁癭check-version`鎷垮彇鐗堟湰妫�娴嬬粨鏋� +- `check-update` + - 璋冪敤`call-check-version`骞舵牴鎹粨鏋滃垽鏂槸鍚︽樉绀烘洿鏂板脊妗� + +### 浜戝嚱鏁� +- `check-version` - 妫�鏌ュ簲鐢ㄦ洿鏂帮細 + - 鏍规嵁浼犲弬锛屽厛妫�娴嬩紶鍙傛槸鍚﹀畬鏁达紝appid appVersion wgtVersion 蹇呬紶 + - 鍏堜粠鏁版嵁搴撳彇鍑烘墍鏈夎骞冲彴锛堜細浠庝笂涓嬫枃璇诲彇骞冲彴淇℃伅锛夌殑鎵�鏈夌嚎涓婂彂琛屾洿鏂� + - 鍐嶄粠鎵�鏈夌嚎涓婂彂琛屾洿鏂颁腑鍙栧嚭鐗堟湰鏈�澶х殑涓�鐗堛�傚鏋滃彲浠ワ紝灏介噺鍏堟娴媤gt鐨勭嚎涓婂彂琛岀増鏇存柊 + - 浣跨敤涓婁竴姝ュ彇鍑虹殑鐗堟湰鍖呯殑鐗堟湰鍙� 鍜屼紶鍙� appVersion銆亀gtVersion 鏉ユ娴嬫槸鍚︽湁鏇存柊銆傚繀椤诲悓鏃跺ぇ浜庤繖涓ら」锛屽洜涓轰笂涓�娆″彲鑳芥槸wgt鐑洿鏂帮紝鍚﹀垯杩斿洖鏆傛棤鏇存柊 + - 濡傛灉搴撲腑 wgt鍖� 鐗堟湰澶т簬浼犲弬 appVersion锛屼絾鏄笉婊¤冻 min_uni_version < appVersion锛屽垯涓嶄細浣跨敤wgt鏇存柊锛屼細鎺ョ潃鍒ゆ柇搴撲腑 app鍖卾ersion 鏄惁澶т簬 appVersion + - 杩斿洖缁撴灉锛� + + |code|message| + |:-:|:-:| + |0|褰撳墠鐗堟湰宸茬粡鏄渶鏂扮殑锛屼笉闇�瑕佹洿鏂皘 + |101|wgt鏇存柊| + |102|鏁村寘鏇存柊| + |-101|鏆傛棤鏇存柊鎴栨鏌ppid鏄惁濉啓姝g‘| |-102|璇锋鏌ヤ紶鍙傛槸鍚﹀~鍐欐纭畖 \ No newline at end of file -- Gitblit v1.9.1