Obtém o diretório interno ou externo de um dispositivo móvel.

Figura 1 - Bloco Obter Diretório

Para dispositivos Android, o diretório obtido faz parte da memória interna do aparelho. Esse diretório é parte do local de armazenamento persistente e privado, o que significa dizer que a informação guardada se mantém retida, ainda que, por exemplo, o dispositivo seja desligado e essa mesma informação está limitada ao diretório privado que a aplicação tem acesso.

Em dispositivos IOS o diretório obtido não é sincronizado com o armazenamento em nuvem iCloud.

Compatibilidade

• Bloco cliente: cronapi.cordova.file.getDirectory()

Retorno

Retorna uma string com o diretório do dispositivo móvel no formato file:///caminho/para/arquivo/.

Parâmetros

Tipo

Tipo de diretório a ser obtido do dispositivo móvel (Android).

• Posição: 1
• Inglês: Type
• Tipo: Texto / String
• Exemplo: "INTERNO"
• Opções:
  • INTERNO: Diretório pertencente ao armazenamento interno do dispositivo. Por padrão, arquivos salvos no armazenamento interno são privados para sua aplicação, não sendo possível o acesso de outras aplicações ou até mesmo do usuário.
  • EXTERNO: Caso o dispositivo Android seja compatível com "armazenamento externo", é possível utilizar esse local para salvar arquivos. Esse local pode ser uma mídia de armazenamento removível (como um cartão SD) ou um armazenamento interno (não removível). Os arquivos salvos no armazenamento externo são legíveis de forma global e podem ser modificados pelo usuário quando eles habilitam o armazenamento em massa USB para transferir arquivos em um computador.

Exemplo

A função abaixo obtém o diretório interno do dispositivo móvel.

Figura 2 - Função que obtém o diretório interno do dispositivo

A figura 2.1 exibe o caminho interno do diretório mobile.

Figura 2.1 - Caminho interno do diretório mobile

A figura 2.2 exibe o caminho externo do diretório mobile.

Figura 2.2 - Caminho externo do diretório mobile