更新记录

1.0.1（2026-08-06） 下载此版本

UTS 跨平台兼容修复

• interface → type：组件 Props 定义改用 type 替代 interface，避免 Android/iOS 原生编译时 Kotlin/Swift 报错
• defineEmits<...>() 泛型 → 数组形式：defineEmits(['convert-success', 'convert-error'])，兼容 UTS 原生编译器
• === → ==：脚本中所有严格相等替换为宽松相等，符合 UTS 跨平台规范
• !== → !=：typeof result !== 'string' → typeof result != 'string'
• 可选链 ?. 替换：err?.errMsg → (err != null && err.errMsg != null)，避免可选链在 UTS 原生编译中的兼容风险
• 非空断言 ! 替换：match[1]! → match[1] as string，使用类型断言替代非空断言
• 空安全加固：所有 err.errMsg 访问前增加 err != null 判断，防止 null 指针异常

1.0.0（2026-08-04） 下载此版本

Web 平台适配

• 选择→Base64：修复 H5 平台 imageFileToBase64 因 getFileSystemManager().readFile() 不支持 Web 导致的失败。新增 #ifdef WEB 分支，使用浏览器原生 fetch() + FileReader 读取 blob URL 并转为 base64。
• Base64→临时文件：修复 H5 平台 base64ToTempFile 因 getFileSystemManager().writeFile() 不支持 Web 导致的失败。新增 #ifdef WEB 分支，使用 Blob + URL.createObjectURL() 生成临时 blob URL。

功能优化

• 复制按钮：修复点击"复制"时复制的是截断后的 100 字符而非完整 base64 的问题。新增 fullBase64 存储完整值，复制时优先使用。
• 用户取消处理：handleChooseToBase64 中增加取消检测——用户关闭文件选择弹窗时静默返回，不再弹出错误 toast。
• 错误日志：catch 块增加 console.error 输出完整错误对象，方便调试。

Vapor 兼容性

• 组件文件重命名：.vue → .uvue
• 所有 rpx 单位替换为 px（2:1 换算）
• 后代选择器改为独立 class 绑定
• word-break: break-all → white-space: break-spaces
• 移除 as const，改为显式类型声明
• Props 接口属性去可选化
• handleBase64ToAlbum 加 #ifdef 平台条件编译
• showToast icon 降级处理（'error' → 'none'）
• uni.env.USER_DATA_PATH Web 平台适配为 uni.env.CACHE_PATH

平台兼容性

uni-app(5.0)

uni-app x(5.0)

jack-image-converter

跨平台图像转换组件，支持图片与 Base64 之间的相互转换。已适配 uni-app x UTS 原生编译规范（Android / iOS / Harmony）。

功能

• 图片选择 → Base64：从相册或相机选择图片，自动转换为 Base64 字符串
• 文件路径 → Base64：读取本地图片文件（App）或 URL（Web），转换为 Base64
• Base64 → 临时文件：将 Base64 数据写入本地临时图片文件（App）/ 生成 blob URL（Web）
• Base64 → 相册：将 Base64 数据保存到系统相册（仅 App + 小程序）
• Base64 → 预览：直接预览 Base64 字符串对应的图片
• 图片压缩：选择图片并按设定质量压缩（仅 App + 小程序）
• 图片信息：获取图片的宽度、高度、格式等信息
• Base64 验证：检测 Base64 字符串是否为有效的图片数据，并识别格式（PNG/JPEG/GIF/WebP/BMP）

平台兼容

Web 平台说明： 浏览器不支持本地文件系统 API（getFileSystemManager），"路径→Base64" 通过 fetch 读取 URL，"Base64→临时文件" 通过 Blob + URL.createObjectURL 生成。压缩和相册保存仅限 App/小程序平台。

使用方式

easycom 自动注册

在 uni-app x 项目中，uni_modules 下的组件会自动注册，无需手动 import：

<template>
  <jack-image-converter />
</template>

Props

Events

使用示例

<template>
  <jack-image-converter
    :showTabChoose="true"
    :showTabFile="true"
    :showTabBase64="true"
    :showTabTools="true"
    @convert-success="onSuccess"
    @convert-error="onError"
  />
</template>

<script setup lang="uts">
const onSuccess = (data: { type: string, result: string }) => {
  console.log('转换成功:', data.type)
}

const onError = (data: { type: string, error: string }) => {
  console.error('转换失败:', data.type, data.error)
}
</script>

工具模块（utils/image-converter.uts）

组件内部使用的纯函数工具模块，也可单独导入使用：

import {
  imageFileToBase64,      // 文件路径 → Base64
  chooseImageToBase64,    // 选择图片 → Base64
  base64ToTempFile,       // Base64 → 临时文件
  base64ToDataUri,        // Base64 → data: URI
  stripDataUriPrefix,     // 去除 data URI 前缀
  detectImageFormat,      // 魔数检测图片格式
  isValidImageBase64,     // 验证 Base64 有效性
  getImageInfo,           // 获取图片信息
  getFormatFromPath       // 路径推断格式
} from '@/uni_modules/jack-image-converter/utils/image-converter'

格式检测支持的格式：png、jpg、gif、webp、bmp，未知格式返回 unknown，非法数据返回 invalid。

依赖

• uni-app x（Vapor 模式）
• 无外部插件依赖

更新日志

详见 changelog.md