Guida
Come usare File Sharer in Capacitor
Utilizzo di @capgo/capacitor-file-sharer
Condividi e salva file da dati base64, data URL o percorsi file locali, file:// URL, Android content:// URI e Capacitor _capacitor_file_ URL.
Installa
bun add @capgo/capacitor-file-sharer
bunx cap sync
Cosa espone questo plugin
share- Apri il menu di condivisione nativo su Android e iOS, o scarica il file su Web.save- Salva nelle collezioni pubbliche di Android, apri il menu salva/condividi di iOS o scarica su Web.getPluginVersion- Restituisce la versione dell'implementazione della piattaforma.
Esempio d'uso
Condividi un file generato
import { FileSharer } from '@capgo/capacitor-file-sharer';
await FileSharer.share({
filename: 'report.pdf',
contentType: 'application/pdf',
base64Data: reportBase64,
title: 'Quarterly report',
text: 'Attached report',
});
Condividi un file locale
await FileSharer.share({
filename: 'export.zip',
contentType: 'application/zip',
path: fileUri,
});
Salva in Download su 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);
Note sulla piattaforma
- La condivisione su Android usa
FileProvider,ClipData, e i permessi URI per consentire a chooser preview e miniature di leggere il file. - Su Android 10+ viene utilizzato MediaStore, mentre su Android 9 e versioni precedenti vengono utilizzate le directory pubbliche.
- La condivisione su iOS supporta sia file temporanei in base64 che la condivisione tramite percorso locale diretto.
- La condivisione web e il salvataggio scaricano il file, con conversione base64 a blocchi per file di grandi dimensioni.
Riferimento completo
- GitHub: https://github.com/Cap-go/capacitor-file-sharer/
- Documentazione: /docs/plugins/file-sharer/
Continua con l'uso di @capgo/capacitor-file-sharer
Se stai usando Utilizzo di @capgo/capacitor-file-sharer per pianificare lo storage e la gestione dei file, collegalo a @capgo/capacitor-file-sharer per i dettagli di implementazione in @capgo/capacitor-file-sharer, Per iniziare per i dettagli di implementazione nella guida introduttiva, @capgo/capacitor-data-storage-sqlite per i dettagli di implementazione in @capgo/capacitor-data-storage-sqlite, Utilizzo di @capgo/capacitor-data-storage-sqlite per la funzionalità nativa in Utilizzo di @capgo/capacitor-data-storage-sqlite, e @capgo/capacitor-file per i dettagli di implementazione in @capgo/capacitor-file.