Datei-Sharer Capacitor Plugin

Verwendung von @capgo/capacitor-file-sharer

Dateien aus Base64-Daten, Data-URLs oder lokalen Dateipfaden teilen und speichern file:// URLs, Android content:// URIs und Capacitor _capacitor_file_ URLs.

Installieren

bun add @capgo/capacitor-file-sharer
bunx cap sync

Was dieses Plugin bereitstellt

• share - Öffnet das native Share-Sheet auf Android und iOS oder lädt die Datei im Web herunter.
• save - In öffentliche Android-Collections speichern, das iOS-Save/Share-Sheet öffnen oder im Web herunterladen.
• getPluginVersion - Gibt die Version der Plattform-Implementierung zurück.

Anwendungsbeispiel

Generierte Datei teilen

import { FileSharer } from '@capgo/capacitor-file-sharer';

await FileSharer.share({
  filename: 'report.pdf',
  contentType: 'application/pdf',
  base64Data: reportBase64,
  title: 'Quarterly report',
  text: 'Attached report',
});

Lokale Datei teilen

await FileSharer.share({
  filename: 'export.zip',
  contentType: 'application/zip',
  path: fileUri,
});

Auf Android in Downloads speichern

const result = await FileSharer.save({
  filename: 'backup.zip',
  contentType: 'application/zip',
  base64Data: zipBase64,
  android: {
    saveDirectory: 'downloads',
    relativePath: 'Download/My App',
  },
});

console.log(result.uri);

Plattform-Hinweise

• Android-Sharing nutzt FileProvider, ClipData, sowie URI-Berechtigungen, damit Chooser-Vorschauen und Thumbnails die Datei lesen können.
• Android-Speicherung nutzt MediaStore ab Android 10+ und öffentliche Verzeichnisse bei Android 9 und darunter.
• iOS-Sharing unterstützt sowohl base64-basierte temporäre Dateien als auch das Teilen direkter lokaler Pfade.
• Web-Sharing und Speichern lädt die Datei herunter, inklusive Chunked-Base64-Konvertierung für große Dateien.

Vollständige Referenz

• GitHub: https://github.com/Cap-go/capacitor-file-sharer/
• Docs: /docs/plugins/file-sharer/

Weiterlesen unter Verwendung von @capgo/capacitor-file-sharer

Wenn du es nutzt Verwendung von @capgo/capacitor-file-sharer um Speicher- und Dateiverwaltung zu planen, verbinde es mit @capgo/capacitor-file-sharer für Details zur Implementierung in @capgo/capacitor-file-sharer, Erste Schritte für die Implementierungsdetails in Erste Schritte, @capgo/capacitor-data-storage-sqlite für die Implementierungsdetails in @capgo/capacitor-data-storage-sqlite, Mit @capgo/capacitor-data-storage-sqlite für die native Funktion bei der Nutzung von @capgo/capacitor-data-storage-sqlite und @capgo/capacitor-file für die Implementierungsdetails in @capgo/capacitor-file.