ZicoxPrinter

使用 .Net Core MAUI 开发的 Zicox CPCL打印机App
An Android App developed using .Net Core MAUI for Zicox CPCL printers.

• 安卓设备的系统要求 / System requirements for Android devices

  • 安卓版本 >= Android 5.0 (API 21 Lollipop)
    Android version >= Android 5.0 (API 21 Lollipop)

• 使用.Net MAUI开发，限制了平台为 Windows 和 安卓。
  Developed using .Net MAUI, the platforms are limited to Windows and Android.

• 参照Zicox CPCL打印机的SDK制作的简易的CPCL打印程序
  A simple CPCL printing program made with reference to the Zicox CPCL printer SDK

测试用到的设备 / Tested devices

Android 设备 / Android devices

• WSA (Windows Subsystem for Android) 2311.400000.5.0
• Sony XQ-BQ72 (Android 13)
• Sony XQ-DQ72 (Android 14)
• UROVO DT50 (Android 11)
• UROVO DT40 (Android 9)

Zicox 设备 / Zicox devices

• Zicox CC3
• Zicox CC4
• 注意，目前仅在 Zicox CC3 打印机、Zicox CC4 打印机 上进行过完整的功能测试
  Note, currently full functional testing has only been carried out on Zicox CC3 printer and Zicox CC4 printer
• 按照Zicox官方说明，理论上可以在Zicox的其它使用CPCL指令的打印机上进行使用
  According to Zicox official instructions, it can theoretically be used on other Zicox printers that use CPCL instructions.

App 截图 / Screenshot

		同时包含有所有的可打印参数 / Include all available print parameters Box / Line / Text / Barcode / QR Code / Image

• 打印CPCL标尺 / Print CPCL ruler
  

---

使用注意 / Note

注意:
当使用 DRAWBIGGRAPHIC 参数打印大图时，建议将 PageHeight 设置为 0。实际打印高度将由图片渲染高度（即 ImageHeight * bmp_size_h_percentage）决定。如果 PageHeight 被设置为大于 0 的值，它将被视为一个额外的底部边距，并可能导致在图片打印完成后额外输出设定高度的空白页面。此外，在使用 DRAWBIGGRAPHIC 参数时，请勿同时添加其他打印参数，因为 DRAWBIGGRAPHIC 在SDK层面会独立触发一次打印操作，与其他可统一配置并一次性打印的参数处理方式不同。
Note:
When using the DRAWBIGGRAPHIC parameter for printing large images, it is recommended to set PageHeight to 0. The actual print height will be determined by the image rendering height (i.e., ImageHeight * bmp_size_h_percentage). If PageHeight is set to a value greater than 0, it will be treated as an additional bottom margin and may result in an extra blank page of the specified height being output after the image is printed. Furthermore, when using the DRAWBIGGRAPHIC parameter, do not include other print parameters simultaneously, as DRAWBIGGRAPHIC independently triggers a print operation at the SDK level, which differs from how other parameters are handled (where they can be uniformly configured and printed at once).

---

项目说明 / Project description

• ZicoxPrinter

  • 使用 .Net Core MAUI 开发的Android App
    An Android App developed using .Net Core MAUI

• MyZpSDK

  • 自行二次封装的Zicox CPCL SDK，并加入了一些自定义的功能
    Self-packaged Zicox CPCL SDK and added some custom functions

  • 基础的Zicox CPCL SDK是Zicox官方提供的 zp_cpcl_new_打印通用版大图片.jar
    The basic Zicox CPCL SDK is the Zicox official provided zp_cpcl_new_打印通用版大图片.jar

  • 因为是.Net Core MAUI的项目，故还需要再次通过.Net 的安卓绑定库封装成.Net可使用的类库
    Because it is a .Net Core MAUI project, it needs to be packaged into a .Net usable class library through .Net Android binding library again.

• MyBluetoothLibrary

  • 自行编写的安卓蓝牙简易功能库，仅支持经典蓝牙的搜索与配对功能，不支持蓝牙数据的传输相关的功能
    The self-written Android Bluetooth simple function library only supports search and pairing functions of classic Bluetooth and does not support functions related to Bluetooth data transmission.

  • 因为主要是在安卓平台上使用，且目前并没有符合我预期功能的简易蓝牙功能库，所以才自行编写了单独的安卓蓝牙功能库，并再次通过.Net 的安卓绑定库封装成.Net可使用的类库
    Because it is mainly used on the Android platform, and there is currently no simple Bluetooth function library that meets my expected functions, so I wrote a separate Android Bluetooth function library by myself, and again passed .Net Android binding library Encapsulated into a .Net usable class library