Taro Bluetooth Print

Appearance

更新日志 ​

所有重要的项目变更都会记录在此文件中。

格式基于 Keep a Changelog， 并且本项目遵循 语义化版本。

[1.0.9] ​

🚀 重要更新 ​

  • 🏗️ 构建系统重构: 完全移除 Rollup 配置，迁移到 Vite + webpack 双构建系统
  • 📚 文档系统升级: 集成 VitePress 现代化文档站点，支持 PWA 功能
  • 🔧 跨平台优化: 修复所有平台的蓝牙适配器类型兼容性问题
  • ⚡ 性能提升: Vite 构建速度提升 60%，包体积优化 15%

🛠️ 技术改进 ​

  • 🔨 构建工具:
    • 删除 rollup.config.js 和 rollup.config.advanced.js
    • 采用 Vite 作为主构建工具，webpack 作为兼容性备选
    • 支持 ESM/CommonJS/UMD 三种格式输出
  • 📖 文档系统:
    • 新增 VitePress 文档站点，支持移动端响应式设计
    • 添加 PWA 支持，具备离线访问和安装能力
    • 创建 FAQ 和贡献指南页面
  • 🔍 类型安全:
    • 修复所有 TypeScript 编译错误
    • 统一蓝牙适配器接口实现规范
    • 解决全局变量类型冲突问题

🐛 修复问题 ​

  • 🛠️ 修复微信小程序适配器 res.device API 使用错误
  • 🔧 解决 TypeScript 模块解析兼容性问题
  • 🔧 修复 Web Bluetooth API 类型冲突
  • 🔧 解决鸿蒙 OS 适配器全局变量冲突
  • 🔧 修复所有未使用变量警告
  • 🔧 统一所有适配器方法命名规范（init → initialize）

📦 构建优化 ​

  • ⚡ Vite 构建时间从 ~4s 优化到 ~2.5s
  • 📦 支持 Tree-shaking，减少最终包体积
  • 🗺️ 生成完整的 Source Maps 文件
  • 📝 完整的 TypeScript 类型声明文件

📚 文档完善 ​

  • 📖 新增 docs/reference/faq.md 常见问题解答
  • 🤝 新增 docs/reference/contributing.md 贡献指南
  • 🎨 优化文档 SEO 配置和 meta 标签
  • 📱 添加移动端友好的响应式设计

🔧 开发体验 ​

  • 🛠️ 改进构建配置，提升开发体验
  • 📊 新增构建输出分析和性能监控
  • 🔍 添加构建验证脚本
  • ⚙️ 优化 TypeScript 编译配置

[1.0.8] ​

🚀 新增 ​

  • 代码结构优化:

    • 重构代码结构，提高模块化和可维护性
    • 添加蓝牙服务类，分离通用蓝牙功能
    • 添加打印机类，专门处理打印相关功能
    • 改进错误处理机制，提供更详细的错误信息

  • 开发工具:

    • 添加单元测试支持
    • 优化构建流程，减少代码体积
    • 添加 Platform 类，用于跨平台功能检测
    • 添加参数校验，提高代码健壮性

  • 性能优化:

    • 优化蓝牙数据传输的稳定性
    • 改进内存使用和缓冲区管理
    • 完善错误处理和恢复机制
    • 提高代码质量和可维护性

🐛 修复 ​

  • 🛠️ 修复蓝牙连接断开后重连问题
  • 🛠️ 优化打印数据分包机制，避免数据丢失
  • 🛠️ 修复 Android 平台兼容性问题
  • 🛠️ 移除未使用的 ExtendedErrorCode 导入
  • 🛠️ 修复 Rollup 配置中的未使用 path 导入
  • 🔍 修复 BluetoothAdapter 接口与实现不一致问题
  • 🔍 解决 H5 平台蓝牙适配器中 deviceId 参数未使用的问题
  • 🔍 优化 TypeScript 类型声明，改进跨平台兼容性
  • 🔐 添加适配器方法的空值检查，提高代码安全性

📦 依赖更新 ​

  • 📦 添加开发工具依赖：@types/jest, jest, ts-jest
  • 📦 添加代码质量工具：eslint, prettier, @typescript-eslint/eslint-plugin

📚 文档更新 ​

  • 📚 更新 README.md，添加详细使用说明
  • 📚 添加 API 文档
  • 📚 更新开发指南

🛠️ 工具更新 ​

  • 🛠️ 更新 Rollup 配置，添加 terser 压缩
  • 🛠️ 添加代码格式化配置
  • 🛠️ 添加 ESLint 配置
  • 🛠️ 添加 Jest 测试配置

[1.0.7] ​

🚀 新增 ​

  • 图片处理增强:

    • 新增 Web Worker 图片处理功能
    • 优化大图片处理性能
    • 添加图片格式转换支持

  • 相机组件:

    • 新增相机拍照功能组件
    • 支持实时预览和拍照
    • 集成图片处理流程

  • TypeScript 改进:

    • 修复所有 TypeScript 编译错误
    • 完善类型定义
    • 添加更严格的类型检查

🐛 修复 ​

  • 修复 Web Worker 在小程序环境中的兼容性问题
  • 解决相机组件在 iOS 设备上的显示异常
  • 修复图片处理时的内存泄漏问题

⚡ 性能 ​

  • 优化图片处理算法，提升处理速度 40%
  • 减少内存占用，改进长时间运行稳定性
  • 优化蓝牙连接建立时间

[1.0.6] ​

🚀 新增 ​

  • 基础功能完善:

    • 完成蓝牙连接管理
    • 实现基础文本打印功能
    • 添加设备状态监控

  • 错误处理:

    • 完善错误处理机制
    • 添加超时处理
    • 实现自动重连功能

📱 兼容性 ​

  • 支持微信小程序平台
  • 兼容 H5 平台
  • 添加 React Native 基础支持

[1.0.0] ​

🎉 首次发布 ​

  • ✨ 实现基础的蓝牙打印功能
  • 📦 支持 ES6 模块和 CommonJS
  • 📚 完整的 TypeScript 类型定义
  • 🧪 基础测试覆盖

版本说明 ​

  • 主版本 (MAJOR): 不兼容的 API 修改
  • 次版本 (MINOR): 向下兼容的功能性新增
  • 修订版本 (PATCH): 向下兼容的问题修正

升级指南 ​

从 1.0.8 升级到 1.0.9 ​

bash
# 更新依赖
npm install taro-bluetooth-print@latest

# 验证新版本
const lib = new TaroBluePrint();
console.log(lib.getVersion()); // 应输出 "1.0.9"

# 构建项目（如需）
npm run build

重要变更:

  • 🏗️ 构建系统: 完全迁移到 Vite + webpack，不再依赖 Rollup
  • 📚 文档: 新增 VitePress 文档站点，支持 PWA 功能
  • 🔧 类型安全: 修复所有 TypeScript 类型问题
  • ⚡ 性能: 构建速度提升 60%，包体积优化 15%

兼容性:

  • ✅ 完全向后兼容，无需修改现有代码
  • ✅ 所有 API 保持不变
  • ✅ 仅改进构建系统和类型安全

从 1.0.7 升级到 1.0.8 ​

bash
# 更新依赖
npm install taro-bluetooth-print@latest

注意: 1.0.8 版本主要是代码结构优化和错误处理改进，没有破坏性变更，可以无缝升级。

从 1.0.6 升级到 1.0.7 ​

bash
npm install taro-bluetooth-print@latest

注意: 1.0.7 版本引入了 Web Worker，需要在项目配置中添加相关支持。

基于 MIT 许可证发布

Copyright © 2025 Agions