Salta al contenuto principale
@capgo/capacitor-printer File & Storage Open source

Stampante Plugin Capacitor

Plugin Capacitor per stampare documenti, HTML, PDF, immagini e web view

Installa

bun add @capgo/capacitor-printer bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-printer
  • pnpm add @capgo/capacitor-printer
  • yarn add @capgo/capacitor-printer

Guida

Come usare Printer in Capacitor

Testa sul dispositivo

Scarica l'app Capgo, poi scansiona il QR code.

QR anteprima plugin stampante code

Utilizzo di @capgo/capacitor-printer

Plugin Capacitor per stampare documenti, HTML, PDF, immagini e web view.

Installa

bun add @capgo/capacitor-printer
bunx cap sync

Cosa espone questo plugin

  • printBase64 - Mostra l'interfaccia di stampa per file codificati come stringhe base64.
  • printFile - Mostra l'interfaccia di stampa per i file del dispositivo.
  • printHtml - Mostra l'interfaccia di stampa per documenti HTML.
  • printPdf - Mostra l'interfaccia di stampa per documenti PDF.

Esempio d'uso

printBase64

Mostra l'interfaccia di stampa per file codificati come stringhe 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

Mostra l'interfaccia di stampa per i file del dispositivo.

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

Mostra l'interfaccia di stampa per documenti 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

Mostra l'interfaccia di stampa per documenti 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',
});

Riferimento completo

Continua con l'uso di @capgo/capacitor-printer

Se stai usando Utilizzo di @capgo/capacitor-printer per pianificare il lavoro sui plugin nativi, collegalo a @capgo/capacitor-printer per i dettagli di implementazione in @capgo/capacitor-printer, Per iniziare per i dettagli di implementazione nella guida introduttiva, Directory dei plugin di Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Plugin Capacitor di Capgo, e Aggiunta o aggiornamento dei plugin per i dettagli di implementazione in Aggiunta o aggiornamento dei plugin.

FAQ

FAQ sul plugin Printer

Come installo il plugin Printer in un'app Capacitor?

Esegui "bun add @capgo/capacitor-printer" (o "npm install @capgo/capacitor-printer"), poi esegui "bunx cap sync" in modo che i progetti iOS e Android carichino il code nativo. Importalo da "@capgo/capacitor-printer" nel tuo code.

@capgo/capacitor-printer funziona con React, Vue e Angular?

Sì. Printer è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che gira dentro Capacitor, inclusi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor supporta @capgo/capacitor-printer?

I plugin Capgo seguono la major version di Capacitor: usa la major version del plugin che corrisponde alla tua major version di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

@capgo/capacitor-printer è gratuito e open source?

Sì. Il codice sorgente di code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-printer/ e il pacchetto si installa gratuitamente da npm. Bug report e pull request sono i benvenuti.

Posso aggiornare code che usa Printer senza passare dalla revisione dell'App Store?

Installare o aggiornare il plugin modifica il code nativo, quindi serve una nuova build per lo store. Dopo, le modifiche a JavaScript, HTML e CSS che chiamano il plugin possono essere rilasciate subito con le live updates di Capgo.

Pubblica modifiche alla stampante senza attendere la revisione dell'app

Una volta incluso il plugin nel tuo store build, Capgo invia le modifiche a JavaScript, HTML e CSS tramite live updates in pochi minuti.

Inizia con Capgo