Anleitung

Installieren

Sie können unsere KI-gestützte Einrichtung verwenden, um das Plugin zu installieren. Fügen Sie die Capgo-Fähigkeiten zu Ihrem KI-Tool hinzu, indem Sie die folgende Befehl ausführen:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Verwenden Sie dann die folgende Anfrage:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-file-sharer` plugin in my project.

Wenn Sie die manuelle Einrichtung bevorzugen, installieren Sie das Plugin, indem Sie die folgenden Befehle ausführen und folgen Sie den unten angegebenen Plattform-spezifischen Anweisungen:

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

Importieren

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

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

base64Data kann eine rohe Base64-Zeichenfolge oder eine Daten-URL wie data:application/pdf;base64,....

Ein lokales File teilen

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

Die native Implementierungen akzeptieren lokale Pfade, file:// URLs, Android content:// URIs und Capacitor _capacitor_file_ URLs.

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

Die Android-Speicherorte sind downloads, pictures, movies, music, und documents. Auf Android 10 und neuer schreibt der Plugin über MediaStore. Auf Android 9 und darunter verwenden öffentliche Speicherungen die Manifest WRITE_EXTERNAL_STORAGE Erlaubnis mit maxSdkVersion=28.

Mit einer Datei teilen

await FileSharer.share({
  filename: 'photo.jpg',
  contentType: 'image/jpeg',
  path: photoUri,
  title: 'Site photo',
  subject: 'Photo export',
  text: 'Captured during inspection.',
});

text wird als EXTRA_TEXT auf Android und als zweites Aktivitäts-Element auf iOS übergeben.

Typenverweis

ShareFileOptions

export interface ShareFileOptions {
  filename: string;
  base64Data?: string;
  path?: string;
  contentType?: string;
  text?: string;
  title?: string;
  subject?: string;
  android?: AndroidFileSharerOptions;
}

AndroidFileSharerOptions

export interface AndroidFileSharerOptions {
  chooserTitle?: string;
  saveDirectory?: 'downloads' | 'pictures' | 'movies' | 'music' | 'documents';
  relativePath?: string;
}

SaveFileResult

export interface SaveFileResult {
  uri?: string;
}

Fehlercodes

• ERR_PARAM_NO_FILENAME - filename wurde nicht oder ist leer.
• ERR_PARAM_NO_DATA - noch nicht base64Data noch nicht path wurde nicht bereitgestellt.
• ERR_PARAM_DATA_INVALID - Die Basis64-Eingabe konnte nicht dekodiert werden.
• ERR_LOCAL_FILE_NOT_FOUND - Der bereitgestellte lokale Pfad oder die Content-URI konnte nicht geöffnet werden.
• ERR_FILE_CACHING_FAILED - Die native temporäre Datei konnte nicht geschrieben werden.
• ERR_FILE_SAVE_FAILED - Android konnte die Datei nicht in der öffentlichen Speicherung speichern.
• ERR_ACTIVITY_NOT_FOUND - Android konnte ein Ziel zum Teilen nicht öffnen.
• USER_CANCELLED - Die iOS-Teilmenüschaltfläche wurde ohne Abschluss geschlossen.

Quelle der Wahrheit

Diese Seite verfolgt die Plugin-Einstellungen src/definitions.ts. Wenn sich die öffentliche API im Hintergrund ändert, führen Sie die Synchronisierung erneut durch.

Weiter von Getting Started

Wenn Sie "Getting Started" verwenden Um Speicher und Dateimanagement zu planen, verbinden Sie es mit Verwenden Sie @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-file-sharer für die native Fähigkeit in Verwenden Sie @capgo/capacitor-file-sharer @capgo/capacitor-data-storage-sqlite Verwenden Sie @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 Fähigkeit in Mit @capgo/capacitor-data-storage-sqlite, @capgo/capacitor-datei für die Implementierungsdetails in @capgo/capacitor-datei, und Mit @capgo/capacitor-datei für die native Fähigkeit in Mit @capgo/capacitor-datei.