Sauter vers le contenu principal
@capgo/capacitor-partageur-de-fichiers Stockage & Fichiers Source

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 QR code.

Prévisualisation du QR code du plugin File Sharer

Utilisez @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 - Ouvrir la feuille de partage native sur Android et iOS, ou télécharger le fichier sur Web.
  • save - Enregistrer dans les collections publiques Android, ouvrir la feuille de sauvegarde/partage iOS, ou télécharger sur Web.
  • getPluginVersion - Retourner la version de l'implémentation du 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 les 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 du plateforme

  • - La partage sur Android utilise FileProvider, ClipDataet URI concède des choix de prévisualisation et de miniatures pour lire le fichier.
  • Android enregistre l'utilisation de MediaStore sur Android 10+ et des répertoires publics sur Android 9 et en dessous.
  • L'envoi de fichiers iOS prend en charge les fichiers temporaires basés sur base64 et les chemins de fichiers locaux directs.
  • 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 l'entrepôt et la gestion de fichiers, connectez-l’avec @capgo/capacitor-partageur-de-fichiers Pour les détails d'implémentation dans @capgo/capacitor-partageur-de-fichiers. Getting Started pour les détails d'implémentation dans Démarrage @capgo/capacitor-stockage-de-données-sqlite Pour les détails d'implémentation dans @capgo/capacitor-data-storage-sqlite. Utilisation de @capgo/capacitor-stockage-de-données-sqlite pour la capacité native en utilisant @capgo/capacitor-data-storage-sqlite, et @capgo/capacitor-fichier pour le détail d'implémentation dans @capgo/capacitor-fichier.

FAQ

Questions fréquentes sur le partage de fichiers

Comment installer le 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 les code natifs. Importez-l’à partir de « @capgo/capacitor-file-sharer » dans votre application code.

Le partage de fichiers @capgo/capacitor-file-sharer fonctionne-t-il avec React, Vue et Angular ?

Oui. Le partageur de fichiers est un Capacitor package, il fonctionne donc avec n'importe quel framework web qui tourne à l'intérieur de Capacitor, y compris Ionic, React, Vue, Angular, Svelte et JavaScript pur.

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 à votre version majeure de Capacitor (par exemple, plugin v8 avec Capacitor 8). La table de compatibilité dans le README du GitHub liste les versions maintenues.

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

Oui. Le code source de code est public sur GitHub à https://github.com/Cap-go/capacitor-file-sharer/ et le package est gratuit à installer depuis npm. Les rapports de bugs et les demandes de modification sont les bienvenus.

Puis-je mettre à jour code utilisant le partage de fichiers sans passer par une revue de l'App Store ?

L'installation ou la mise à jour du plugin modifie le code natif, il faut donc une nouvelle build de l'application. Une fois cela fait, les modifications JavaScript, HTML et CSS qui appellent le plugin peuvent être déployées instantanément avec les mises à jour Capgo.

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.

Commencez avec Capgo