Passer à la navigation principale
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

Tester sur appareil

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

Prévisualisation du lien QR du plugin File Sharer code

Utilisation de @capgo/capacitor-file-sharer

Partager et sauvegarder des fichiers à partir de données base64, de URL de données, de chemins de fichiers locaux, d'URL, d'Android, d'URI et __CAPGO_KEEP_0__ file:// URLs. content:// URIs, and Capacitor _capacitor_file_ Ce que ce plugin expose

- Ouvrir la feuille de partage native sur Android et iOS, ou télécharger le fichier sur le Web.

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

- Sauvegarder dans les collections publiques d'Android, ouvrir la feuille de sauvegarde/partage d'iOS, ou télécharger sur le Web.

  • share Installez
  • save - Ouvrir la feuille de partage native sur Android et iOS, ou télécharger le fichier sur le Web.- Sauvegarder dans les collections publiques d'Android, ouvrir la feuille de sauvegarde/partage d'iOS, ou télécharger sur le Web.
  • getPluginVersion - Retourner 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 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.
  • Le partage sur iOS prend en charge à la fois les fichiers temporaires basés sur base64 et le partage de chemin de local direct.
  • Le partage et l'enregistrement de téléchargement sur Web téléchargent le fichier, avec conversion base64 chunkée 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 Démarrage pour les détails d'implémentation dans Démarrage @capgo/capacitor-data-storage-sqlite pour le détail 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 for the implementation detail in @capgo/capacitor-file.