browser.fileSystemProvider

Descrição

Permissões

Disponibilidade

Você precisa declarar a permissão e a seção "fileSystemProvider" no manifesto da extensão para usar a API File System Provider. Exemplo:

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

A seção "file_system_provider" precisa ser declarada da seguinte forma:

configurable (booleano): opcional

Se a configuração via onConfigureRequested é compatível. O padrão é "false".

multiple_mounts (booleano): opcional

Indica se vários sistemas de arquivos ativados (mais de um) são aceitos. O padrão é "false".

watchable (booleano): opcional

Se a definição de observadores e a notificação sobre mudanças são compatíveis. O padrão é "false".

source (enum de "file", "device" ou "network"): obrigatório

Origem dos dados para sistemas de arquivos montados.

O app Arquivos usa as informações acima para renderizar os elementos da interface relacionados de maneira adequada. Por exemplo, se configurable estiver definido como "true", um item de menu para configurar volumes será renderizado. Da mesma forma, se multiple_mounts estiver definido como true, o app Files permitirá adicionar mais de um ponto de montagem na interface. Se watchable for false, um botão de atualização será renderizado. Se possível, adicione suporte para observadores, assim as mudanças no sistema de arquivos podem ser refletidas imediatamente e de forma automática.

Visão geral

A API File System Provider permite que as extensões ofereçam suporte a sistemas de arquivos virtuais, que estão disponíveis no gerenciador de arquivos do ChromeOS. Os casos de uso incluem descompactar arquivos e acessar arquivos em um serviço de nuvem diferente do Drive.

Montar sistemas de arquivos.

As extensões podem fornecer conteúdo do sistema de arquivos de uma fonte externa (como um servidor remoto ou um dispositivo USB) ou usar um arquivo local (como um arquivo) como entrada.

Para gravar sistemas de arquivos que são gerenciadores de arquivos (a origem é "file"), o provedor precisa ser um app empacotado, já que o evento onLaunched não está disponível para extensões.

Se a origem for uma rede ou um dispositivo, o sistema de arquivos será montado quando o evento onMountRequested for chamado.

Como configurar sistemas de arquivos

Os sistemas de arquivos fornecidos, depois de montados, podem ser configurados pelo evento onConfigureRequested. Isso é especialmente útil para sistemas de arquivos que fornecem conteúdo pela rede para definir as credenciais adequadas. O processamento desse evento é opcional.

Ciclo de vida

Os sistemas de arquivos fornecidos, depois de montados, são lembrados pelo Chrome e remontados automaticamente após uma reinicialização. Portanto, depois que um sistema de arquivos é montado por uma extensão de fornecimento, ele permanece até que a extensão seja descarregada ou chame o método unmount.