# BarPanda

**Repository Path**: moretl/BarPanda

## Basic Information

- **Project Name**: BarPanda
- **Description**: 我们希望有一款产品去替代BarTender,免费且有操作简单. 
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 2
- **Created**: 2025-01-17
- **Last Updated**: 2025-08-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: MES, QMS, Bartender, 标签设计, 标签打印

## README

## 免费使用: [版本说明](https://gitee.com/moretl/BarPanda/releases/tag/Latest) | [下载最新版本](https://gitee.com/moretl/BarPanda/releases/download/Latest/BarPandaLatest.zip)


## 简介
Moretl BarPanda定位是一款**工具**,让产品保持最小功能,能确保稳定长久使用.
 - 我们希望去替代BarTender部分场景. 做到自启动,自更新.架构简单,兼容性好.
 - 同时在80%情况下,用户通过很简单的操作就能设计出想要的标签.
 - 在异构系统集成上(当前共享目录,后续提供WebApi),通过简单交互完成标签打印.

![输入图片说明](%E5%9B%BE%E7%89%87/image7.png)

## 客户端使用与集成手册
以服务器IP为192.168.31.148,共享目录为barpanda为例.

### 初始配置

#### 一.下载BarPanda
1. [**下载最新版本**](https://gitee.com/moretl/BarPanda/releases/download/Latest/BarPandaLatest.zip)到本地电脑.
2. 解压至本地目录.

#### 二.IT管理员: 配置
1. 打开 **BarPandaConfig.exe**,设置 共享目录,账号,密码

![输入图片说明](%E5%9B%BE%E7%89%87/q1.png)

2. 测试共享目录是否正常. 点击按钮 [1.检测共享目录]

![输入图片说明](%E5%9B%BE%E7%89%87/q2.png)

3. 部署更新包. 点击按钮 [2.设置更新包]

![输入图片说明](%E5%9B%BE%E7%89%87/q3.png)

4. 生成部署包. 点击按钮 [3.生成部署包]. 生成后将自动打开文件夹,IT人员将部署包分发到需要打印的电脑上.

![输入图片说明](%E5%9B%BE%E7%89%87/q4.png)

#### 三.部署客户端
1. 将 **部署包** 复制到需要打印的电脑上,解压.
2. 打开 **MoretlUpdater.exe** ,BarPanda将自启动.

![输入图片说明](%E5%9B%BE%E7%89%87/q5.png)

#### 四.测试是否部署成功
在打印电脑上打开客户端.点击[测试打印][Microsoft Print To PDF],也可选择真实的打印机.

![输入图片说明](%E5%9B%BE%E7%89%87/i1.png)

稍等几秒,系统弹框出来保存PDF.即部署成功. 可打开PDF查看打印效果.

![输入图片说明](%E5%9B%BE%E7%89%87/i2.png)


### 客户端版本更新
1. 下载[最新版本](https://gitee.com/moretl/BarPanda/releases/download/Latest/BarPandaLatest.zip);
2. 将BarPandaLatest.zip复制进\\192.168.31.148\barpanda\Update. 名称保持BarPandaLatest.zip不变;
3. 30秒内客户端将下载最新包,并自动重启更新;

### 异构系统集成

#### 一.集成客户端信息
1. 读取\\192.168.31.148\barpanda\Info中,每个文件对应一个客户端的信息

![输入图片说明](%E5%9B%BE%E7%89%87/image2.png)

- 客户端唯一ID: 文件名
- 客户端的IP: 文件内容(IP:)
- 客户端设备名: 文件内容(MachineName:)
- 最后在线时间: 文件内容(ReportTime:)
- 打印机列表: 文件内容(除以上几项,剩余均为打印机)

2. 建议: 业务系统根据以上信息,实际客户端对应哪台物理电脑,以便将打印任务下发给指定的客户端.
2. 建议: 业务系统检测客户端最后上报时间若超过1分钟. 则客户端离线,应该不允许用户打印.
3. 建议: 业务系统打印时,让用户选择用哪台打印机. 实际场景中存在一台电脑,连接多台打印机.

#### 二.集成打印
1. **代码** 读取标签模板json为字符串.
2. **代码** 替换占位符{{Printer}}为指定打印机
3. **代码** 替代其他业务数据占位符
4. 将json文件生成到打印目录\\192.168.31.148\barpanda\客户端ID
5. 5秒内客户端自动打印完成,并删除改Json
6. 打印失败,如图:

![输入图片说明](%E5%9B%BE%E7%89%87/image8.png)


## 标签设计器手册
打开Bin\MoretlBarPandaDesign.exe

#### 一. 原理
通过将[空白容器块],按比例切割成子块. 下图为横向切割,跟纵向切割的效果.

![输入图片说明](%E5%9B%BE%E7%89%87/d1.png)

![输入图片说明](%E5%9B%BE%E7%89%87/d2.png)

#### 二. 块的类型
1. 空白容器块: 可添加子块;点击[淡黄色按钮]弹出设置菜单;

![输入图片说明](%E5%9B%BE%E7%89%87/d3.png)

2. 字符串块,二维码块,128码块,图片块: 不可添加子块;点击块任意一点,弹出操作菜单

![输入图片说明](%E5%9B%BE%E7%89%87/d4.png)

#### 三. 通用设置
- 比例: 子块占父块的比例. 影响块的大小
- 边框,圆角与边距

![输入图片说明](%E5%9B%BE%E7%89%87/p1image.png)

#### 四. 空白容器块设置
设置切分方向

![输入图片说明](%E5%9B%BE%E7%89%87/p6.png)

#### 五. 字符串块设置
主要设置字体大小,方向

![输入图片说明](%E5%9B%BE%E7%89%87/p7.png)

#### 六. 条码/二维码块设置
设置条码内容,条码面积,是否显示目视信息

![输入图片说明](%E5%9B%BE%E7%89%87/p10.png)


#### 七. 图片块设置
设置图片Url

![输入图片说明](%E5%9B%BE%E7%89%87/p11.png)