browser.fileSystemProvider

Descrizione

Autorizzazioni

Disponibilità

Per utilizzare l'API File System Provider, devi dichiarare l'autorizzazione e la sezione "fileSystemProvider" nel manifest dell'estensione. Ad esempio:

{
  "name": "My extension",
  ...
  "permissions": [
    "fileSystemProvider"
  ],
  ...
  "file_system_provider_capabilities": {
    "configurable": true,
    "watchable": false,
    "multiple_mounts": true,
    "source": "network"
  },
  ...
}

La sezione file_system_provider deve essere dichiarata come segue:

configurable (booleano) - facoltativo

Se la configurazione tramite onConfigureRequested è supportata. Per impostazione predefinita: false.

multiple_mounts (booleano) - facoltativo

Se sono supportati più file system montati. Per impostazione predefinita: false.

watchable (booleano) - facoltativo

Se è supportata l'impostazione di osservatori e la notifica delle modifiche. Per impostazione predefinita: false.

source (enumerazione di "file", "dispositivo" o "rete") - obbligatorio

Origine dei dati per i file system montati.

L'app File utilizza le informazioni riportate sopra per visualizzare correttamente gli elementi UI correlati. Ad esempio, se configurable è impostato su true, verrà visualizzata una voce di menu per la configurazione dei volumi. Allo stesso modo, se multiple_mounts è impostato su true, l'app File consentirà di aggiungere più di un punto di montaggio dalla UI. Se watchable è false, verrà visualizzato un pulsante di aggiornamento. Tieni presente che, se possibile, devi aggiungere il supporto per i watcher, in modo che le modifiche al file system possano essere riflesse immediatamente e automaticamente.

Panoramica

L'API File System Provider consente alle estensioni di supportare i file system virtuali, disponibili nel gestore di file su ChromeOS. I casi d'uso includono la decompressione degli archivi e l'accesso ai file in un servizio cloud diverso da Drive.

Montaggio di file system

Le estensioni possono fornire i contenuti del file system da un'origine esterna (ad esempio un server remoto o un dispositivo USB) oppure utilizzare un file locale (ad esempio un archivio) come input.

Per scrivere file system che sono gestori di file (l'origine è "file"), il fornitore deve essere un'app pacchettizzata, poiché l'evento onLaunched non è disponibile per le estensioni.

Se l'origine è la rete o un dispositivo, il file system deve essere montato quando viene chiamato l'evento onMountRequested.

Configurazione dei file system

Una volta montati, i file system forniti possono essere configurati tramite l'evento onConfigureRequested. È particolarmente utile per i file system che forniscono contenuti tramite rete per impostare le credenziali corrette. La gestione di questo evento è facoltativa.

Ciclo di vita

Una volta montati, i file system forniti vengono memorizzati da Chrome e rimontati automaticamente dopo il riavvio. Pertanto, una volta che un file system viene montato da un'estensione di fornitura, rimarrà tale finché l'estensione non viene scaricata o chiama il metodo unmount.