Aller au contenu principal
@capgo/capacitor-printer Fichiers et stockage Open source

Imprimante Plugin Capacitor

Plugin Capacitor pour imprimer des documents, du HTML, des PDF, des images et des webviews

Installer

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

Guide

Comment utiliser Printer dans Capacitor

Tester sur l'appareil

Téléchargez l'application Capgo, puis scannez le QR code.

Aperçu QR du plugin Printer code

Utiliser @capgo/capacitor-printer

Plugin Capacitor pour l'impression de documents, HTML, PDF, images et web views.

Installer

bun add @capgo/capacitor-printer
bunx cap sync

Ce que ce plugin expose

  • printBase64 - Affiche l'interface d'impression pour les fichiers encodés en base64.
  • printFile - Affiche l'interface d'impression pour les fichiers de l'appareil.
  • printHtml - Affiche l'interface d'impression pour les documents HTML.
  • printPdf - Affiche l'interface d'impression pour les documents PDF.

Exemple d'utilisation

printBase64

Affiche l'interface d'impression pour les fichiers encodés en 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

Affiche l'interface d'impression pour les fichiers de l'appareil.

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

Affiche l'interface d'impression pour les documents 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

Affiche l'interface d'impression pour les documents 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',
});

Référence complète

Continuer avec l'utilisation de @capgo/capacitor-printer

Si vous utilisez Utiliser @capgo/capacitor-printer pour planifier le travail sur les plugins natifs, connectez-l’à @capgo/capacitor-printer pour le détail d’implémentation dans @capgo/capacitor-printer, Prise en main pour les détails d'implémentation dans Getting Started Capgo Répertoire des plugins pour le workflow produit dans Capgo Plugin Directory, Plugins Capacitor par Capgo pour les détails d'implémentation dans les plugins Capacitor par Capgo, et Ajouter ou mettre à jour des plugins pour les détails d'implémentation dans Adding or Updating Plugins.

FAQ

FAQ du plugin Printer

Comment installer le plugin Printer dans une application Capacitor ?

Exécutez &quot;bun add @capgo/capacitor-printer&quot; (ou &quot;npm install @capgo/capacitor-printer&quot;), puis lancez &quot;bunx cap sync&quot; pour que les projets iOS et Android prennent en compte le code natif. Importez-le depuis &quot;@capgo/capacitor-printer&quot; dans votre code.

Est-ce que @capgo/capacitor-printer fonctionne avec React, Vue et Angular ?

Oui. Printer est un package Capacitor, il fonctionne donc avec n'importe quel framework web qui s'exécute dans Capacitor, y compris Ionic, React, Vue, Angular, Svelte et JavaScript pur.

Quelle version de Capacitor est supportée par @capgo/capacitor-printer ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple le plugin v8 avec Capacitor 8). Le tableau de compatibilité du README de GitHub recense les versions maintenues.

Est-ce que @capgo/capacitor-printer est gratuit et open source ?

Oui. Le code source de code est public sur GitHub à l'adresse https://github.com/Cap-go/capacitor-printer/ et le package est gratuit à installer depuis npm. Les signalements de bugs et les pull requests sont les bienvenus.

Puis-je mettre à jour code utilisant Printer sans passer par une revue de l'App Store ?

L'installation ou la mise à jour du plugin modifie le code natif, ce qui impose un nouveau build pour les stores. Ensuite, les changements JavaScript, HTML et CSS qui appellent le plugin peuvent être livrés instantanément via les live updates de Capgo.

Déployez les changements de Printer sans attendre la validation de l'app

Une fois le plugin intégré à votre build de store, Capgo live updates déploie vos changements JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencez avec Capgo