Langsung ke konten utama
@capgo/capacitor-file-sharer File & Penyimpanan Open source

Berbagi File plugin Capacitor

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

Instal

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

Panduan

Cara menggunakan File Sharer di Capacitor

Tes di perangkat

Download aplikasi Capgo, lalu scan QR code.

Pratinjau QR plugin File Sharer code

Menggunakan @capgo/capacitor-file-sharer

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

Instal

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

Apa yang Diekspos Plugin Ini

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

Contoh Penggunaan

Share File yang Dihasilkan

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 Downloads 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

  • Sharing Android menggunakan FileProvider, ClipData, dan izin URI agar pratinjau serta thumbnail chooser dapat membaca file.
  • Android menggunakan MediaStore pada Android 10+ dan direktori publik pada Android 9 ke bawah.
  • Sharing iOS mendukung file sementara berbasis base64 maupun sharing path lokal langsung.
  • Berbagi dan menyimpan via Web akan mengunduh file, dengan konversi base64 bertahap untuk file besar.

Referensi Lengkap

Lanjutkan dari Menggunakan @capgo/capacitor-file-sharer

Jika Anda menggunakan Menggunakan @capgo/capacitor-file-sharer untuk merencanakan penyimpanan dan penanganan file, hubungkan dengan @capgo/capacitor-file-sharer untuk detail implementasi di @capgo/capacitor-file-sharer, Panduan Memulai untuk detail implementasi di Getting Started, @capgo/capacitor-data-storage-sqlite untuk detail implementasi di @capgo/capacitor-data-storage-sqlite, Menggunakan @capgo/capacitor-data-storage-sqlite untuk kemampuan native di bagian Menggunakan @capgo/capacitor-data-storage-sqlite, dan @capgo/capacitor-file untuk detail implementasi di @capgo/capacitor-file.

FAQ

FAQ Plugin File Sharer

Bagaimana cara install plugin File Sharer di aplikasi Capacitor?

Jalankan "bun add @capgo/capacitor-file-sharer" (atau "npm install @capgo/capacitor-file-sharer"), lalu jalankan "bunx cap sync" agar proyek iOS dan Android mendeteksi code native. Import dari "@capgo/capacitor-file-sharer" di dalam code aplikasi Anda.

Apakah @capgo/capacitor-file-sharer bisa digunakan dengan React, Vue, dan Angular?

Ya. File Sharer adalah package Capacitor, jadi bisa digunakan dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript biasa.

Versi Capacitor mana yang didukung oleh @capgo/capacitor-file-sharer?

Plugin Capgo mengikuti versi mayor Capacitor: gunakan versi mayor plugin yang sesuai dengan versi mayor Capacitor Anda (contoh: plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub mencantumkan versi yang masih di-maintain.

Apakah @capgo/capacitor-file-sharer gratis dan open source?

Ya. Source code tersedia secara publik di GitHub pada https://github.com/Cap-go/capacitor-file-sharer/ dan paketnya gratis diinstal dari npm. Laporan bug dan pull request sangat kami terima.

Bisakah saya memperbarui code yang menggunakan File Sharer tanpa review App Store?

Instalasi atau upgrade plugin akan mengubah native code, jadi butuh build store baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin bisa langsung dikirim lewat live updates Capgo.

Rilis perubahan File Sharer tanpa menunggu review aplikasi

Setelah plugin ada di build store Anda, live updates Capgo akan mengirim perubahan JavaScript, HTML, dan CSS ke pengguna dalam hitungan menit.

Mulai dengan Capgo