Guida
Come utilizzare File in Capacitor
Utilizza @capgo/capacitor-file
Capacitor Plugin File Implementa operazioni sul sistema di file simili al plugin File di Cordova.
Installa
bun add @capgo/capacitor-file
bunx cap sync
bunx cap sync copia il code nativo del plugin nei tuoi progetti nativi. Esegui nuovamente dopo ogni aggiornamento del plugin.
Importa
import { CapacitorFile } from '@capgo/capacitor-file';
Vedi API in un colpo d'occhio
| Metodo | Descrizione |
|---|---|
requestFileSystem |
Richiedi un sistema di file. |
resolveLocalFileSystemURL |
Risolve un URL di file a un'entry. |
getFile |
Ottieni un'entry di file. |
getDirectory |
Ottieni un'entry di directory. |
readFile |
Lega un file come testo o base64. |
readAsDataURL |
Lega un file come un URL di dati (base64 con prefisso MIME). |
writeFile |
Scrivi dati in un file. |
appendFile |
Aggiungi dati a un file. |
deleteFile |
Cancella un file. |
mkdir |
Crea una directory. |
rmdir |
Cancella una directory. |
readdir |
Leggi i contenuti del directory. |
stat |
Ottieni metadati su un file o directory. |
getMetadata |
Ottieni metadati su un file o directory. Alias per stat(). |
rename |
Rinomina o sposta un file o directory. |
move |
Sposta un file o directory. Alias per rename(). |
copy |
Copia un file o directory. |
exists |
Controlla se un file o directory esiste. |
getUri |
Ottieni l'URI per un file. |
truncate |
Tronca un file a una dimensione specificata. |
getDirectories |
Ottieni tutti i directory del sistema file noti. |
getFreeDiskSpace |
Ottieni lo spazio libero del disco in byte. |
checkPermissions |
Controlla lo stato di permesso corrente per le operazioni sui file. Su Android, questo controlla le autorizzazioni di archiviazione esterna. Su iOS e web, questo restituisce sempre 'concesso' poiché non sono necessarie autorizzazioni speciali. |
requestPermissions |
Richiedi le autorizzazioni per le operazioni sui file. Su Android, ciò richiede le autorizzazioni di archiviazione esterna necessarie per accedere ai file al di fuori dei directory privati dell'app. Su iOS e web, questo restituisce sempre 'concesso' poiché non sono necessarie autorizzazioni speciali. |
Esempi
requestFileSystem()
Richiedi un sistema di file.
import { CapacitorFile, FileSystemType } from '@capgo/capacitor-file';
const result = await CapacitorFile.requestFileSystem({ type: FileSystemType.TEMPORARY });
console.log(result);
resolveLocalFileSystemURL()
Risolve una URL di file in un'entry.
import { CapacitorFile } from '@capgo/capacitor-file';
const result = await CapacitorFile.resolveLocalFileSystemURL({ url: 'https://example.com' });
console.log(result);
getFile()
Ottieni un'entry di file.
import { CapacitorFile } from '@capgo/capacitor-file';
const result = await CapacitorFile.getFile({ path: 'path/to/file' });
console.log(result);
getDirectory()
Ottieni un'entry di directory.
import { CapacitorFile } from '@capgo/capacitor-file';
const result = await CapacitorFile.getDirectory({ path: 'path/to/file' });
console.log(result);
readFile()
Leggi un file come testo o base64.
import { CapacitorFile } from '@capgo/capacitor-file';
const result = await CapacitorFile.readFile({ path: 'path/to/file' });
console.log(result);
readAsDataURL()
Leggi un file come una URL dei dati (base64 con prefisso MIME).
import { CapacitorFile } from '@capgo/capacitor-file';
const result = await CapacitorFile.readAsDataURL({ path: 'path/to/file' });
console.log(result);
I metodi elencati nella tabella sopra sono 24. I listener e gli aiuti per la versione, nonché il contratto completo di ogni metodo, sono documentati nella repository GitHub.
Ascolta gli eventi
addListener restituisce un handle. Chiama handle.remove() quando lo schermo viene smontato, o CapacitorFile.removeAllListeners() per cancellare tutti gli ascoltatori.
Tutte le informazioni
Continua da Utilizzo di @capgo/capacitor-file
Se stai utilizzando Utilizzo di @capgo/capacitor-file per pianificare lo storage e la gestione dei file, collegalo con @capgo/capacitor-file per i dettagli di implementazione in @capgo/capacitor-file, Getting Started per i dettagli di implementazione in Avvio, @capgo/capacitor-archiviazione-dati-sqlite per i dettagli di implementazione in @capgo/capacitor-archiviazione-dati-sqlite, Utilizzare @capgo/capacitor-archiviazione-dati-sqlite per la capacità nativa in Utilizzare @capgo/capacitor-archiviazione-dati-sqlite, e uploader per capgo-capacitor per il dettaglio di implementazione in @capgo/capacitor-uploader.