更新记录

1.0.0（2026-04-20）

1. 支持 Android / iOS 系统打印能力检测
2. 支持打印本地文件、图片、HTML
3. Android 支持网页 URL 直接打印
4. 提供完整模板页，方便快速接入业务打印场景

平台兼容性

uni-app(4.75)

uni-app x(4.75)

austin-print

austin-print 是一个 App 系统打印 UTS 插件，兼容 Android / iOS。

将本地文件交直接交给系统打印面板去打印，快捷操作，适合一些 B 端业务场景

典型场景：

• 合同、发票、报表、出库单直接打印
• 本地图片、海报、签字页直接打印
• 业务页面先转成 HTML，再交给系统打印
• Android 里把网页 URL 直接交给系统打印框架

点击试用插件

目录下的index.vue 是完整模板页，点击试用后包含：

• 当前平台打印能力展示
• PDF / 图片 / HTML / 网页 四种打印入口 其中网页 URL 直打仅 Android 支持，iOS 入口会返回明确失败提示
• 业务预设填充
• 当前请求参数预览
• 最近一次打印结果日志

功能

• 支持 Android / iOS 系统打印能力检测
• 支持 printFile 打印本地文件
• 支持 printImage 打印本地图片
• 支持 printHtml 打印 HTML 字符串
• Android 支持 printWeb 直接打印网页 URL
• 返回统一结果结构

getPrintCapabilities()

返回当前平台打印能力对象。

printFile(options)

打印本地文件。当前版本主打 PDF 和图片文件。

printImage(options)

打印本地图片。

printHtml(options)

打印 HTML 字符串。

printWeb(options)

打印网页 URL。

• Android：支持
• iOS：当前版本不支持，建议先把页面转成 HTML 或 PDF 后再打印

返回结果

printFile、printImage、printHtml、printWeb 使用同一套返回结构：

补充说明：

• Android 大多数情况下回调的是 opened，表示系统打印面板已经拉起
• iOS 可以在打印面板关闭后返回更明确的 completed / cancelled

最小示例

import {
  getPrintCapabilities,
  printFile,
} from '@/uni_modules/austin-print'

const capabilities = getPrintCapabilities()
console.log('print-capabilities', capabilities)

printFile({
  filePath: 'unifile://cache/demo.pdf',
  fileName: 'demo.pdf',
  mimeType: 'application/pdf',
  jobName: '测试账单',
  success(res) {
    console.log('print-success', res)
  },
  fail(res) {
    console.log('print-fail', res)
  },
})

注意

• 插件只负责调起系统打印，系统打印面板可以选择打印机。不负责蓝牙/Wi-Fi 打印机发现、配对、连接。
• mimeType 就是文件内容类型字符串，例如 application/pdf、image/png、image/jpeg
• Android 当前版本的 printFile 主打 PDF 与图片；如果是 Word、Excel、CAD 等格式，请先转成 PDF 再打印
• iOS 当前版本不直接打印网页 URL，网页类场景建议先生成 HTML 或 PDF