﻿HSPOS PrinterSDK 客户交付包 / Customer Delivery Package
========================================================

产品名称 / Product: HSPOS PrinterSDK
版本 / Version: 1.6.3
打包日期 / Package Date: 2026-08-13
厂商 / Vendor: HSPOS

一、简介 / Overview
--------------------
本包提供 Android 打印机 SDK（AAR）、完整文档，以及可运行的测试案例工程/APK。
支持 USB / 蓝牙 / 网口 / 串口，协议支持 ESC/POS 与 JPL。

This package includes the Android Printer SDK (AAR), documentation, and a runnable sample/test app.
Supports USB, Bluetooth, Network and Serial; ESC/POS and JPL protocols.

本包不包含 SDK 源码或内部临时文件。
This package does NOT include SDK source code or temporary files.

二、目录说明 / Contents
-----------------------
libs/
  printerSDK.aar                 - SDK 库（请放入您的 app/libs）

docs/
  PrinterSDK_使用说明书.md        - 中文使用说明书
  PrinterSDK_User_Manual.md      - English user manual
  PrinterSDK_API_Documentation_zh.md - 中文 API 参考
  PrinterSDK_API_Documentation.md    - English API reference

sample/
  PrinterTestApp/                - 测试案例源码工程（Android Studio 可直接打开）
  apk/PrinterTestApp-debug.apk   - 可直接安装的测试 APK（若已包含）

三、快速集成 SDK / Integrate SDK
--------------------------------
1. 复制 libs/printerSDK.aar 到您的工程 app/libs/
2. 添加依赖：
   implementation(files("libs/printerSDK.aar"))
3. Sync Gradle 后按文档调用 API

四、测试案例 / Sample App
-------------------------
方式 A：安装 APK
  将 sample/apk/PrinterTestApp-debug.apk 安装到 Android 设备后即可测试连接与打印。

方式 B：打开工程
  用 Android Studio 打开 sample/PrinterTestApp，连接真机运行。
  详见 sample/PrinterTestApp/README.txt

五、联系方式 / Contact
----------------------
官网 / Website : https://www.hsprinter.com
邮箱 / Email   : info@hsprinter.com
品牌 / Brand   : HSPOS
