Aller au contenu principal
@capgo/capacitor-file-sharer Fichiers et stockage Open source

Partage de fichiers Plugin Capacitor

Partagez et enregistrez des fichiers à partir de données base64 ou de chemins locaux sur Android, iOS et Web

Installer

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

Guide

Comment utiliser File Sharer dans Capacitor

Tester sur l'appareil

Téléchargez l'application Capgo, puis scannez le QR code.

App Store Google Play
QR de prévisualisation du plugin File Sharer code

Utiliser @capgo/capacitor-file-sharer

Share and save files from base64 data, data URLs, local file paths, file:// d’URL, d’Android content:// d’URIs et de Capacitor _capacitor_file_ d’URL.

Installer

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

Ce que ce plugin expose

  • share - Ouvrir la feuille de partage native sur Android et iOS, ou télécharger le fichier sur le Web.
  • save - Enregistrer dans les collections publiques Android, ouvrir la feuille d’enregistrement/partage iOS, ou télécharger sur le Web.
  • getPluginVersion - Renvoyer la version de l’implémentation de la plateforme.

Exemple d'utilisation

Partager un fichier généré

import { FileSharer } from '@capgo/capacitor-file-sharer';

await FileSharer.share({
  filename: 'report.pdf',
  contentType: 'application/pdf',
  base64Data: reportBase64,
  title: 'Quarterly report',
  text: 'Attached report',
});

Partager un fichier local

await FileSharer.share({
  filename: 'export.zip',
  contentType: 'application/zip',
  path: fileUri,
});

Enregistrer dans Téléchargements sur 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);

Notes de plateforme

  • Le partage sur Android utilise FileProvider, ClipData, et des autorisations URI pour que les aperçus et les miniatures du sélecteur puissent lire le fichier.
  • L’enregistrement sur Android utilise MediaStore sur Android 10+ et les répertoires publics sur Android 9 et antérieurs.
  • Le partage sur iOS prend en charge les fichiers temporaires basés sur base64 ainsi que le partage direct de chemins locaux.
  • Le partage Web et l’enregistrement téléchargent le fichier, avec conversion base64 par morceaux pour les fichiers volumineux.

Référence complète

Continuer après « Utiliser @capgo/capacitor-file-sharer »

Si vous utilisez Utiliser @capgo/capacitor-file-sharer pour planifier le stockage et la gestion des fichiers, connectez-l’à @capgo/capacitor-file-sharer pour les détails d’implémentation dans @capgo/capacitor-file-sharer, Prise en main pour les détails d'implémentation dans Getting Started @capgo/capacitor-data-storage-sqlite pour les détails d'implémentation dans @capgo/capacitor-data-storage-sqlite, Utiliser @capgo/capacitor-data-storage-sqlite pour la capacité native dans Using @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 Sharer

Comment installer le plugin File Sharer dans une application Capacitor ?

Exécutez « bun add @capgo/capacitor-file-sharer » (ou « npm install @capgo/capacitor-file-sharer »), puis lancez « bunx cap sync » pour que les projets iOS et Android récupèrent le code natif. Importez-le depuis « @capgo/capacitor-file-sharer » dans votre code.

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

Oui. File Sharer est un package Capacitor, il fonctionne donc avec n'importe quel framework web qui tourne dans Capacitor, y compris Ionic, React, Vue, Angular, Svelte et JavaScript vanilla.

Quelle version de Capacitor @capgo/capacitor-file-sharer prend-il en charge ?

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

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

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

Puis-je mettre à jour code qui utilise File Sharer sans passer par une revue de l’App Store ?

L'installation ou la mise à jour du plugin modifie le code natif, ce qui impose un nouveau build pour les stores. Ensuite, les changements JavaScript, HTML et CSS qui appellent le plugin peuvent être livrés instantanément via les live updates de Capgo.

Fichiers et stockage

Plugins associés

Parcourir tous les plugins →

Déployez les modifications de File Sharer sans attendre la revue de l'application

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.

Commencez avec Capgo