更新记录

1.0.2（2025-04-08）下载此版本

设备信息增强插件 (xl-device-info) 文件处理工具箱 (xl-file-tool) 高性能本地缓存引擎 (xl-cache-engine)

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

平台兼容性

Vue2	Vue3
√	×

App	快应用	微信小程序	支付宝小程序	百度小程序	字节小程序	QQ小程序
HBuilderX 3.96	×	×	×	×	×	×

钉钉小程序	快手小程序	飞书小程序	京东小程序	鸿蒙元服务
×	×	×	×	×

H5-Safari	Android Browser	微信浏览器(Android)	QQ浏览器(Android)	Chrome	IE	Edge	Firefox	PC-Safari
×	×	×	×	×	×	×	×	×

XL-Tool 多功能工具集

在线演示地址：在线demo

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

联系信息

邮箱：2966898893@qq.com
QQ群：983046451

功能特点

🚀 基于 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 添加
- 边框样式
- 纠错级别
扫描功能
- 相册扫描
- 相机扫描
- 批量扫描
- 历史记录

8. 设备信息增强插件 (xl-device-info)

详细设备参数
- 硬件信息
- 操作系统信息
- 屏幕参数
网络状态监测
- 网络类型识别
- 信号强度监测
- 网络变化提醒
传感器数据获取
- 加速度传感器
- 方向传感器
- 光线传感器
模拟器检测
- 虚拟设备识别
- 安全防护

9. 文件处理工具箱 (xl-file-tool)

文件操作
- 文件压缩
- 文件解压
- 格式转换
文件管理
- 文件浏览
- 文件分类
- 批量操作
安全功能
- 文件加密
- 权限控制

10. 高性能本地缓存引擎 (xl-cache-engine)

多引擎支持
- SQLite 引擎
- IndexedDB 引擎
高级特性
- 自动加密
- 高性能读写
- 数据同步
缓存管理
- 过期策略
- 容量控制
- 优先级管理

快速开始

安装依赖

# 使用 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+ 权限支持
优化组件性能
增加更多自定义选项
完善错误处理

<<<<<<< HEAD

v1.3.0 (2024-05-01)

新增设备信息增强插件
新增文件处理工具箱
新增高性能本地缓存引擎
优化现有组件性能
上线插件市场

插件市场

本项目已上线 uni-app 插件市场，可通过以下链接访问： XL-Tool 多功能工具集 - uni-app 插件市场

贡献指南

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

问题反馈

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

查看常见问题
搜索 Issues
创建新的 Issue
在插件市场评论区留言

许可证

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

联系方式

项目维护者：[npcxl]
邮箱：[2966898893@qq.com]
插件市场主页：XL-Tool 多功能工具集

XL-Tool多功能工具集 UI 支付集成 打印机 二维码生成