Saltare al contenuto principale
@capgo/capacitor-picker del file File & Archiviazione Sorgente aperta

Selettore di File Plugin Capacitor

Scegli file, immagini, video e directory con supporto nativo completo per iOS e Android, inclusa la conversione HEIC

Installa

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

Guida

Come utilizzare File Picker in Capacitor

Utilizzo di @capgo/capacitor-file-picker

Interfaccia del plugin Capacitor File Picker per la selezione di file, immagini, video e directory.

Installa

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

bunx cap sync copia il plugin nativo code nei tuoi progetti nativi. Esegui nuovamente dopo ogni aggiornamento del plugin.

Importa

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

API in un colpo d'occhio

Metodo Descrizione
pickFiles Scegli uno o più file dal dispositivo.
pickImages Scegli uno o più immagini dalla galleria. Disponibile solo per Android e iOS.
pickVideos Scegli uno o più video dalla galleria. Disponibile solo per Android e iOS.
pickMedia Scegli uno o più immagini o video dalla galleria. Disponibile solo per Android e iOS.
pickDirectory Scegli una directory dal dispositivo. Disponibile solo per Android e iOS.
convertHeicToJpeg Converti un'immagine HEIC in formato JPEG. Disponibile solo per iOS.
copyFile Copia un file in una nuova posizione.
checkPermissions Controlla lo stato delle autorizzazioni di archiviazione o media. Le flussi di picker non dovrebbero bloccare l'accesso. pickFiles(), pickImages(), pickVideos(), or pickMedia() Sulla autorizzazione di questo permesso su Android 13+. Solo Android.
requestPermissions Richiedi le autorizzazioni di archiviazione o media. Non richiedere o dichiarare READ_MEDIA_IMAGES Scegliere READ_MEDIA_VIDEO Usa solo le API del picker. Google Play consente queste autorizzazioni solo quando le alternative del picker non sono sufficienti per la funzionalità di base dell'app. @capgo/capacitor-file-picker Metodi del picker per l'accesso a file, immagini o video selezionati dall'utente. Disponibile solo per Android.

Esempi

pickFiles()

Scegli uno o più file dal dispositivo.

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()

Scegli uno o più immagini dalla galleria. Solo 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()

Scegli uno o più video dalla galleria. Solo 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()

Scegli uno o più immagini o video dalla galleria. Solo 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()

Scegli un directory dal dispositivo. Solo Android/iOS.

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

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

convertHeicToJpeg()

Converti un'immagine HEIC in formato JPEG. Solo per 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);

La tabella sopra elenca le 9 metodi di base. I listener e gli aiuti di versione, e il contratto completo di ogni metodo, sono documentati nel repository di GitHub.

Ascolta gli eventi

addListener ritorna un handle. Chiama handle.remove() quando lo schermo viene smontato, o CapgoFilePicker.removeAllListeners() per cancellare ogni listener.

Riferimento completo

Continua da Utilizza @capgo/capacitor-file-picker

If stai utilizzando Utilizzando @capgo/capacitor-file-picker per pianificare lo storage e la gestione dei file, collega @capgo/capacitor-file-picker per i dettagli di implementazione in @capgo/capacitor-file-picker, Getting Started per i dettagli di implementazione in Avvio, @capgo/capacitor-archiviazione-dati-sqlite per i dettagli di implementazione in @capgo/capacitor-data-storage-sqlite, Utilizzando @capgo/capacitor-data-storage-sqlite per la capacità nativa in Utilizzando @capgo/capacitor-data-storage-sqlite, e @capgo/capacitor-file per la dettagliata implementazione in @capgo/capacitor-file.

FAQ

FAQ del plugin File Picker

Come installare il plugin File Picker in un'app Capacitor?

Esegui "bun add @capgo/capacitor-file-picker" (o "npm install @capgo/capacitor-file-picker"), quindi esegui "bunx cap sync" affinché i progetti iOS e Android recuperino il nativo code. Importalo da "@capgo/capacitor-file-picker" nella tua app code.

Funziona @capgo/capacitor-file-picker con React, Vue e Angular?

Sì. File Picker è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che esegue all'interno di Capacitor, compresi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Qual è la versione Capacitor di @capgo/capacitor-file-picker?

Capgo plugin seguono la versione maggiore di Capacitor: utilizza la versione maggiore del plugin che corrisponde alla tua versione maggiore di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

È gratuito e open source @capgo/capacitor-file-picker?

Sì. Il codice sorgente code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-file-picker/ e il pacchetto è gratuito per l'installazione da npm. I rapporti di bug e le richieste di pull sono accetti.

Posso aggiornare code che utilizza File Picker senza una revisione dell'App Store?

L'installazione o l'aggiornamento del plugin modifica il nativo code, quindi richiede una nuova costruzione dello store. Dopo di che, le modifiche JavaScript, HTML e CSS che chiamano il plugin possono essere spediti istantaneamente con Capgo live updates.

Invia le modifiche del File Picker senza attendere la revisione dell'app.

Una volta che il plugin è presente nella tua store build, Capgo le aggiornamenti live inviano le tue modifiche JavaScript, HTML e CSS agli utenti in pochi minuti.

Inizia con Capgo