Passer au contenu principal
Retour aux plugins
@capgo/capacitor-partageur-de-fichiers
Tutoriel
@capgo/capacitor-partageur-de-fichiers

Partageur de fichiers

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

Guide

Tutoriel sur le partage de fichiers

Utilisation de @capgo/capacitor-partageur-de-fichiers

Partager et sauvegarder des fichiers à partir de données base64, de URL de données, de chemins de fichiers locaux, file:// URL, Android content:// URIs, et Capacitor _capacitor_file_ URL.

Installation

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

Ce plugin expose

  • share - Ouvrir la feuille de partage native sur Android et iOS, ou télécharger le fichier sur le Web.
  • save - Sauvegarder dans les collections publiques Android, ouvrir la feuille de sauvegarde/partage iOS, ou télécharger sur le Web.
  • getPluginVersion - Retourner 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);

Remarques Sur La Plateforme

  • La partage sur Android utilise FileProvider, ClipData, et les autorisations URI pour que les prévisualisations et les miniatures du choix peuvent lire le fichier.
  • La sauvegarde sur Android utilise MediaStore sur Android 10+ et les répertoires publics sur Android 9 et en dessous.
  • La partage sur iOS prend en charge à la fois les fichiers temporaires basés sur base64 et la partage de chemin local direct.
  • La partage et la sauvegarde sur Web téléchargent le fichier, avec conversion base64 chunkée pour les fichiers importants.

Référence Complète

Continuez à partir de l'utilisation de @capgo/capacitor-partage-de-fichier

Si vous utilisez L'utilisation de @capgo/capacitor-partage-de-fichier pour planifier le stockage et la gestion des fichiers, connectez-vous à @capgo/capacitor-partage-de-fichier pour les détails d'implémentation dans @capgo/capacitor-partage-de-fichier, Démarrage 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, En utilisant @capgo/capacitor-data-storage-sqlite pour la capacité native dans En utilisant @capgo/capacitor-data-storage-sqlite, et @capgo/capacitor-file pour les détails d'implémentation dans @capgo/capacitor-file.