Zum Hauptinhalt springen
@ capgo/ capacitor-dateiteiler Dateien & Speicher Offene Quelle

Datei-Teiler Capacitor-Plugin

Dateien teilen und speichern aus Basis64-Daten oder lokalen Pfaden über Android, iOS und Web

Installieren

bun add @capgo/capacitor-file-sharer bunx cap sync
npm, pnpm oder yarn
  • npm install @capgo/capacitor-file-sharer
  • pnpm add @capgo/capacitor-file-sharer
  • yarn add @capgo/capacitor-file-sharer

Anleitung

Wie man File Sharer in Capacitor verwendet

Testen auf Gerät

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

Vorschau-Link für das File-Sharer-Plugin-code

Verwendung von @capgo/capacitor-file-sharer

Teilen und Dateien aus Basis64-Daten, Daten-URLs, lokalen Dateipfaden 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 - Öffnen Sie das native Teilen-Sheet auf Android und iOS oder laden Sie das Datei auf Web herunter.
  • save - Speichern Sie auf Android öffentlichen Sammlungen, öffnen Sie das iOS-Speichern/Teilen-Sheet oder laden Sie auf Web herunter.
  • getPluginVersion - Rufen Sie die Version der Plattform-Implementierung auf.

Beispielverwendung

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

Eine 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);

Plattformhinweise

  • Android-Teilen verwendet FileProvider, ClipData, und URI-Grants, damit der Datei-Chooser Vorschau und Miniaturbilder lesen kann.
  • Android speichert die Datei in 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

Fortsetzen von Using @capgo/capacitor-dateisharer

Wenn Sie Using @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-dateisharer verwenden Using @capgo/capacitor-dateisharer um den Speicher und die Dateihandhabung zu planen, verbinden Sie es mit @capgo/capacitor-file-sharer für die Implementierungsdetails in @capgo/capacitor-Dateisharer Getting Started für die Implementierungsdetails in Einstieg @capgo/capacitor-Daten-Speicher-SQLite für die Implementierungsdetails in @capgo/capacitor-Daten-Speicher-SQLite Verwendung von @capgo/capacitor-Daten-Speicher-SQLite für die native Fähigkeit im @capgo/capacitor-Daten-Speicher-SQLite. @capgo/capacitor-Datei für die Implementierungsdetails in @capgo/capacitor-Datei.

FAQ

FAQ zur Datei-Teiler-Erweiterung

Wie installiere ich den File Sharer-Plugin in einer Capacitor-App?

Führen Sie "bun add @capgo/capacitor-file-sharer" (oder "npm install @capgo/capacitor-file-sharer"), dann führen Sie "bunx cap sync" aus, damit die iOS- und Android-Projekte die native code-Datei aufnehmen. Importieren Sie sie aus "@capgo/capacitor-file-sharer" in Ihrer code-Anwendung.

Funktioniert @capgo/capacitor-file-sharer mit React, Vue und Angular?

Ja. File Sharer ist ein Capacitor-Paket, daher funktioniert es mit jedem Webframework, das innerhalb von Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und plain JavaScript.

Welche Capacitor-Version unterstützt @capgo/capacitor-file-sharer?

Capgo-Plugins folgen der Capacitor-Majorsversion: Wählen Sie die Plugin-Majorsversion, die Ihrer Capacitor-Majorsversion entspricht (z.B. Plugin v8 mit Capacitor 8). Die Kompatibilitäts-Tabelle im GitHub-README enthält die unterstützten Versionen.

Ist @capgo/capacitor-file-sharer kostenlos und Open-Source?

Ja. Der Quellcode von code ist öffentlich auf GitHub unter https://github.com/Cap-go/capacitor-file-sharer/ verfügbar und das Paket kann kostenlos installiert werden von npm. Bug-Berichte und Pull-Anfragen sind willkommen.

Kann ich code, das File Sharer verwendet, ohne eine App-Store-Bewertung aktualisieren?

Das Installieren oder Upgraden des Plugins ändert die native code, daher benötigt es eine neue Store-Build. Anschließend können JavaScript-, HTML- und CSS-Änderungen, die den Plugin aufrufen, sofort mit Capgo-Live-Updates verschickt werden.

Dateien teilen ohne auf eine App-Überprüfung warten zu müssen

Einmal der Plugin in Ihrem Store-Builder ist, Capgo Live-Updates drücken Ihre JavaScript-, HTML- und CSS-Änderungen an die Benutzer in Minuten.

Mit Capgo beginnen