Version du document v2026.05.16.0

Télécharger le PDF

Autorisations et accès aux fichiers

But

Vous aider à faire la distinction entre les problèmes de logique d'application et les restrictions d'accès aux fichiers système.

Plateformes prises en charge

• iOS
• macOS

Public visé

• Utilisateurs bloqués par des problèmes de visibilité des fichiers ou d'accès à la destination
• Testeurs séparant les problèmes d'autorisation des échecs de la logique de l'application

Conditions préalables

• Un chemin concret d'importation, d'exportation ou de glisser-déposer a déjà échoué ou s'est comporté de manière inattendue
• Vous pouvez réessayer le même chemin et observer si le système affiche une invite d'autorisation

Mesures

1. Réessayez le même chemin et surveillez les invites d'autorisation du système.
2. Confirmez que l'emplacement source ou de destination est réellement accessible à l'application.
3. Vérifiez si l'échec correspond à une règle spécifique à la plate-forme telle que PNG -> Photos sur iOS.
4. Enregistrez le texte d'erreur exact et l'emplacement approximatif impliqué.

Résultat

• Vous pouvez savoir si le problème provient de restrictions d'accès au système ou d'un autre problème au niveau de l'application.

Scénarios d'autorisation les plus courants

• le sélecteur de fichiers ne peut pas voir les données cibles
• le système refuse l'accès après la sélection d'un fichier
• l'exportation échoue lors de l'écriture vers la destination
• l'enregistrement dans Photos échoue sur iOS
• le glisser-déposer est bloqué par le système

Ordre de dépannage recommandé

1. Vérifiez si le système a affiché une invite d'autorisation.
2. Confirmez que les données cibles sont stockées dans un emplacement auquel l'application peut accéder.
3. Sur iOS, rappelez-vous que la destination Photos s'applique uniquement à PNG.
4. Sur macOS, vérifiez que la destination du panneau de sauvegarde est accessible en écriture.
5. Réessayez exactement le même chemin et vérifiez si le problème se reproduit.

Quelques faits importants sur la mise en œuvre

• Si l'utilisateur annule intentionnellement la sélection de fichiers, l'application ne le traite pas comme une alerte d'erreur.
• L'importation par glisser-déposer dépend du système fournissant un fileURL valide ; sans autorisation, l’application ne peut pas en résoudre un.
• Sur iOS, l'exportation vers Photos est un chemin distinct et n'est pas identique à une exportation Files normale.

Quoi enregistrer

• version de la plateforme et du système
• emplacement de destination approximatif
• si le système a affiché une invite d'autorisation
• si l'échec s'est produit lors de l'importation, de l'exportation ou du glisser-déposer
• le texte d'erreur exact

Questions courantes

Le fichier existe. Pourquoi le sélecteur ne peut-il pas le voir ?

La plupart du temps, cela est dû à des restrictions d’accès au système plutôt qu’à l’ignorance du fichier par l’application. Déplacez le fichier vers un emplacement plus directement accessible et réessayez.

Si l’exportation échoue, cela signifie-t-il toujours que l’exportation est interrompue ?

Non. Une destination qui n'est pas accessible en écriture, des autorisations manquantes ou une incompatibilité entre le format et la destination peuvent également entraîner un échec d'exportation.

Pourquoi l'enregistrement dans Photos prend-il uniquement en charge PNG ?

Parce que l’implémentation actuelle connecte uniquement le chemin Photos à PNG.