Allez directement au contenu principal
@capgo/capacitor-partageur-de-fichiers Stockage & Fichiers Logiciel libre

Partage de fichiers plugin Capacitor

Partagez et sauvegardez 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

How to use File Sharer in Capacitor

Testez sur appareil

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

App Store Google Play
File Sharer plugin preview QR code

Utilisation de @capgo/capacitor-file-sharer

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

Installer

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

Ce que ce plugin expose

  • share - Ouvrez la feuille de partage native sur Android et iOS, ou téléchargez le fichier sur Web.
  • save - Sauvegardez dans les collections publiques Android, ouvrez la feuille de sauvegarde/partage iOS, ou téléchargez sur Web.
  • getPluginVersion - Renvoie la version de l'implémentation du système d'exploitation.

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

Remarques sur le système

  • La partage sur Android utilise FileProvider, ClipDataet les URI permettent aux prévisualisations et aux miniatures de lire le fichier.
  • Le sauvegarde sur Android utilise MediaStore sur Android 10+ et les répertoires publics sur Android 9 et en dessous.
  • iOS partage supporte à la fois des fichiers temporaires basés sur base64 et un partage de chemin local direct.
  • Partage et sauvegarde web télécharge le fichier, avec conversion base64 par morceaux pour les fichiers volumineux.

Référence complète

Continuez à partir de l'utilisation de @capgo/capacitor-file-sharer

Si vous utilisez L'utilisation de @capgo/capacitor-file-sharer pour planifier le stockage et la gestion des fichiers, connectez-l’avec @capgo/capacitor-file-sharer pour les détails d'implémentation dans @capgo/capacitor-file-sharer Documentation de démarrage pour les détails d'implémentation dans Documentation de démarrage @capgo/capacitor-stockage-de-données-sqlite pour les détails d'implémentation dans @capgo/capacitor-data-storage-sqlite, En utilisant @capgo/capacitor-data-storage-sqlite pour la capacité native dans En utilisant @capgo/capacitor-data-storage-sqlite, et @capgo/capacitor-fichier pour les détails d'implémentation dans @capgo/capacitor-fichier.

FAQ

FAQ du plugin de partage de fichiers

Comment installer le plugin de partage de fichiers dans une application Capacitor ?

Exécutez « bun add @capgo/capacitor-file-sharer » (ou « npm install @capgo/capacitor-file-sharer »), puis exécutez « bunx cap sync » afin que les projets iOS et Android prennent en compte le fichier natif code. Importez-l’à partir de « @capgo/capacitor-file-sharer » dans votre application code.

Le plugin @capgo/capacitor-file-sharer est-il gratuit et open source ?

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

Quelle version de Capacitor est prise en charge par @capgo/capacitor-file-sharer ?

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, plugin v8 avec Capacitor 8). La table de compatibilité dans le fichier README du GitHub liste les versions maintenues.

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

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

Can I update code that uses File Sharer without an App Store review?

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.

Fichiers & Stockage

Plugins connexes

Explorer tous les plugins →

Ship File Sharer changes without waiting for app review

Une fois le plugin dans votre magasin de build, Capgo les mises à jour en temps réel déclenchent vos modifications JavaScript, HTML et CSS chez les utilisateurs en quelques minutes.

Démarrez avec Capgo