更新记录

1.25.3（2025-11-12） 下载此版本

Bug Fixes

• 修复ios微信端水印渲染失败问题 (0bea433)

1.25.2（2025-11-11） 下载此版本

Bug Fixes

• cascader: 节点值相同时优先绑定后代节点 (3937b2d)
• input: 修复web端最大字数限制无效问题 (8811d13)

1.25.1（2025-11-07） 下载此版本

Features

• locale: 添加越南语语言包 (8f1611a)
• popout: 添加遮罩相关属性 (8ee1ad8)
• qrcode: 新增success事件 (91195a9)

平台兼容性

uni-app(4.11)

其他

Sard Uniapp

sard-uniapp 是一套基于 Uniapp + Vue3 框架开发的兼容多端的 UI 组件库。

国内：📖 文档     🧑🏻🏫 案例演示    

国外：📖 文档     🧑🏻🏫 案例演示    

介绍

sard-uniapp 是一套基于 Uniapp + Vue3框架开发的兼容多端的 UI 组件库。

sard-uniapp 兼容 H5 / 小程序 / APP（不支持 nvue 或 uvue）。

特性

• 🧩 102+个高质量组件，覆盖移动端主流场景
• 💪 支持一套代码同时开发 H5 / 小程序 / App
• 🌿 支持按需引入和 Tree Shaking
• 📖 详尽的文档和案例展示
• ʦ 使用 TypeScript 编写，提供完整的类型定义
• 🌈 支持定制主题
• 🌍 国际化支持
• 🌙 支持暗黑模式
• 🧪 单元测试覆盖率超过 80%，保障稳定性
• ⭐️ 零外部依赖，不依赖三方 npm 包

开源协议

本项目基于 MIT 协议，请自由地享受和参与开源。

更新日志

更新日志

如何维护

前提条件

• 确保 node >= 20
• 建议使用 pnpm 包管理器
• 建议使用 vscode 编辑器

克隆仓库到本地

git clone https://github.com/sutras/sard-uniapp.git

安装依赖

npm install

运行开发环境

npm run dev

运行上面命令后会生成四个链接：

Local:   http://localhost:5173/sard-uniapp-docs/mobile/    （演示）
Network: http://192.168.1.121:5173/sard-uniapp-docs/mobile/ (局域网演示）
Local:   http://localhost:7761/sard-uniapp-docs/           （文档）
Network: http://192.168.1.121:7761/sard-uniapp-docs/       （局域网文档）

测试

npm run test

构建文档站点

npm run build:site

预览构建的文档站点

npm run preview

构建组件库

npm run build

部署文档站点到 github pages

npm run deploy

发布组件库到 npm

npm run release

修复问题流程

• 修复问题
• 测试 npm run test
• 修改版本号
• 暂存 git add .
• 提交 git commit -m 'fix: '
• 给提交打标签 npm run tag
• 生成 changelog npm run changelog
• 暂存、提交 changelog git commit -a -m 'chore: changelog'
• 打包组件库 npm run build
• 发布到 npm npm run release
• 使用 HBuilderX 发布到 uniapp 插件市场
• 推送代码和标签 npm run push
• 打包文档（如果文档有修改）npm run build:site
• 部署文档（如果文档有修改）npm run deploy
• 更新 gitee 上的文档（如果文档有修改）

新增组件流程

• 运行 npm run nc 命令创建组件
• 运行 npm run nsc 命令创建子组件
• 编写组件代码（接口、类型、结构、样式、交互）
• 编写案例代码
• 编写组件文档
• 编写测试用例
• 使用实际项目本地安装测试 pnpm link ../sard-uniapp
• 从上面的“修复问题流程”第三个步骤“修改版本号”开始走一遍

打包安卓包流程

• 在 HBuilder 中打开 sard-uniapp 项目
• 点击 发行->App-Android/iOS-云打包
• 勾选“android(apk 包)” 、“使用云端证书”、“打正式包”、“快速安心打包”
• 点击“打包“按钮开始打包
• 注意：如果控制台出现错误：[ERROR] Cannot start service: Host version "_._._" does not match - binary version "_._._"，需安装和 Host version 一样版本的 @esbuild/darwin-x64
• 等待云端打包完成
• 到 gitee 仓库创建发行版：resource 发行版 - Gitee.com
• 将 gitee 发行版 apk 资源链接转换为二维码图片
• 将图片更新到 sard-assets 项目，并发布到 npm
• 最后等待 http://fastly.jsdelivr.net 链接生效