Aller au contenu principal
@capgo/capacitor-file-picker Fichiers & stockage Open source

File Picker Plugin Capacitor

Sélectionnez des fichiers, images, vidéos et répertoires avec un support natif complet pour iOS et Android, incluant la conversion HEIC

Installer

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

Guide

Comment utiliser File Picker dans Capacitor

Utiliser @capgo/capacitor-file-picker

Le plugin Capacitor File Picker permet de sélectionner des fichiers, images, vidéos et répertoires.

Installer

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

bunx cap sync copie le code natif du plugin dans vos projets natifs. Relancez-l’après chaque mise à jour du plugin.

Importer

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

API en un coup d'œil

Méthode Description
pickFiles Sélectionnez un ou plusieurs fichiers sur l'appareil.
pickImages Sélectionnez une ou plusieurs images de la galerie. Android/iOS uniquement.
pickVideos Sélectionnez une ou plusieurs vidéos de la galerie. Android/iOS uniquement.
pickMedia Sélectionnez une ou plusieurs images ou vidéos de la galerie. Android/iOS uniquement.
pickDirectory Sélectionnez un répertoire sur l'appareil. Android/iOS uniquement.
convertHeicToJpeg Convertissez une image HEIC au format JPEG. iOS uniquement.
copyFile Copier un fichier vers un nouvel emplacement.
checkPermissions Check broad storage or media permission state. Picker-only flows should not gate pickFiles(), pickImages(), pickVideos(), ou pickMedia() de cette permission sur Android 13+. Android uniquement.
requestPermissions Demander les permissions étendues de stockage ou de médias. Ne demandez ni ne déclarez READ_MEDIA_IMAGES ou READ_MEDIA_VIDEO uniquement pour l'utilisation des API du picker. Google Play n'autorise ces permissions que lorsque les alternatives de sélection ne suffisent pas aux fonctionnalités de base de l'application. Utilisez @capgo/capacitor-file-picker picker methods instead for user-selected file, image, or video access. Android only.

Exemples

pickFiles()

Sélectionnez un ou plusieurs fichiers sur l'appareil.

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

Sélectionner une ou plusieurs images depuis la galerie. Android/iOS uniquement.

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

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

pickVideos()

Sélectionner une ou plusieurs vidéos depuis la galerie. Android/iOS uniquement.

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

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

pickMedia()

Sélectionner une ou plusieurs images ou vidéos depuis la galerie. Android/iOS uniquement.

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

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

pickDirectory()

Sélectionnez un répertoire sur l'appareil. Android/iOS uniquement.

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

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

convertHeicToJpeg()

Convertissez une image HEIC au format JPEG. iOS uniquement.

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

Le tableau ci-dessus liste les 9 méthodes principales. Les helpers de listener et de version, ainsi que le contrat complet de chaque méthode, sont documentés dans la dépôt GitHub.

Écouter les événements

addListener renvoie un handle. Appelez handle.remove() lorsque l'écran est démonté, ou CapgoFilePicker.removeAllListeners() pour supprimer chaque écouteur.

Référence complète

Continuer avec l'utilisation de @capgo/capacitor-file-picker

Si vous utilisez Utilisation de @capgo/capacitor-file-picker pour planifier le stockage et la gestion des fichiers, connectez-l’à @capgo/capacitor-file-picker pour les détails d'implémentation dans @capgo/capacitor-file-picker, Premiers pas pour les détails d'implémentation dans Premiers pas, @capgo/capacitor-data-storage-sqlite pour le détail d'implémentation dans @capgo/capacitor-data-storage-sqlite, Utilisation de @capgo/capacitor-data-storage-sqlite pour les capacités natives dans l'utilisation de @capgo/capacitor-data-storage-sqlite, et @capgo/capacitor-file pour les détails d'implémentation dans @capgo/capacitor-file.

FAQ

FAQ du plugin File Picker

Comment installer le plugin File Picker dans une application Capacitor ?

Exécutez "bun add @capgo/capacitor-file-picker" (ou "npm install @capgo/capacitor-file-picker"), puis lancez "bunx cap sync" pour que les projets iOS et Android prennent en compte le code natif. Importez-le depuis "@capgo/capacitor-file-picker" dans votre application code.

Est-ce que @capgo/capacitor-file-picker fonctionne avec React, Vue et Angular ?

Oui. File Picker est un package Capacitor, il fonctionne donc avec n'importe quel framework web tournant sous Capacitor, y compris Ionic, React, Vue, Angular, Svelte et en JavaScript pur.

Quelle version de Capacitor est supportée par @capgo/capacitor-file-picker ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à celle de votre Capacitor (par exemple le plugin v8 avec Capacitor 8). Le tableau de compatibilité du README de GitHub répertorie les versions maintenues.

Est-ce que @capgo/capacitor-file-picker est gratuit et open source ?

Oui. Le code source code est public sur GitHub à l'adresse https://github.com/Cap-go/capacitor-file-picker/ et le package est gratuit à installer via npm. Les rapports de bugs et les pull requests sont les bienvenus.

Puis-je mettre à jour code utilisant File Picker sans passer par une revue de l'App Store ?

L'installation ou la mise à niveau du plugin modifie le code natif, ce qui nécessite un nouveau build pour les stores. Ensuite, les modifications JavaScript, HTML et CSS qui appellent le plugin peuvent être déployées instantanément avec les live updates de Capgo.

Déployez les changements de File Picker sans attendre la validation de l'app

Une fois le plugin intégré à votre build de store, Capgo live updates déploie vos changements JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencer avec Capgo