Saltare al contenuto principale
@capgo/capacitor-condividi-file File & Archiviazione Sorgente aperta

Condivisore di File Plugin Capacitor

Condividi e salva file da dati base64 o percorsi locali su Android, iOS e Web

Installa

bun add @capgo/capacitor-file-sharer bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-file-sharer
  • pnpm add @capgo/capacitor-file-sharer
  • yarn add @capgo/capacitor-file-sharer

Guida

Come utilizzare File Sharer in Capacitor

Testa sul dispositivo

Scarica l'app Capgo, poi scansa il codice QR code.

App Store Google Play
Anteprima del plugin File Sharer QR code

Utilizza @capgo/capacitor-file-sharer

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

Installa

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

Cos'è che questo Plugin Espone

  • share - Apri la schermata di condivisione nativa su Android e iOS, o scarica il file su Web.
  • save - Salva nelle raccolte pubbliche di Android, apri la schermata di salvataggio/condivisione di 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 Android utilizza FileProvider, ClipData, e le autorizzazioni URI consentono di visualizzare anteprime e miniatura del file.
  • La condivisione Android salva utilizza MediaStore su Android 10+ e directory pubbliche su Android 9 e sotto.
  • La condivisione iOS supporta sia file temporanei con supporto base64 che condivisione diretta di percorso locale.
  • La condivisione e il salvataggio web scaricano il file, con conversione base64 a blocchi per file grandi.

Riferimento completo

Continua da Utilizza @capgo/capacitor-file-sharer

Se stai utilizzando Utilizza @capgo/capacitor-file-sharer per pianificare lo storage e la gestione dei file, collega @capgo/capacitor-file-sharer per i dettagli di implementazione in @capgo/capacitor-file-sharer Guida per l'uso per i dettagli di implementazione in Guida per l'uso @capgo/capacitor-archiviazione-dati-sqlite per i dettagli di implementazione in @capgo/capacitor-data-storage-sqlite, Utilizzando @capgo/capacitor-data-storage-sqlite per la capacità nativa in Utilizzando @capgo/capacitor-data-storage-sqlite, e @capgo/capacitor-file per i dettagli di implementazione in @capgo/capacitor-file.

FAQ

Domande frequenti del plugin File Sharer

Come posso installare il plugin File Sharer in un'app Capacitor?

Esegui "bun add @capgo/capacitor-file-sharer" (o "npm install @capgo/capacitor-file-sharer"), quindi esegui "bunx cap sync" affinché i progetti iOS e Android recuperino il nativo code. Importalo da "@capgo/capacitor-file-sharer" nella tua app code.

Funziona @capgo/capacitor-file-sharer con React, Vue e Angular?

Sì. File Sharer è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che esegue all'interno di Capacitor, compresi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Qual è la versione di Capacitor supportata da @capgo/capacitor-file-sharer?

I plugin Capgo seguono la versione maggiore di Capacitor: utilizza la versione del plugin maggiore che corrisponde alla tua versione maggiore di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

È gratuito e open source @capgo/capacitor-file-sharer?

Sì. Il codice sorgente code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-file-sharer/ e il pacchetto è gratuito da installare su npm. Sono accetti i rapporti di bug e le richieste di pull.

Posso aggiornare code che utilizza File Sharer senza una revisione dell'App Store?

Installing or upgrading the plugin changes native code, so it needs a new store build. After that, JavaScript, HTML and CSS changes that call the plugin can ship instantly with Capgo live updates.

File e archiviazione

Plugin correlati

Visualizza tutti i plugin →

Condividi le modifiche del File Sharer senza attendere la revisione dell'app

Una volta che il plugin è presente nella tua build di store, Capgo le aggiornamenti in tempo reale inviano le modifiche JavaScript, HTML e CSS ai utenti in pochi minuti.

Inizia con Capgo