File Sharer

Menggunakan @capgo/capacitor-file-sharer

Bagikan dan simpan file dari data base64, URL data, jalur file lokal, file:// URL, Android content:// URI, dan Capacitor _capacitor_file_ URL.

Pasang

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

Apa yang Dibuka oleh Plugin Ini

• share - Buka sheet berbagi native pada Android dan iOS, atau download file di Web.
• save - Simpan ke koleksi publik Android, buka sheet berbagi iOS, atau unduh di Web.
• getPluginVersion - Kembalikan versi implementasi platform.

Contoh Penggunaan

Bagikan File yang Dibuat

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

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

Bagikan File Lokal

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

Simpan ke Unduhan di 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);

Catatan Platform

• Berbagi Android menggunakan FileProvider, ClipData, dan URI grants sehingga chooser dapat menampilkan pratinjau dan thumbnail file.
• Android menyimpan menggunakan MediaStore di Android 10+ dan direktori publik di Android 9 dan di bawahnya.
• iOS berbagi mendukung baik file sementara yang didukung base64 dan berbagi jalur lokal langsung.
• Berbagi dan menyimpan di Web mengunduh file, dengan konversi base64 chunked untuk file besar.

Referensi Lengkap

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