DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion de Windows / Fonctions Système
  • Existence et disponibilité
  • Gestion des fichiers et de leur emplacement
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Renvoie le chemin d'un répertoire pour le stockage de fichiers dans l'espace de stockage externe d'un appareil Android.
A partir de Android 11, de nouvelles restrictions apparaissent pour les emplacements accessibles aux applications. Pour plus de détails sur les emplacements autorisés, consulter Android 11 : Modifications du comportement des applications.
Exemple
// Enregistrement d'une photo dans le répertoire de l'application
// sur l'espace de stockage externe primaire de l'application
sPhoto est une chaîne = VidéoLanceAppli(viCaptureImage)
SI sPhoto <> "" _ET_ SysEtatStockageExterne(1) = sseDisponible ALORS
fCopieFichier(sPhoto, SysRepStockageExterne(1, sseAppPhoto))
FIN
Syntaxe
<Résultat> = SysRepStockageExterne(<Indice> , <Type>)
<Résultat> : Chaîne de caractères
  • Chemin du répertoire spécifié.
  • Chaîne vide ("") en cas d'erreur.
<Indice> : Entier
Indice de l'espace de stockage externe à utiliser (si l'appareil possède plusieurs espaces de stockage externe).
Remarque : La fonction SysNbStockageExterne permet de connaître le nombre d'espaces de stockage externe de l'appareil.
<Type> : Constante de type Entier
Type de répertoire pour lequel le chemin sur l'espace de stockage externe est recherché. Ce paramètre peut correspondre à l'une des constantes suivantes :
sseAppDocumentRépertoire des documents de l'application.

Répertoire accessible en Lecture/Ecriture.
sseAppFichierRépertoire des fichiers spécifiques à l'application.

Répertoire accessible en Lecture/Ecriture.
sseAppMusiqueRépertoire des fichiers musicaux de l'application.

Répertoire accessible en Lecture/Ecriture.
sseAppPhotoRépertoire des photos de l'application.

Répertoire accessible en Lecture/Ecriture.
sseAppTéléchargementRépertoire des fichiers téléchargés par l'application.

Répertoire accessible en Lecture/Ecriture.
sseAppVidéoRépertoire des vidéos de l'application.

Répertoire accessible en Lecture/Ecriture.
ssePublicRépertoire racine de l'espace de stockage externe.

Répertoire accessible uniquement en lecture.
ssePublicDocumentRépertoire des documents partagés.

Répertoire accessible uniquement en lecture.
ssePublicMusiqueRépertoire des fichiers musicaux partagés.

Répertoire accessible uniquement en lecture.
ssePublicPhotoRépertoire des photos partagées.

Répertoire accessible uniquement en lecture.
ssePublicTéléchargementRépertoire des fichiers téléchargés partagés.

Répertoire accessible uniquement en lecture.
ssePublicVidéoRépertoire des vidéos partagés.

Répertoire accessible uniquement en lecture.
Remarques

Existence et disponibilité

  • Le répertoire correspondant au chemin retourné par la fonction SysRepStockageExterne peut ne pas exister. Il convient de tester son existence avec la fonction fRepExiste et/ou de le créer avec la fonction fRepCrée.
  • Avant d'accéder à un répertoire situé dans la zone de stockage externe de l'appareil, il est conseillé de tester sa disponibilité avec la fonction SysEtatStockageExterne.

Gestion des fichiers et de leur emplacement

  • Les fichiers de l'application qui ne doivent pas être partagés avec d'autres applications doivent être stockés dans le répertoire de l'application sur l'espace de stockage interne de l'application. Le chemin des différents sous-répertoires peut être connu avec les fonctions fRepEnCours, fRepExe, fRepDonnées et fRepCache.
  • Lors de la désinstallation de l'application, les fichiers regroupant les caractéristiques suivantes seront automatiquement supprimés par le système :
    • Les fichiers situés dans le répertoire de l'application sur l'espace de stockage externe
    • les fichiers correspondant aux constantes sseAppFichier, sseAppMusique, sseAppVidéo, sseAppPhoto, seeAppTéléchargement et sseAppDocument.
  • Les fichiers partagés de l'espace de stockage externe correspondant aux constantes ssePublic, ssePublicVidéo, ssePublicMusique , ssePublicPhoto, ssePublicDocument et ssePublicTéléchargement sont périodiquement scannés par le système pour être répertoriés. Les photos par exemple seront ensuite affichées dans les albums de l'appareil. Ces fichiers ne seront pas supprimés en cas de désinstallation de l'application.
  • A partir d'Android 4.4 (KitKat), si l'espace de stockage externe correspond à de la mémoire amovible (SDCard), les applications peuvent créer, modifier ou supprimer des fichiers uniquement dans leur propre répertoire (répertoires correspondant aux constantes sseAppXXX). Les autres fichiers présents dans l'espace de stockage externe sont accessibles en lecture uniquement.
  • A partir de Android 10, une application doit uniquement accéder aux fichiers présents dans des répertoires de l'application. L'accès à des fichiers situés en dehors de ces répertoires (en lecture ou en écriture) pourront échouer. Il est recommandé de ne pas utiliser les constantes du type ssePublicxxx pour éviter tout problème.
    Remarque : Pour les applications Android utilisées sous Android 10 et générées avec WINDEV Mobile, le fonctionnement est inchangé (si vous utilisez le correctif 118661 ou la version 25 Update 4 de WINDEV Mobile).
  • Lorsque l'application est exécutée sous Android 11, de nouvelles restrictions apparaissent :
    • une application ne peut plus lire ou écrire de fichiers sur le stockage externe en dehors :
      • des répertoires publics "Documents", "Download", "Images", etc. : utilisation de la fonction SysRepStockageExterne avec les constantes ssePublicXXX.
      • des répertoires propres à l'application : utilisation de la fonction SysRepStockageExterne avec les constantes sseAppXXX.
    • dans les répertoires publics, une application peut accéder (en lecture ou en écriture) uniquement aux fichiers qu'elle a elle-même créés.
      Remarque : si l'application est désinstallée puis réinstallée, elle n'aura plus accès aux fichiers créés par la précédente installation dans les répertoires publics du stockage externe.
Composante : wd290android.jar
Version minimum requise
  • Version 21
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 10/02/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale