# uniapp工具集合

**Repository Path**: leheya/uniapp-tool-collection

## Basic Information

- **Project Name**: uniapp工具集合
- **Description**: 集合跨端一些工具
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 3
- **Created**: 2025-04-07
- **Last Updated**: 2025-08-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# XL-Tool 多功能工具集

## 联系 q群983046451

> 在线演示地址：[在线demo](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 添加
  - 边框样式
  - 纠错级别
- 扫描功能
  - 相册扫描
  - 相机扫描
  - 批量扫描
  - 历史记录


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

### 9. 文件处理工具箱 (xl-file-tool)
- 文件操作
  - 文件压缩
  - 文件解压
  - 格式转换
- 文件管理
  - 文件浏览
  - 文件分类
  - 批量操作
- 安全功能
  - 文件加密
  - 权限控制

### 10. 高性能本地缓存引擎 (xl-cache-engine)
- 多引擎支持
  - SQLite 引擎
  - IndexedDB 引擎
- 高级特性
  - 自动加密
  - 高性能读写
  - 数据同步
- 缓存管理
  - 过期策略
  - 容量控制
  - 优先级管理


## 快速开始

### 安装依赖
```bash
# 使用 npm
npm install

# 使用 yarn
yarn install

# 使用 pnpm
pnpm install
```

### 运行项目
```bash
# 运行到 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
```

### 打包发布
```bash
# 打包 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 插件市场](https://ext.dcloud.net.cn/)


## 贡献指南

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. 查看 [常见问题](docs/FAQ.md)
2. 搜索 [Issues](https://github.com/your-repo/issues)
3. 创建新的 Issue
4. 在插件市场评论区留言


## 许可证

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

## 联系方式

- 项目维护者：[npcxl]
- 邮箱：[2966898893@qq.com]
- 插件市场主页：[XL-Tool 多功能工具集](https://ext.dcloud.net.cn/)