Zum Hauptinhalt springen
Zurück zu Plugins
@capgo/capacitor-dateien-teilen
Tutorial
@capgo/capacitor-dateien-teilen

Dateien teilen

Dateien teilen und speichern von base64-Daten oder lokalen Pfaden über Android, iOS und Web

Leitfaden

Tutorial zum Datei-Teiler

Auf Gerät testen

Laden Sie die Capgo-App herunter, dann scannen Sie die QR-Code code.

Datei-Teiler-Plugin-Vorschau-QR code

Mit @capgo/capacitor-datei-teiler

Dateien teilen und speichern Sie von Base64-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 dieses Plugin bereitstellt

  • share - Öffnen Sie das native Teilen-Sheet auf Android und iOS oder laden Sie die Datei auf Web.
  • save - Speichern Sie in Android-Publikations-Sammlungen, öffnen Sie das iOS-Speichern/Teilen-Sheet oder laden Sie auf Web.
  • getPluginVersion - Rufen Sie die Plattformimplementierungsversion ab.

Beispielhafte Verwendung

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

Eine Lokale Datei Teilen

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

Auf Downloads Speichern (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);

Plattform Hinweise

  • Android Teilen verwendet FileProvider, ClipData, und URI-Grants, damit der Datei-Chooser Vorschau und Miniaturbilder lesen kann.
  • 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 herunterlädt die Datei, mit chunked base64-Umwandlung für große Dateien.

Vollständige Referenz

Fortfahren von Using @capgo/capacitor-dateiverteiler

Wenn Sie "@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-dateiverteiler" verwenden Verwenden Sie @capgo/capacitor-dateiverteiler um die Speicherplanung und Dateiverwaltung zu planen, verbinden Sie es mit @capgo/capacitor-dateiverteiler zur Implementierungsdetail in @capgo/capacitor-dateiverteiler, Anleitung zum Starten zur Implementierungsdetail in Anleitung zum Starten, @capgo/capacitor-datenspeicher-sqlite zur Implementierungsdetail in @capgo/capacitor-datenspeicher-sqlite, Verwenden Sie @capgo/capacitor-datenspeicher-sqlite für die native Fähigkeit in @capgo/capacitor-data-storage-sqlite und @capgo/capacitor-datei für die Implementierungsdetails in @capgo/capacitor-datei.