智印 · Zebra RFID 标签设计器(zebra-rfid-zpl-designer) 文档包

zebra-rfid-zpl-designer 文档包

智印 · Zebra RFID 标签设计器（npm：zebra-rfid-zpl-designer）— 面向 Web 与 Node 的 RFID 标签 ZPL 设计、生成、校验、预览与打印插件。

👉 产品背景、能力与场景说明见产品介绍.md

本目录为自包含的插件文档与示例，内含已打包的插件分发文件，可整体复制到任意环境使用，不依赖仓库内其他目录。

目录结构

zebra-rfid-zpl-designer/ ← 文档包根目录（以下路径均相对此目录） ├── README.md # 本文件 ├── usage.md # 使用文档 ├── development.md # 集成开发文档 ├── package.json # 示例运行用（引用 ./plugin/ 下 tgz） ├── plugin/ │ ├── zebra-rfid-zpl-designer.tgz # 插件分发包（稳定名） │ └── zebra-rfid-zpl-designer-1.0.0.tgz # 带版本号（归档用） ├── vue-demo/ # 可运行的 Vue 2 集成示例（与根项目 zebrarfid-plus 一致） │ ├── src/views/zplDesigner/ # 设计器页面 │ ├── vue.config.js │ └── package.json # 依赖 ../plugin/ 下 tgz，不含 package/ 源码 └── examples/ ├── 01-basic-zpl-generation.js ├── 02-template-crud.js ├── 03-preview-and-print.js ├── 04-visual-designer.js ├── 05-vue-integration.vue └── 06-batch-print.js

插件位置

已打包插件位于：

plugin/zebra-rfid-zpl-designer.tgz

安装后通过 npm 包名引用：

import{createLabelDesigner,generateZpl}from'zebra-rfid-zpl-designer'

类型声明：node_modules/zebra-rfid-zpl-designer/lib/index.d.ts（执行npm install后）。

快速开始（运行示例）

在文档包根目录执行：

npminstallnpmrun example:basic

Vue 可视化示例（推荐）

一键启动与根项目相同的 Vue 设计器界面：

npmrun demo:vue

浏览器访问 http://localhost:8080/#/zpl-designer。详见 vue-demo/README.md。

其他 Node 示例：

npmrun example:crudnpmrun example:batchnodeexamples/02-template-crud.js

接入业务项目

将plugin/zebra-rfid-zpl-designer.tgz复制到你的项目中，在package.json声明：

{"dependencies":{"zebra-rfid-zpl-designer":"file:./lib/zebra-rfid-zpl-designer.tgz"}}

路径./lib/仅为示例，可按你的项目结构调整。详见 usage.md。

文档索引

适用读者

• 业务前端 / 全栈：复制 tgz → 接入项目 → 阅读 usage + development
• API 速查：npm install后查看node_modules/zebra-rfid-zpl-designer/lib/index.d.ts