AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Funciones WLanguage / Funciones estándar / Funciones de Windows / Funciones del sistema
  • Existencia y disponibilidad
  • Gestión de archivos y su ubicación
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
Devuelve la ruta del directorio que se utilizará para almacenar archivos en el espacio de almacenamiento externo del dispositivo Android.
En Android 11, las aplicaciones ya no pueden acceder a determinadas ubicaciones de almacenamiento. Para más detalles sobre los lugares de almacenamiento accesibles, consulte Android 11: Cambios en el comportamiento de las aplicaciones.
Ejemplo
// Save a photo in the application directory
// on the primary external storage space of application
sPhoto is string = VideoStartApp(viPictureCapture)
IF sPhoto <> "" _AND_ SysStatusExternalStorage(i) = sseAvailable THEN
fCopyFile(sPhoto, SysDirExternalStorage(1, sseAppPhoto))
END
Sintaxis
<Result> = SysDirExternalStorage(<Index> , <Type>)
<Result>: Cadena de caracteres
  • Ruta del directorio especificado.
  • Cadena vacía ("") si se produce un error.
<Index>: Integro
Índice del espacio de almacenamiento externo que se va a utilizar (si el dispositivo incluye varios espacios de almacenamiento externo).
Observación: SysNbExternalStorage devuelve el número de espacios de almacenamiento externos encontrados en el dispositivo.
<Type>: Constante de tipo Integer
Tipo de directorio para el que se busca la ruta al almacenamiento externo. Este parámetro puede ser una de las siguientes constantes:
sseAppDocumentDirectorio de documentos de aplicación.

Directorio accesible en modo Lectura/Escritura.
sseAppFileDirectorio de archivos específicos de la aplicación.

Directorio accesible en modo Lectura/Escritura.
sseAppMusicDirectorio de archivos de música de la aplicación.

Directorio accesible en modo Lectura/Escritura.
sseAppPhotoDirectorio de imágenes de aplicaciones.

Directorio accesible en modo Lectura/Escritura.
sseAppDownloadDirectorio de descargas de aplicaciones.

Directorio accesible en modo Lectura/Escritura.
sseAppVideoDirectorio de vídeos de aplicaciones.

Directorio accesible en modo Lectura/Escritura.
ssePublicDirectorio raíz del espacio de almacenamiento externo.

Directorio accesible en modo sólo lectura.
ssePublicDocumentDirectorio de documentos compartidos.

Directorio accesible en modo sólo lectura.
ssePublicMusicDirectorio de archivos de música compartidos.

Directorio accesible en modo sólo lectura.
ssePublicPhotoDirectorio de imágenes compartidas.

Directorio accesible en modo sólo lectura.
ssePublicDownloadDirectorio de archivos compartidos descargados.

Directorio accesible en modo sólo lectura.
ssePublicVideoDirectorio de vídeos compartidos.

Directorio accesible en modo sólo lectura.
Observaciones

Existencia y disponibilidad

  • El directorio que corresponde a la ruta devuelta por la función SysDirExternalStorage podría no existir. Debe comprobar su existencia con fDirExist y/o crearla con fMakeDir.
  • Antes de acceder a un directorio situado en el área de almacenamiento externo del dispositivo, se recomienda comprobar su disponibilidad con SysStatusExternalStorage.

Gestión de archivos y su ubicación

  • Los archivos de la aplicación que no deben ser compartidos con otras aplicaciones deben ser almacenados en el directorio de la aplicación en el espacio de almacenamiento interno de la aplicación. La ruta de los diferentes subdirectorios es devuelta por fCurrentDir, fExeDir, fDataDir y fCacheDir.
  • Al desinstalar la aplicación, el sistema borrará automáticamente los archivos que agrupan las siguientes características:
    • Los ficheros encontrados en el directorio de la aplicación en el espacio de memoria externo.
    • los archivos correspondientes a las constantes sseAppFile, sseAppMusic, sseAppVideo, sseAppPhoto, seeAppDownload y sseAppDocument.
  • Los archivos compartidos del espacio de almacenamiento externo corresponden a las constantes ssePublic, ssePublicVideo, ssePublicMusic , ssePublicPhoto, ssePublicDocument y ssePublicDownload son escaneados regularmente por el sistema que se va a enumerar. A continuación, las fotos, por ejemplo, se muestran en los álbumes del dispositivo.. Estos archivos no se eliminarán al desinstalar la aplicación.
  • A partir de Android 4.4 (KitKat), si el espacio de almacenamiento externo corresponde a la memoria móvil (SDCard), las aplicaciones pueden crear, modificar o eliminar archivos sólo en su propio directorio (directorios correspondientes a las constantes sseAppXXX). Los demás archivos que se encuentran en el espacio de almacenamiento externo son accesibles en modo de sólo lectura.
  • A partir de Android 10, las aplicaciones deben acceder únicamente a los archivos situados en sus propios directorios. Cualquier intento de acceder a archivos fuera de estos directorios (en modo de lectura o escritura) puede fallar. Se recomienda no utilizar las constantes ssePublicxxx para evitar errores.
    Observación: Las aplicaciones ejecutadas en Android 10 y generadas con WINDEV Mobile funcionarán como de costumbre (si utiliza el parche 118661 o WINDEV Mobile 25 Actualización 4)..
  • Cuando la aplicación se utiliza en un dispositivo que ejecuta Android 11, aparecen nuevas restricciones:
    • las aplicaciones ya no pueden leer o escribir archivos en el almacenamiento externo fuera de:
      • directorios públicos como "Documentos", "Descargas", "Imágenes", etc..: utilizar SysDirExternalStorage con las constantes ssePublicXXX.
      • directorios específicos de la aplicación: utilizar SysDirExternalStorage con las constantes sseAppXXX.
    • en los directorios públicos, una aplicación sólo puede acceder (en modo de lectura o escritura) a los archivos que ha creado.
      Observación: si la aplicación se desinstala y se vuelve a instalar, ya no tendrá acceso a los archivos creados por la versión previamente instalada en los directorios públicos del almacenamiento externo.
Componente: wd290android.jar
Versión mínima requerida
  • Versión 21
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 15/03/2023

Señalar un error o enviar una sugerencia | Ayuda local