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
- GitHub: https://github.com/Cap-go/capacitor-file-sharer/
- Dokumen: /docs/plugins/file-sharer/