更新记录

1.0.1（2025-07-22）

修改文档说明

1.0.0（2025-07-22）

1.0.0

平台兼容性

云函数类插件通用教程

使用云函数类插件的前提是：使用HBuilderX 2.9+

条形码生成工具前端使用说明文档

🚨 重要提示

请您先试用再购买！
在正式购买前，请务必在测试环境中充分测试本工具的功能。
本工具由开发者利用业余时间开发维护，可能存在以下情况：

• 功能兼容性：请确认工具完全满足您的项目需求
• 问题响应：Bug修复可能无法做到即时响应
• 支持限制：优先处理已确认购买的正式用户问题

强烈建议：在试用环境中全面测试后，确认功能满足需求再进行购买！
感谢您的理解与支持 🙏

兼容性说明

本工具全面兼容以下平台和框架：

方法列表

1. 生成自定义条形码

方法名
generateBarcode(params)

请求参数

返回结果

{
  code: Number, // 200=成功，400=参数错误，500=生成失败
  message: String, // 结果描述
  data: {
    url: String,      // 云存储访问URL uploadToCloud=true 时返回
    fileID: String,   // 云存储文件ID uploadToCloud=true 时返回
    size: Number      // 图片大小（字节）uploadToCloud=true 时返回
    image: String,   // Base64图片数据 uploadToCloud=false 时返回
    params: Object,   // 实际使用的参数
  },
  details: Object    // 错误详情（仅错误时返回）
}

2. 参数预校验

方法名
validateBarcodeParams(params)

返回结果

{
  code: number,        // 200=验证通过，其他=失败
  message: string,     // 错误详情（多个错误用逗号分隔）
  data?: Object,       // 校验后的参数（成功时返回）
  details?: string[]   // 错误详情（失败时返回）
}

关键特性说明

1. 颜色格式关键说明

• 支持的颜色格式：

  • HEX格式：#RRGGBB（如#FF0000）
  • RGB格式：rgb(r,g,b)（如rgb(255,0,0)）
  • RGBA格式：rgba(r,g,b,a)（如rgba(255,0,0,0.5)）

• 颜色对比度建议：

  • 确保barColor与bgColor有足够对比度
  • 推荐组合：
  • 黑色条码+白色背景（默认）
  • 深蓝色条码+浅黄色背景
  • 深绿色条码+白色背景

• 透明度注意事项：

  • 当使用rgba格式设置透明度时，背景色将与页面背景混合
  • 对于要求不透明背景的场景，建议使用rgb或hex格式

2. 文本显示控制

• 文本位置与可见性：

  • showDisplayText控制是否显示自定义文本（通过text参数设置）

• 文本大小限制：

  • 仅支持预设尺寸：8/10/12/14/16/18/20/22/24/26/28/30/32/64像素

• 云存储路径：

  • 当设置uploadToCloud=true时，条形码将上传到UniCloud云存储
  • 系统会自动创建名为barcode-gsz的文件夹
  • 所有生成的条形码都将存储在此文件夹下

3. 条形码类型兼容性

• 常用类型推荐：

  • code128：默认类型，支持全ASCII字符集，推荐大多数场景使用
  • ean13：用于零售商品的13位条形码，仅支持数字
  • code39：可表示数字和字母，支持自检，适合工业应用
  • upca：北美商品条形码标准，12位数字

• 字符限制：

  • 数字型条形码（ean13, upca等）：仅支持数字0-9
  • 字母数字型条形码（code39等）：支持数字、大写字母和部分特殊字符
  • 全ASCII型条形码（code128等）：支持所有ASCII字符

支持的条形码类型与规范

1. 常用条形码类型详解

商品条码类

工业条码类

2. 完整条形码类型列表

以下是本工具支持的所有条形码类型（共80+种）：

完整类型参考：auspost, azteccode, azteccodecompact, aztecrune, bc412, channelcode, codablockf, code11, code128, code16k, code2of5, code32, code39, code39ext, code49, code93, code93ext, codeone, coop2of5, daft, databarexpanded, databarexpandedcomposite, databarexpandedstacked, databarexpandedstackedcomposite, databarlimited, databarlimitedcomposite, databaroomni, databaroomnicomposite, databarcstacked, databarcstackedcomposite, databarcstackedomni, databarcstackedomnicomposite, databartruncated, databartruncatedcomposite, datalogic2of5, datamatrix, datamatrixrectangular, datamatrixrectangularextension, dotcode, ean13, ean13composite, ean14, ean2, ean5, ean8, ean8composite, flattermarken, gs1-128, gs1-128composite, gs1-cc, gs1datamatrix, gs1datamatrixrectangular, gs1dldatamatrix, gs1dlqrcode, gs1dotcode, gs1northamericancoupon, gs1qrcode, hanxin, hibcazteccode, hibccodablockf, hibccode128, hibccode39, hibcdatamatrix, hibcdatamatrixrectangular, hibcmicropdf417, hibcpdf417, hibcqrcode, iata2of5, identcode, industrial2of5, interleaved2of5, isbn, ismn, issn, itf14, japanpost, kix, leitcode, mailmark, mands, matrix2of5, maxicode, micropdf417, microqrcode, msi, onecode, pdf417, pdf417compact, pharmacode, pharmacode2, planet, plessey, postnet, qrcode, rationalizedCodabar, raw, royalmail, royalmailcbc, rss14, rss14composite, rsslimited, rsslimitedcomposite, rssexpanded, rssexpandedcomposite, sscc18, telepen, telepennumeric, upca, upcacomposite, upce, upcecomposite

错误码说明