chore: show unadapted components for HarmonyOS in Mini Programs and H5 (#2999)

* chore: 通过 pre 命令在 h5 和小程序预览或构建的时候，去掉鸿蒙适配的限制，从而展示出未适配鸿蒙的组件

* docs: update docs

* docs: update docs

Author: oasis-cloud

README_ZH.md

@@ -71,7 +71,11 @@ pnpm run dev
 
 ```
 
-### 本地运行 Taro 相关的预览
+### 本地运行 Taro 环境
+
+**注意：在 Taro 环境新增 pnpm pre 钩子，用于 H5 或小程序预览时显示未适配鸿蒙的组件，环境变量可通过 predev:taro 命令查看。**
+
+#### 本地运行 Taro 相关的预览
 
 ````sh
 # 克隆仓库
@@ -94,7 +98,7 @@ pnpm dev:taro jd
 # 其他平台 参考 demo 目录中 package.json 的 script
 ````
 
-### 本地运行 JDTaro 相关的预览
+#### 本地运行 JDTaro 相关的预览
 
 1. 仓库根目录下增加 .npmrc 文件，增加如下配置:
 

package.json

@@ -49,7 +49,6 @@
   },
   "scripts": {
     "add": "node scripts/create-component-mode.js && npm run prepare",
-    "add:taro:config": "node scripts/taro/generate-taro-route.js",
     "checked": "npm run generate:file && tsc --project ./tsconfig.h5.json --noEmit",
     "checked:taro": "npm run generate:file:taro && tsc --project ./tsconfig.taro.json --noEmit",
     "changelog": "node ./scripts/generate-changelog.js",
@@ -58,19 +57,22 @@
     "dev:rtl": "VITE_RTL=rtl vite --open --force",
     "dev:jrkf": "VITE_APP_PROJECT_ID=jrkf vite --open --force",
     "dev:taro:rn:dark": "THEME=dark pnpm dev:taro:rn",
-    "dev:taro": "pnpm run update:taro:entry && pnpm --dir ./packages/nutui-taro-demo dev",
+    "predev:taro": "SKIPDD=1 pnpm run update:taro:entry",
+    "dev:taro": "pnpm --dir ./packages/nutui-taro-demo dev",
     "dev:taro:h5": "pnpm dev:taro h5",
-    "dev:jdtaro": "pnpm run update:taro:entry && JD=1 pnpm --dir ./packages/nutui-taro-demo dev",
-    "dev:jdtaro:jdharmonycpp": "pnpm run clone:jdharmony cpp &&pnpm run update:taro:entry && JD=1 pnpm --dir ./packages/nutui-taro-demo dev:jdharmonycpp",
+    "predev:jdtaro": "SKIPDD=1 pnpm run update:taro:entry",
+    "dev:jdtaro": "JD=1 pnpm --dir ./packages/nutui-taro-demo dev",
+    "dev:jdtaro:jdharmonycpp": "pnpm run clone:jdharmony cpp && pnpm run update:taro:entry && JD=1 pnpm --dir ./packages/nutui-taro-demo dev:jdharmonycpp",
     "dev:jdtaro:jdharmony": "pnpm run clone:jdharmony  && pnpm run update:taro:entry && JD=1 pnpm --dir ./packages/nutui-taro-demo dev:jdharmony",
-    "dev:taro:jmapp": "pnpm run update:taro:entry && JD=1 pnpm --dir ./packages/nutui-taro-demo dev:jmapp",
+    "dev:taro:jmapp": "JD=1 pnpm --dir ./packages/nutui-taro-demo dev:jmapp",
     "build": "node ./scripts/replace-css-var.js && npm run checked && node scripts/build.mjs",
     "build:taro": "node ./scripts/replace-css-var.js && npm run checked:taro && node scripts/build-taro.mjs",
     "build:taro:jmapp": "npm run checked:taro && VITE_APP_PROJECT_ID=jmapp node scripts/build-taro.mjs",
     "build:site": "npm run checked && vite build --config vite.config.site.mts",
     "build:site:jmapp": "npm run checked && VITE_APP_PROJECT_ID=jmapp vite build",
-    "build:taro:site": "pnpm update:taro:entry && npm run checked:taro && npm run generate:file:taro:pages && pnpm --dir ./packages/nutui-taro-demo build:h5",
-    "build:jdtaro:site": "pnpm update:taro:entry && npm run checked:taro && npm run generate:file:taro:pages && JD=1 pnpm --dir ./packages/nutui-taro-demo build:h5",
+    "prebuild:taro:site": "SKIPDD=1 pnpm run update:taro:entry",
+    "build:taro:site": "npm run checked:taro && npm run generate:file:taro:pages && pnpm --dir ./packages/nutui-taro-demo build:h5",
+    "build:jdtaro:site": "npm run checked:taro && npm run generate:file:taro:pages && JD=1 pnpm --dir ./packages/nutui-taro-demo build:h5",
     "build:taro:site:jmapp": "npm run checked:taro && VITE_APP_PROJECT_ID=jmapp npm run generate:file:taro:pages && pnpm --dir ./packages/nutui-taro-demo build:h5",
     "build:jdtaro:site:jmapp": "npm run checked:taro && VITE_APP_PROJECT_ID=jmapp npm run generate:file:taro:pages && JD=1 pnpm --dir ./packages/nutui-taro-demo build:h5",
     "generate:file": "node scripts/generate-nutui.js",

scripts/harmony/update-taro-entry.js

@@ -18,7 +18,9 @@ const adaptedArray = []
 config.nav.map((item) => {
   item.packages.forEach((element) => {
     const { name, version, dd } = element
-    if (!dd) return // 未适配不导出
+    // 通过 pre 命令在 h5 和小程序预览或构建的时候，去掉鸿蒙适配的限制，从而在预览H5 和小程序时展示出未适配鸿蒙的组件
+    // 例如 Form 组件未适配鸿蒙但适配了 H5 和小程序，启动 H5或小程序开发环境后，Form 组件并未被编译到开发环境中。导致无法查看 Form 组件。
+    if (!dd && !process.env.SKIPDD) return // 未适配不导出
     if (specialComponent(name)) return
     adaptedArray.push({
       ...element,