Browse Source

update readme

liuyuqi-cnb 3 weeks ago
parent
commit
71321cd863
1 changed files with 57 additions and 2 deletions
  1. 57 2
      README.md

+ 57 - 2
README.md

@@ -1,8 +1,63 @@
 # Taro
 
-基于 React Navite ,支持国内 小程序,h5,安卓,ios 应用。
+基于 React Navite (可使用React/Vue/Nerv),支持国内 小程序,h5,安卓,ios 应用。
 
+Taro 的核心分为编译时(Compile Time)和运行时(Runtime):
+1. 编译时:利用 Babel/TypeScript 将源代码转换为各平台的合法指令。
+2. 运行时:提供一套适配层,模拟浏览器的 DOM/BOM API,使得 Web
+    框架(React/Vue)能直接运行在小程序环境。
+
+## Develop
+
+```
+docker run --rm -it -w /app -v $(pwd):/app node:22 /bin/bash
+npm install -g @tarojs/cli
+taro init myApp
+
+# 微信小程序
+cd myApp
+npm install
+yarn add @tarojs/plugin-platform-h5
+
+
+npm run dev:weapp
+npm run build:weapp
+npm run build:harmony-hybrid
+npm run build:jd
+npm run build:alipay
+npm run build:h5
+
+
+# react navite 打包ios,安卓app
+npm install @tarojs/rn-runner
+npm run dev:rn
+npm run build:rn
+
+
+```
+
+项目结构:
+
+ ├── config                 # 项目编译配置
+ │   ├── dev.js             # 开发环境配置
+ │   ├── index.js           # 默认配置
+ │   └── prod.js            # 生产环境配置
+ ├── src                    # 源码目录
+ │   ├── pages              # 页面文件
+ │   ├── app.config.ts      # 全局配置文件 (路由、窗口表现)
+ │   └── app.ts             # 项目入口文件
+ └── package.json
+
+
+  4. 开发建议
+   * 跨端差异处理:当需要针对特定平台编写代码时,可使用环境变量
+     process.env.TARO_ENV(取值:weapp / h5 / rn 等)或使用 .weapp.js /
+     .h5.js 这种特定后缀来实现条件编译。
+   * UI 库推荐:
+       * React 栈:Taro UI
+       * Vue 栈:NutUI (京东风格) 或 Vant Weapp (需配置适配)
 
 ## Reference
 
-- [docs.taro](https://docs.taro.zone/docs/react-native#%E7%AE%80%E4%BB%8B)
+- [docs.taro](https://docs.taro.zone/docs/react-native#%E7%AE%80%E4%BB%8B)
+