目录

安装和使用

二次开发手册

常见问题

打印控件SpiritWeb使用手册

开发人员请看 二次开发手册

安装

Windows安装

程序下载地址: https://www.printspirit.cn/download/spirit-web-setup.exe

Linux安装

下载

安装

  1. 环境要求

Spririt依赖NSS（Network Security Services）库

debian系(Unbuntu, 麒麟桌面版等):

sudo apt-get update
sudo apt-get install libnss3-tools

ReadHat系(Fedora,CentOS,麒麟服务器版)

sudo yum install nss-tools
# 或者
sudo dnf install nss-tools
  1. 解包
mkidr /opt
cd /opt
sudo tar xzvf path/to/spirit_2.10_amd64.tgz  //或其他版本的安装程序
sudo chown -R 登陆用户ID:登陆用户组 spirit

安装目录可以任意，这里以/opt为例。解包后目录为/opt/spirit, 修改owner/group为当强登陆用户, 确保该目录可读可写， 否则后面的操作会报错。

  1. 安装
cd /opt/spirit
./prnsvr ssl-key-gen          # 生成https证书
sudo ./prnsvr install         # 安装
sudo ./prnsvr start           # 启动

./prnsvr ssl-key-gen 生成https自签证书，是用https访问localhost的前提。注意该步必须使用普通用户执行（不能sudo)。

验证

安装完成后, 使用浏览器打开https://127.0.0.1:9443，出现下面的界面，表示安装成功。

设置

对多数场景，普通用户安装完软件后无需任何设置即可使用。

但如果有以下场景，需设置缺省打印机参数后方可使用。

  1. 连接的打印机超过一台。
  2. 打印机的指令集非缺省(斑马ZPL兼容)指令集
  3. 打印机分辨率不是203DPI(8点/毫米)。

设置方法：

  • 通过 http://127.0.0.1:9011 打开控制台 或 https://127.0.0.1:9443
  • 或通过菜单: Print Spirit>控制台 打开

然后设置对应参数。

打印机类型

标签打印机一般支持均兼容斑马ZPL/CPCL打印机，请选择对应的指令集。如不清楚，请联系打印生产厂家。

如果打印机不支持上述指令集。则只能选择windows打印机，并安装相应的Windows打印驱动程序，

对于针试行打，可以通过printRaw()发送原始打印指令到打印机。

打印端口/打印机

这里列出当前系统安装的打印机(包括USB, windows已安装打印机)和打印端口。

USB打印机(需开机), windows打印机将在选项中列出，可通过打印机名称选择。

并口/串口打印机，只能通过端口选择。

分辨率

为打印机的打印分辨率。对于windows打印机，该项设置无效。

预览

在控制台点击预览按钮，可以查看最后一个标签的打印效果。这在没有真实打印机，调试打印机程序时非常有用。

注册

程序可以全功能免费使用三个月。

单用户注册

安装完成后，进入控制台。单击立即注册，可以看到如下的对话框。

注册窗口

图中红框内的数字为注册ID。

将注册ID提供给代理商或代理网站获取注册码，输入注册码完成注册。

批量许可注册

10个用户以上，可联系代理商获取批量许可。

批量许可的格式为1-ddddd-XXXXX-XXXXX-XXXX, 其中ddddd为顺序号，XXXXX-XXXXX-XXXX为加密数字。 一般情况下使用顺序号即可查询批量许可的相关信息，只有在注册时才使用完整的批量许可证书。

批量许可需在本机注册后方可使用，最大注册次数等于批量许可用户数。请要妥善保管批量许可证书， 不要向任何人（包括软件销售人员，客服人员）出示完整的证书。

批量许可在本机注册操作方式同单用户注册。

注意：批量许可本机注册时，必须连接英特网获取本机注册码。注册完成后不再需要英特网。

登录


  • 安装
    • Windows安装
    • Linux安装
      • 下载
      • 安装
    • 验证
  • 设置
    • 打印机类型
    • 打印端口/打印机
    • 分辨率
  • 预览
  • 注册
    • 单用户注册
    • 批量许可注册