Lompat ke konten utama
Kembali ke plugin
@capgo/capacitor-file-sharer
Tutorial
oleh github.com/Cap-go

Pemindai File

Bagikan dan simpan file dari data base64 atau jalur lokal di Android, iOS, dan Web

Petunjuk

Tutorial tentang Pemindai File

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 pada Web.
  • save - Simpan ke koleksi publik Android, buka sheet berbagi/save iOS, atau download pada 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 Pada 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

  • Android berbagi menggunakan FileProvider, ClipDatadan URI memberikan izin sehingga pemutar pratinjau dan miniatur dapat membaca file.
  • Android menyimpan menggunakan MediaStore pada Android 10+ dan direktori publik pada Android 9 dan di bawah.
  • iOS berbagi mendukung baik file sementara yang didukung base64 dan berbagi jalur lokal langsung.
  • Berbagi dan menyimpan unduhan file, dengan konversi base64 chunked untuk file besar.

Referensi Lengkap