91 lines
4.1 KiB
Markdown
91 lines
4.1 KiB
Markdown
# 智链云枢管理系统移动端
|
||
|
||
基于 `uni-app` 的 `vite` + `vue3` + `tailwindcss` 开发。
|
||
|
||
## 特性
|
||
|
||
- ⚡️ [Vue 3](https://github.com/vuejs/core), [Vite](https://github.com/vitejs/vite), [pnpm](https://pnpm.io/) - 快 & 稳定
|
||
|
||
- 🎨 [TailwindCSS](https://tailwindcss.com/) - 世界上最流行，生态最好的原子化CSS框架
|
||
|
||
- 😃 [集成 Iconify](https://github.com/egoist/tailwindcss-icons) - [icones.js.org](https://icones.js.org/) 中的所有图标都为你所用
|
||
|
||
- 📥 [API 自动加载](https://github.com/antfu/unplugin-auto-import) - 直接使用 Composition API 无需引入
|
||
|
||
- 🧬 [uni-app 条件编译样式](https://tw.icebreaker.top/docs/quick-start/uni-app-css-macro) - 帮助你在多端更灵活的使用 `TailwindCSS`
|
||
|
||
- 🦾 [TypeScript](https://www.typescriptlang.org/) & [ESLint](https://eslint.org/) & [Stylelint](https://stylelint.io/) - 样式，类型，统一的校验与格式化规则，保证你的代码风格和质量
|
||
|
||
## 快速开始
|
||
|
||
> [!IMPORTANT]
|
||
> 推荐使用 `"node": "^20.19.0 || >=22.12.0"` 的 Node.js 版本进行开发!
|
||
>
|
||
> 另外谨慎升级 `package.json` 中锁定的 `pinia`/`vue`/`@vue/*` 相关包的版本，新版本可能 `uni-app` 没有兼容，造成一些奇怪的 bug
|
||
|
||
### 配置 PDA 后端地址
|
||
|
||
PDA 默认请求本机 `http://localhost:9099`，仅适用于后端运行在同一设备的本地开发。部署到独立 PDA 或局域网服务器时，在构建环境注入 `VITE_APP_BASE_API`：
|
||
|
||
```bash
|
||
VITE_APP_BASE_API=http://<服务器地址>:9099 pnpm run build:h5
|
||
```
|
||
|
||
不要把包含真实凭据的环境文件或地址配置提交到仓库。
|
||
|
||
PDA 测试模式、批次授权和失效回退规则请阅读[测试数据批次操作说明](../shierfeng-fastapi-backend/sql/test-data-batch-operations.md)。PDA 只允许选择后端返回的 ACTIVE 授权批次，退出登录会清除本地批次上下文。
|
||
|
||
### vscode
|
||
|
||
使用 `vscode` 的开发者，请先安装 [Tailwind CSS IntelliSense](https://marketplace.visualstudio.com/items?itemName=bradlc.vscode-tailwindcss) 智能提示与感应插件
|
||
|
||
其他 IDE 请参考: <https://tw.icebreaker.top/docs/quick-start/intelliSense>
|
||
|
||
### 更换 Appid
|
||
|
||
把 `src/manifest.json` 中的 `appid`, 更换为你自己的 `appid`, 比如 `uni-app` / `mp-weixin` 平台。
|
||
|
||
## 升级依赖
|
||
|
||
- `pnpm up:pkg` 升级除了 `uni-app` 相关的其他依赖
|
||
- `pnpm up:uniapp` 升级 `uni-app` 相关的依赖
|
||
|
||
推荐先使用 `pnpm up:pkg` 升级, 再使用 `pnpm up:uniapp` 进行升级，因为 `pnpm up:uniapp` 很有可能会进行版本的降级已达到和 `uni-app` 版本匹配的效果
|
||
|
||
## 切换镜像源
|
||
|
||
默认情况下，走的是淘宝镜像源 : `registry.npmmirror.com`
|
||
|
||
假如你需要修改镜像源，请修改目录下的 `.npmrc` 文件，然后重新进行 `pnpm i` 安装包即可
|
||
|
||
## 包管理器
|
||
|
||
本项目默认使用 `pnpm@10` 进行管理，当然你也可以切换到其他包管理器，比如 `yarn`, `npm`
|
||
|
||
你只需要把 `pnpm-lock.yaml` 删掉，然后把 `package.json` 中的 `packageManager` 字段去除或者换成你具体的包管理器版本，然后重新安装即可
|
||
|
||
### weapp-ide-cli
|
||
|
||
本项目已经集成 `weapp-ide-cli` 可以通过 `cli` 对 `ide` 进行额外操作
|
||
|
||
- `pnpm open:dev` 打开微信开发者工具，引入 `dist/dev/mp-weixin`
|
||
- `pnpm open:build` 打开微信开发者工具，引入 `dist/build/mp-weixin`
|
||
|
||
[详细信息](https://www.npmjs.com/package/weapp-ide-cli)
|
||
|
||
## tailwindcss 生态
|
||
|
||
详见：<https://github.com/aniftyco/awesome-tailwindcss>
|
||
|
||
你可以在这里找到许多现成的UI，组件模板。
|
||
|
||
## 单位转换
|
||
|
||
- `rem` -> `rpx` (默认开启, 见 `vite.config.ts` 中 `uvtw` 插件的 `rem2rpx` 选项)
|
||
- `px` -> `rpx` (默认不开启，可在 `postcss.config.ts` 中引入 `postcss-pxtransform` 开启配置)
|
||
|
||
## Tips
|
||
|
||
- 升级 `uni-app` 依赖的方式为 `npx @dcloudio/uvm` 后，选择对应的 `Package Manager` 即可。而升级其他包的方式，可以使用 `pnpm up -Li`，这个是 `pnpm` 自带的方式。
|
||
- 使用 `vscode` 记得安装官方插件 `stylelint`,`tailwindcss`, 已在 `.vscode/extensions.json` 中设置推荐
|