Langkah Kedua ke Konten Utama
@capgo/capacitor-pemilih-file File & Penyimpanan Sumber Terbuka

Pilih Pemilih File plugin Capacitor

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

Install

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 Picker File di Capacitor

Menggunakan @capgo/capacitor-picker-file

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

Instal

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

bunx cap sync Menggandakan plugin asli code ke dalam proyek-proyek native Anda. Jalankan lagi setelah setiap pembaruan plugin.

Import

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

API secara singkat

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 Mengonversi gambar HEIC ke format JPEG. Hanya iOS.
copyFile Menggandakan file ke lokasi baru.
checkPermissions Periksa status izin penyimpanan luas atau media. Aliran picker hanya tidak boleh mengunci pickFiles(), pickImages(), pickVideos()atau pickMedia() izin ini pada Android 13+. Hanya Android.
requestPermissions Minta izin penyimpanan luas atau media. Jangan minta atau deklarasikan READ_MEDIA_IMAGES atau READ_MEDIA_VIDEO Hanya untuk menggunakan API pilihan. Google Play memungkinkan akses izin ini hanya ketika alternatif pilihan tidak cukup untuk fungsi aplikasi utama. Gunakan @capgo/capacitor-file-picker Menggunakan metode pemilih file, gambar, atau video yang dipilih pengguna. Hanya tersedia untuk Android.

Examples

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. Hanya tersedia untuk Android dan 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. Hanya tersedia untuk Android dan 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 dari galeri. Hanya 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 menampilkan 9 metode inti. Bantuan listener dan versi, serta kontrak lengkap dari setiap metode, dapat ditemukan di repository GitHub.

Dengarkan event

addListener mengembalikan sebuah handle. Panggil handle.remove() ketika layar dihapus, atau CapgoFilePicker.removeAllListeners() untuk membersihkan setiap pemanggil.

Referensi lengkap

Lanjutkan dari Menggunakan @capgo/capacitor-file-picker

Jika Anda menggunakan Menggunakan @capgo/capacitor-file-picker untuk merencanakan penyimpanan dan pengelolaan file, hubungkannya dengan @capgo/capacitor-file-picker untuk detail implementasi di @capgo/capacitor-file-picker, Mulai Menggunakan untuk detail implementasi di Getting Started, @capgo/capacitor-penyimpanan-data-sqlite untuk detail implementasi di @capgo/capacitor-data-storage-sqlite, Menggunakan @capgo/capacitor-data-storage-sqlite untuk kemampuan native di Menggunakan @capgo/capacitor-data-storage-sqlite, dan @capgo/capacitor-file untuk detail implementasi di @capgo/capacitor-file.

FAQ

Pertanyaan Umum Pilihan File

Bagaimana cara saya menginstal plugin Pilih File di aplikasi Capacitor?

Run "bun add @capgo/capacitor-file-picker" (or "npm install @capgo/capacitor-file-picker"), then run "bunx cap sync" so the iOS and Android projects pick up the native code. Import it from "@capgo/capacitor-file-picker" in your app code.

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

Yes. File Picker is a Capacitor package, so it works with any web framework that runs inside Capacitor, including Ionic, React, Vue, Angular, Svelte and plain JavaScript.

Apa versi Capacitor yang didukung oleh @capgo/capacitor-file-picker?

Capgo plugins follow Capacitor's major version: use the plugin major version that matches your Capacitor major version (for example plugin v8 with Capacitor 8). The compatibility table in the GitHub README lists the maintained versions.

Apakah @capgo/capacitor-file-picker gratis dan terbuka sumber?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-file-picker/ and the package is free to install from npm. Bug reports and pull requests are welcome.

Apakah saya dapat memperbarui code yang menggunakan File Picker tanpa melalui tinjauan App Store?

Installing or upgrading the plugin changes native code, so it needs a new store build. After that, JavaScript, HTML and CSS changes that call the plugin can ship instantly with Capgo live updates.

Kirim perubahan Picker File tanpa menunggu tinjauan aplikasi

Setelah plugin masuk dalam toko aplikasi Anda, Capgo pembaruan hidup memperbarui perubahan JavaScript, HTML, dan CSS Anda ke pengguna dalam menit.

Mulai dengan Capgo