更新记录

1.0.0（2025-04-07） 下载此版本

平台兼容性

uni-app

uni-app x

XL-Tool 多功能工具集

在线演示地址：https://xlandzxg-8gj5901i764f06f7-1308786497.tcloudbaseapp.com/index.html#/

一个基于 uni-app 的多功能工具集合，包含多个常用的功能组件。本项目旨在提供一套完整的、易用的、跨平台的工具组件，帮助开发者快速构建应用。

功能特点

• 🚀 基于 Vue 3 + TypeScript 开发
• 📱 支持多端运行（H5、小程序、APP）
• 🎨 统一的 UI 风格和交互体验
• 🔧 高度可配置和可定制
• 📦 组件化设计，按需引入
• 📝 完善的文档和示例

组件列表

1. 蓝牙连接工具 (xl-bluetooth)

• 自动设备发现和连接
• 支持 BLE 和经典蓝牙
• 自动重连机制
• 设备状态实时监控
• 跨平台适配（APP、小程序）
• 权限自动申请
• 错误处理和提示
• 支持 Android 12+ 新权限

2. 支付工具 (xl-payment)

• 支持多种支付方式
  • 微信支付
  • 支付宝支付
  • 银联支付
• 订单管理功能
  • 订单创建
  • 订单查询
  • 订单取消
  • 退款处理
• 支付安全
  • 签名验证
  • 防重复支付
  • 支付超时处理
• 积分系统
  • 积分抵扣
  • 积分计算
  • 积分记录

3. 打印工具 (xl-printer)

• 支持多种打印机
  • 蓝牙打印机
  • 网络打印机
  • USB 打印机
• 打印功能
  • 文本打印
  • 图片打印
  • 条形码/二维码打印
  • 自定义模板
• 打印设置
  • 字体大小
  • 打印浓度
  • 对齐方式
  • 切纸控制
• 错误处理
  • 自动重试
  • 连接状态监控
  • 错误提示

4. 网络请求管理 (xl-request)

• 请求拦截器
  • 统一参数处理
  • 认证信息添加
  • 请求日志
• 响应拦截器
  • 统一响应处理
  • 错误处理
  • 数据转换
• 高级功能
  • 请求重试
  • 请求取消
  • 请求队列
  • 并发控制
• 缓存管理
  • 请求缓存
  • 缓存策略
  • 缓存清理

5. 拖拽排序列表 (xl-drag-list)

• 拖拽功能
  • 单列拖拽
  • 多列拖拽
  • 跨列拖拽
• 自定义样式
  • 拖拽手柄
  • 拖拽预览
  • 放置指示
• 高级特性
  • 虚拟滚动
  • 分组拖拽
  • 拖拽限制
  • 动画效果

6. 滑动操作 (xl-swipe-action) （因各设备兼容问题暂没上线）

• 滑动功能
  • 左滑操作
  • 右滑操作
  • 双滑操作
• 自定义配置
  • 按钮样式
  • 滑动距离
  • 动画效果
• 交互优化
  • 防误触
  • 回弹效果
  • 状态保持

7. 二维码工具 (xl-qrcode)

• 二维码生成
  • 文本二维码
  • 链接二维码
  • 名片二维码
  • 自定义内容
• 样式定制
  • 颜色设置
  • Logo 添加
  • 边框样式
  • 纠错级别
• 扫描功能
  • 相册扫描
  • 相机扫描
  • 批量扫描
  • 历史记录

快速开始

安装依赖

# 使用 npm
npm install

# 使用 yarn
yarn install

# 使用 pnpm
pnpm install

运行项目

# 运行到 H5
npm run dev:h5
# 或
yarn dev:h5
# 或
pnpm dev:h5

# 运行到微信小程序
npm run dev:mp-weixin
# 或
yarn dev:mp-weixin
# 或
pnpm dev:mp-weixin

# 运行到 APP
npm run dev:app
# 或
yarn dev:app
# 或
pnpm dev:app

打包发布

# 打包 H5
npm run build:h5
# 或
yarn build:h5
# 或
pnpm build:h5

# 打包微信小程序
npm run build:mp-weixin
# 或
yarn build:mp-weixin
# 或
pnpm build:mp-weixin

# 打包 APP
npm run build:app
# 或
yarn build:app
# 或
pnpm build:app

环境要求

• Node.js >= 14.0.0
• Vue >= 3.0.0
• uni-app >= 3.0.0
• TypeScript >= 4.0.0

注意事项

蓝牙功能

• 需要在真机上测试
• H5 环境不支持蓝牙功能
• Android 12+ 需要额外权限
• 小程序需要在后台配置蓝牙权限

支付功能

• 需要配置相应的支付参数
• 小程序需要在后台配置支付相关域名
• APP 需要配置相应的 scheme
• 注意支付安全性

打印功能

• 需要真机测试
• 注意打印机兼容性
• 建议使用知名品牌打印机
• 注意打印数据格式

其他注意事项

• 小程序需要在开发者后台配置相应的权限
• APP 需要在 manifest.json 中配置相应的权限
• 注意跨平台兼容性
• 建议使用最新版本的开发工具

版本历史

v1.0.0 (2024-01-01)

• 初始版本发布
• 支持基础功能组件
• 完成核心功能开发

v1.1.0 (2024-02-01)

• 添加银联支付支持
• 优化蓝牙连接稳定性
• 增加打印重试机制
• 修复已知问题

v1.2.0 (2024-03-01)

• 添加 Android 12+ 权限支持
• 优化组件性能
• 增加更多自定义选项
• 完善错误处理

贡献指南

1. Fork 本仓库
2. 创建新的功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 创建 Pull Request

问题反馈

如果您在使用过程中遇到任何问题，请：

1. 查看 常见问题
2. 搜索 Issues
3. 创建新的 Issue

许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

联系方式

• 项目维护者：[npcxl]
• 邮箱：[2966898893@qq.com]