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

Pemilih File plugin Capacitor

Pilih file, gambar, video, dan direktori dengan dukungan native penuh untuk iOS dan Android, termasuk konversi HEIC

Instal

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

Panduan

Cara menggunakan File Picker di Capacitor

Menggunakan @capgo/capacitor-file-picker

Antarmuka plugin Capacitor File Picker untuk memilih file, gambar, video, dan direktori.

Instal

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

bunx cap sync menyalin code native plugin ke dalam proyek native Anda. Jalankan kembali setiap kali melakukan upgrade plugin.

Impor

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

Sekilas tentang API

Metode Deskripsi
pickFiles Pilih satu atau lebih file dari perangkat.
pickImages Pilih satu atau lebih gambar dari galeri. Hanya Android/iOS.
pickVideos Pilih satu atau lebih video dari galeri. Hanya Android/iOS.
pickMedia Pilih satu atau lebih gambar atau video dari galeri. Hanya Android/iOS.
pickDirectory Pilih direktori dari perangkat. Hanya Android/iOS.
convertHeicToJpeg Konversi gambar HEIC ke format JPEG. Hanya iOS.
copyFile Salin file ke lokasi baru.
checkPermissions Cek status izin media atau storage luas. Alur khusus Picker tidak boleh bergantung pickFiles(), pickImages(), pickVideos(), atau pickMedia() pada izin ini di Android 13+. Khusus Android.
requestPermissions Minta izin media atau storage luas. Jangan meminta atau mendeklarasikan izin READ_MEDIA_IMAGES atau READ_MEDIA_VIDEO hanya untuk menggunakan API picker. Google Play hanya mengizinkan izin ini jika alternatif picker tidak cukup untuk fungsi utama aplikasi. Gunakan @capgo/capacitor-file-picker metode picker untuk akses file, gambar, atau video pilihan user. Khusus Android.

Contoh

pickFiles()

Pilih satu atau lebih file dari perangkat.

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

const result = await CapgoFilePicker.pickFiles({
  types: ['application/pdf', 'image/*'],
  limit: 5,
  readData: false
});
console.log('Picked files:', result.files);

pickImages()

Pilih satu atau lebih gambar dari galeri. Khusus Android/iOS.

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

const result = await CapgoFilePicker.pickImages({
  limit: 10,
  readData: false
});
console.log('Picked images:', result.files);

pickVideos()

Pilih satu atau lebih video dari galeri. Khusus Android/iOS.

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

const result = await CapgoFilePicker.pickVideos({
  limit: 3,
  skipTranscoding: true
});
console.log('Picked videos:', result.files);

pickMedia()

Pilih satu atau lebih gambar atau video dari galeri. Khusus Android/iOS.

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

const result = await CapgoFilePicker.pickMedia({
  limit: 5,
  readData: true
});
console.log('Picked media:', result.files);

pickDirectory()

Pilih direktori dari perangkat. Hanya Android/iOS.

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

const result = await CapgoFilePicker.pickDirectory();
console.log('Selected directory:', result.path);

convertHeicToJpeg()

Konversi gambar HEIC ke format JPEG. Hanya iOS.

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

const result = await CapgoFilePicker.convertHeicToJpeg({
  path: '/path/to/image.heic',
  quality: 0.9
});
console.log('Converted file:', result.path);

Tabel di atas mencantumkan 9 metode inti. Listener, helper versi, dan kontrak lengkap setiap metode didokumentasikan di repositori GitHub.

Mendengarkan event

addListener mengembalikan sebuah handle. Panggil handle.remove() saat layar di-unmount, atau CapgoFilePicker.removeAllListeners() untuk menghapus semua listener.

Referensi lengkap

Lanjutkan dari bagian Menggunakan @capgo/capacitor-file-picker

Jika Anda menggunakan Menggunakan @capgo/capacitor-file-picker untuk merencanakan penyimpanan dan penanganan file, hubungkan dengan @capgo/capacitor-file-picker untuk detail implementasi di @capgo/capacitor-file-picker, 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 seputar plugin File Picker

Bagaimana cara install plugin File Picker di aplikasi Capacitor?

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

Apakah @capgo/capacitor-file-picker mendukung React, Vue, dan Angular?

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

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

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-picker gratis dan open source?

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

Bisakah saya update code yang memakai File Picker 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 Picker 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