Android Environment 类详解

时间:2023-03-09 00:50:12
Android Environment 类详解

Android应用开发中,常使用Environment类去获取外部存储目录,在访问外部存储之前一定要先判断外部存储是否已经是可使用(已挂载&可使用)状态,

并且需要在AndroidManifest.xml文件中添加外部存储读和写的权限。

根据官方API文档,接下来对android.os.Environment类做详细介绍。

一、Environment类中提供了多个String类型的静态常量用于标识外部存储媒体的状态。

public
static final String MEDIA_BAD_REMOVAL 在解除挂载前存储媒体已经被移除,常量值为“bad_removal”

public static final String MEDIA_CHECKING 存储媒体存在并在进行磁盘检查,常量值为“checking”

public
static final String MEDIA_MOUNTED 存储媒体已经挂载,并且挂载点可读/写,常量值为“mounted”

public
static final String MEDIA_MOUNTED_READ_ONLY 存储媒体已经挂载,挂载点只读,常量值为“mounted_ro”

public static final String MEDIA_NOFS 存储媒体存在,但空白或使用了不支持的文件系统,常量值“nofs”

public
static final String MEDIA_REMOVED 存储媒体不存在即被移除,常量值为“removed”

public static final String MEDIA_SHARED 存储媒体正在通过USB共享,常量值为“shared”

public static final String MEDIA_UNMOUNTABLE 存储媒体无法挂载,一种典型状况是文件系统损坏,常量值为“unmountable”

public static final String MEDIA_UNMOUNTED 存储媒体没有挂载,常量值为“unmounted”

public static final String MEDIA_UNKNOWN未知存储状态,例如不支持的存储路径,常量值为“unknown”

public static final String MEDIA_EJECTING
存储媒体正在卸载过程中,常量值为“ejecting”

注:以上存储媒体的状态均可通过方法getExternalStorageState()获得。

二、Environment类中的数据域提供了Android标准目录的路径,以static string类型提供。

public static String DIRECTORY_ALARMS 系统提醒铃声(闹铃、警报...)存放的标准目录。

public static String DIRECTORY_DCIM 相机拍摄照片和视频的标准目录。

public
static String DIRECTORY_DOCUMENTS 存放用户文件的标准目录。

public static String DIRECTORY_DOWNLOADS 存放用户下载内容的标准目录。

public static String DIRECTORY_MOVIES 电影存放的标准目录。

public static String DIRECTORY_MUSIC 音乐存放的标准目录。

public static String DIRECTORY_NOTIFICATIONS 系统通知铃声存放的标准目录。

public static String DIRECTORY_PICTURES 图片存放的标准目录。

public static String DIRECTORY_PODCASTS 系统广播存放的标准目录。

public static String DIRECTORY_RINGTONES 系统铃声存放的标准目录。

三、构造器(constructor)

public Environment()

四、公有方法(public methods)

public static File getDataDirectory ()

获得user data的目录

public static File getDownloadCacheDirectory ()

获得下载缓存内容的目录

public static File getExternalStorageDirectory ()

获得基本的共享或外部存储器目录。注:可以通过调用getExternalStorageState()方法类判断共享或外部存储器当前状态,从而得知其是否可以被访问。

public static File getExternalStoragePublicDirectory (String type)

获得用于存储特定类型文件的顶层共享或外部存储器目录。

public static String getExternalStorageState ()

获得外部存储器的当前状态。

返回值为 MEDIA_UNKNOWN,MEDIA_REMOVED,MEDIA_UNMOUNTED,MEDIA_CHECKING,MEDIA_NOFS, MEDIA_MOUNTED,MEDIA_MOUNTED_READ_ONLY,MEDIA_SHARED,MEDIA_BAD_REMOVAL,MEDIA_UNMOUNTABLE其中之一。

public static String getExternalStorageState (File path)

获得共享或外部存储器在给定路径的当前状态

public static File getRootDirectory ()

获得存储Android OS内核的系统分区的根目录,退出为只读的。

public static String getStorageState (File path)

API 21中弃用,代替使用getExternalStorageState(File path)

public static boolean isExternalStorageEmulated ()

......

public static boolean isExternalStorageEmulated (File path)

....

public static boolean isExternalStorageRemovable (File path)

判断共享或外部存储媒体在给定的路径是否是可移除的。

return true  如果存储设备可以被移除(eg:SD card)

return false 如果存储设备是内置存储器或其他不可移除的设备

public static boolean isExternalStorageRemovable ()

判断基本的共享或外部存储媒体是否是可移除的。

return true  如果存储设备可以被移除(eg:SD card)

return false 如果存储设备是内置存储器或其他不可移除的设备