Datei-Teiler

Verwendung von @capgo/capacitor-dateiaustausch

Dateien teilen und speichern von Basis64-Daten, Daten-URLs, lokalen Dateipfaden, file:// URLs, Android content:// URIs und Capacitor _capacitor_file_ URLs.

Installieren

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

Was diese Erweiterung offenlegt

• share - Öffnen Sie das native Teilen-Sheet auf Android und iOS oder laden Sie die Datei auf Web herunter.
• save - Speichern Sie das Dokument in Android öffentlichen Sammlungen, öffnen Sie das iOS-Speichern/Teilen-Blatt oder laden Sie es auf Web herunter.
• getPluginVersion - Gibt die Version der Plattform-Implementierung zurück.

Beispielhafte Verwendung

Ein Generiertes Dokument 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',
});

Ein Lokales Dokument Teilen

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

Speichern Sie auf Downloads auf Android

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

console.log(result.uri);

Hinweise zur Plattform

• Android-Teilen verwendet FileProvider, ClipData, und URI-Grants, damit der Datei-Chooser-Vorschau und -Miniaturansichten den Datei-Inhalt lesen können.
• Android-Speichern verwendet MediaStore auf Android 10+ und öffentliche Ordner auf Android 9 und darunter.
• iOS-Teilen unterstützt sowohl base64-gestützte temporäre Dateien als auch direkte lokale Pfad-Teilen.
• Web-Teilen und -Speichern laden das Dokument herunter, wobei große Dateien mit chunked base64-Konvertierung umgewandelt werden.

Vollständige Referenz

• GitHub: https://github.com/Cap-go/capacitor-Datei-Teiler/
• Dokumentation: /docs/plugins/datei-teiler/