File Sharer

Utilizzo di @capgo/capacitor-file-sharer

Condividi e salva file dai dati base64, dalle URL dei dati, dai percorsi dei file locali, file:// dalle URL, Android content:// dai URI, e Capacitor _capacitor_file_ dalle URL.

Installa

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

Cosa Questo Plugin Espone

• share - Apri la schermata di condivisione nativa su Android e iOS, o scarica il file su Web.
• save - Salva in collezioni pubbliche Android, apri la schermata di salvataggio/condivisione iOS, o scarica su Web.
• getPluginVersion - Restituisci la versione dell'implementazione della piattaforma.

Esempio di Utilizzo

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

Nota sulla piattaforma

• La condivisione su Android utilizza FileProvider, ClipDatae le autorizzazioni URI per consentire la visualizzazione di anteprime e miniaturine del file.
• La condivisione su Android utilizza MediaStore su Android 10+ e directory pubbliche su Android 9 e versioni precedenti.
• La condivisione su iOS supporta sia file temporanei con codifica base64 che condivisione diretta di percorsi locali.
• La condivisione e il salvataggio dei download scaricano il file, con conversione base64 a blocchi per file grandi.

Riferimento completo

• GitHub: https://github.com/Cap-go/capacitor-file-sharer/
• Documentazione: /docs/plugins/file-sharer/