跳过主要内容

指南

打印机教程

在设备上测试

Download the Capgo app, then scan the QR code.

打印机插件预览二维码code

使用@capgo/capacitor-打印机

Capacitor打印机插件,用于打印文档、HTML、PDF、图片和网页视图。

安装

bun add @capgo/capacitor-printer
bunx cap sync

此插件暴露的内容

  • printBase64 - 提供打印UI以打印以base64编码的字符串。
  • printFile - 提供打印UI以打印设备文件。
  • printHtml - 提供打印UI以打印HTML文档。
  • printPdf - 提供打印UI以打印PDF文档。

示例用途

printBase64

- 提供打印UI以打印以base64编码的字符串。

import { Printer } from '@capgo/capacitor-printer';

// Print a base64 encoded PDF
await Printer.printBase64({
  name: 'Invoice #12345',
  data: 'base64-encoded-pdf-data',
  mimeType: 'application/pdf',
});

// Print a base64 encoded image
await Printer.printBase64({
  name: 'Product Photo',
  data: '/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDA...',
  mimeType: 'image/jpeg',
});

printFile

打印 UI

import { Printer } from '@capgo/capacitor-printer';

// iOS: Print from app documents directory
await Printer.printFile({
  name: 'Contract',
  path: 'file:///var/mobile/Containers/Data/Application/.../Documents/contract.pdf',
});

// Android: Print from content URI
await Printer.printFile({
  name: 'Receipt',
  path: 'content://com.android.providers.downloads.documents/document/123',
  mimeType: 'application/pdf',
});

// Android: Print from file path
await Printer.printFile({
  name: 'Photo',
  path: 'file:///storage/emulated/0/Download/photo.jpg',
  mimeType: 'image/jpeg',
});

printHtml

打印 HTML 文档

import { Printer } from '@capgo/capacitor-printer';

// Simple HTML document
await Printer.printHtml({
name: 'Sales Report',
html: '<html><body><h1>Q4 Sales Report</h1><p>Revenue: $125,000</p></body></html>',
});

// HTML with print-specific CSS
await Printer.printHtml({
name: 'Styled Invoice',
html: `
<html>
<head>
<style>

printPdf

打印 PDF 文档

import { Printer } from '@capgo/capacitor-printer';

// Print PDF from app storage
await Printer.printPdf({
  name: 'Annual Report 2024',
  path: 'file:///var/mobile/Containers/Data/Application/.../Documents/report.pdf',
});

// Print PDF from Android downloads
await Printer.printPdf({
  name: 'Downloaded Document',
  path: 'content://com.android.providers.downloads.documents/document/123',
});

全局参考

继续使用 @capgo/capacitor-printer

如果您正在使用 使用 @capgo/capacitor-printer 以规划原生插件工作,连接它与 @capgo/capacitor-printer 为 @capgo/capacitor 打印机的实现细节, 开始使用 为 Getting Started 的实现细节, Capgo 插件目录 为 Capgo 插件目录中的产品工作流, Capacitor 由 Capgo 提供的插件 为 Capacitor 插件由 Capgo 提供的实现细节,并且 添加或更新插件 为添加或更新插件的实现细节。