Esta página foi traduzida pela API Cloud Translation.

Configuração do dispositivo

O armazenamento externo é gerenciado por uma combinação do serviço vold init e do serviço do sistema StorageManagerService . A montagem de volumes de armazenamento externo físico é tratada por vold , que executa operações de teste para preparar a mídia antes de expô-la aos aplicativos.

Observação: no Android 8.0, a classe MountService foi renomeada para StorageManagerService .

Mapeamentos de arquivos

Para Android 4.2.2 e anteriores, o arquivo de configuração vold.fstab específico do dispositivo define mapeamentos de dispositivos sysfs para pontos de montagem do sistema de arquivos, e cada linha segue este formato:

dev_mount <label> <mount_point> <partition> <sysfs_path> [flags]

label : Rótulo para o volume.
mount_point : Caminho do sistema de arquivos onde o volume deve ser montado.
partition : Número da partição (baseado em 1) ou 'auto' para a primeira partição utilizável.
sysfs_path : um ou mais caminhos sysfs para dispositivos que podem fornecer esse ponto de montagem. Separados por espaços, e cada um deve começar com / .
flags : lista opcional de sinalizadores separados por vírgulas, não deve conter / . Os valores possíveis incluem nonremovable e encryptable .

Para versões do Android 4.3 e posteriores, os vários arquivos fstab usados por init, vold e recovery foram unificados no /fstab.<device> . Para volumes de armazenamento externo gerenciados por vold , as entradas devem ter o seguinte formato:

<src> <mnt_point> <type> <mnt_flags> <fs_mgr_flags>

src : Um caminho em sysfs (geralmente montado em /sys) para o dispositivo que pode fornecer o ponto de montagem. O caminho deve começar com / .
mount_point : Caminho do sistema de arquivos onde o volume deve ser montado.
type : O tipo do sistema de arquivos no volume. Para placas externas, geralmente é vfat .
mnt_flags : Vold ignora este campo e deve ser definido como defaults
fs_mgr_flags : Vold ignora quaisquer linhas no fstab unificado que não incluam o voldmanaged= neste campo. Este sinalizador deve ser seguido por uma etiqueta descrevendo o cartão e um número de partição ou a palavra auto . Aqui está um exemplo: voldmanaged=sdcard:auto . Outros sinalizadores possíveis são nonremovable , encryptable=sdcard , noemulatedsd e encryptable=userdata .

Detalhes da configuração

As interações de armazenamento externo no nível da estrutura e acima dele são tratadas por meio do StorageManagerService . Devido a alterações de configuração no Android 6.0 (como a remoção da sobreposição de recursos storage_list.xml), os detalhes da configuração são divididos em duas categorias.

Android 5.xe anteriores

O arquivo de configuração storage_list.xml específico do dispositivo, normalmente fornecido por meio de uma sobreposição de frameworks/base , define os atributos e as restrições dos dispositivos de armazenamento. O elemento <StorageList> contém um ou mais elementos <storage> , exatamente um dos quais deve ser marcado como primário. Os atributos <storage> incluem:

mountPoint : caminho do sistema de arquivos desta montagem.
storageDescription : recurso de string que descreve esta montagem.
primary : true se esta montagem for o armazenamento externo primário.
removable : verdadeiro se esta montagem tiver mídia removível, como um cartão SD físico.
emulated : true se esta montagem for emulada e for suportada por armazenamento interno, possivelmente usando um daemon FUSE.
mtp-reserve : número de MB de armazenamento que o MTP deve reservar para armazenamento gratuito. Usado apenas quando mount está marcado como emulado.
allowMassStorage : true se esta montagem puder ser compartilhada via armazenamento em massa USB.
maxFileSize : tamanho máximo do arquivo em MB.

Os dispositivos podem fornecer armazenamento externo emulando um sistema de arquivos sem permissão e sem distinção entre maiúsculas e minúsculas, apoiado por armazenamento interno. Uma implementação possível é fornecida pelo daemon FUSE em system/core/sdcard , que pode ser adicionado como um serviço init.rc específico do dispositivo:

# virtual sdcard daemon running as media_rw (1023)
service sdcard /system/bin/sdcard <source_path> <dest_path> 1023 1023
    class late_start

Em que source_path é o armazenamento interno de apoio e dest_path é o ponto de montagem de destino.

Ao configurar um script init.rc específico do dispositivo, a variável de ambiente EXTERNAL_STORAGE deve ser definida como o caminho para o armazenamento externo primário. O caminho /sdcard também deve ser resolvido para o mesmo local, possivelmente por meio de um link simbólico. Se um dispositivo ajustar a localização do armazenamento externo entre as atualizações da plataforma, os links simbólicos devem ser criados para que os caminhos antigos continuem funcionando.

Android 6.0

A configuração do subsistema de armazenamento agora está concentrada no arquivo fstab específico do dispositivo e vários arquivos/variáveis de configuração estática históricos foram removidos para suportar um comportamento mais dinâmico:

A sobreposição de recursos storage_list.xml foi removida e não é mais usada pela estrutura. Os dispositivos de armazenamento agora são configurados dinamicamente quando detectados por vold .
As variáveis de ambiente EMULATED_STORAGE_SOURCE/TARGET foram removidas e não são mais usadas pelo Zygote para configurar pontos de montagem específicos do usuário. Em vez disso, a separação do usuário agora é aplicada com GIDs específicos do usuário e o armazenamento compartilhado primário é montado no local por vold em tempo de execução.
- Os desenvolvedores podem continuar a construir caminhos dinamicamente ou estaticamente dependendo de seu caso de uso. Incluir o UUID no caminho identifica cada cartão para tornar a localização mais clara para os desenvolvedores. (Por exemplo, /storage/ABCD-1234/report.txt é claramente um arquivo diferente de /storage/DCBA-4321/report.txt .)
Os serviços FUSE embutidos no código foram removidos dos arquivos init.rc específicos do dispositivo e, em vez disso, são bifurcados dinamicamente do vold quando necessário.

Além dessas mudanças de configuração, o Android 6.0 inclui a noção de armazenamento adotável. Para dispositivos Android 6.0, qualquer mídia física que não seja adotada é vista como portátil.

Armazenamento adotável

Para indicar um dispositivo de armazenamento adotável no fstab , use o atributo encryptable=userdata no campo fs_mgr_flags . Aqui está uma definição típica:

/devices/platform/mtk-msdc.1/mmc_host*           auto      auto     defaults
voldmanaged=sdcard1:auto,encryptable=userdata

Quando um dispositivo de armazenamento é adotado, a plataforma apaga o conteúdo e grava uma tabela de partição GUID que define duas partições:

uma pequena partição android_meta vazia que é reservada para uso futuro. O GUID do tipo de partição é 19A710A2-B3CA-11E4-B026-10604B889DCF.
uma grande partição android_ext que é criptografada usando dm-crypt e formatada usando ext4 ou f2fs , dependendo dos recursos do kernel. O GUID do tipo de partição é 193D1EA4-B3CA-11E4-B075-10604B889DCF.

Armazenamento portátil

No fstab , os dispositivos de armazenamento com o atributo voldmanaged são considerados portáteis por padrão, a menos que outro atributo como encryptable=userdata seja definido. Por exemplo, aqui está uma definição típica para dispositivos USB OTG:

/devices/*/xhci-hcd.0.auto/usb*             auto            auto    defaults
                                                    voldmanaged=usb:auto

A plataforma usa blkid para detectar tipos de sistema de arquivos antes da montagem, e os usuários podem optar por formatar a mídia quando o sistema de arquivos não for suportado.