Permissões e acesso a arquivos¶

Meta¶

Ajudá-lo a distinguir entre problemas de lógica de aplicativo e restrições de acesso a arquivos do sistema.

Plataformas Suportadas¶

iOS
macOS

Público-alvo¶

Usuários bloqueados por problemas de visibilidade de arquivos ou acesso ao destino
Testadores separando problemas de permissão de falhas na lógica do aplicativo

Pré-requisitos¶

Um caminho concreto de importação, exportação ou arrastar e soltar já falhou ou se comportou de forma inesperada
Você pode tentar novamente o mesmo caminho e observar se o sistema mostra um prompt de permissão

Etapas¶

Tente novamente o mesmo caminho e observe os prompts de permissão do sistema.
Confirme se o local de origem ou destino está realmente acessível ao aplicativo.
Verifique se a falha corresponde a uma regra específica da plataforma, como PNG -> Photos em iOS.
Registre o texto exato do erro e a localização aproximada envolvida.

Resultado¶

Você pode saber se o problema vem de restrições de acesso ao sistema ou de um problema diferente no nível do aplicativo.

Cenários de permissão mais comuns¶

o seletor de arquivos não pode ver os dados de destino
o sistema recusa o acesso após um arquivo ser selecionado
a exportação falha ao gravar no destino
salvar em Fotos falha em iOS
arrastar e soltar é bloqueado pelo sistema

Export save location and file access

Ordem de solução de problemas recomendada¶

Verifique se o sistema mostrou um prompt de permissão.
Confirme se os dados de destino estão armazenados em um local que o aplicativo possa acessar.
Em iOS, lembre-se que o destino Fotos se aplica apenas a PNG.
Em macOS, verifique se o destino do painel de salvamento é gravável.
Tente novamente exatamente o mesmo caminho e confirme se o problema se reproduz.

Alguns fatos de implementação que importam¶

Se o usuário cancelar a seleção de arquivos intencionalmente, o aplicativo não tratará isso como um alerta de erro.
A importação arrastar e soltar depende do sistema fornecer um fileURL válido; sem permissão, o aplicativo não pode resolver um.
Em iOS, exportar para Photos é um caminho distinto e não é o mesmo que uma exportação Files normal.

O que gravar¶

plataforma e versão do sistema
localização de destino aproximada
se o sistema mostrou um prompt de permissão
se a falha ocorreu durante a importação, exportação ou arrastar e soltar
o texto exato do erro

Perguntas comuns¶

O arquivo existe. Por que o selecionador não consegue ver isso?¶

Na maioria das vezes, isso é causado por restrições de escopo de acesso do sistema, em vez de o aplicativo não ter conhecimento do arquivo. Mova o arquivo para um local de acesso mais direto e tente novamente.

Se a exportação falhar, isso sempre significa que a exportação está quebrada?¶

Não. Um destino que não seja gravável, falta de permissões ou uma incompatibilidade entre o formato e o destino também pode causar falha na exportação.

Por que salvar em Fotos só é compatível com PNG?¶

Porque a implementação atual conecta apenas o caminho do Photos a PNG.