Android存储(1)-- 你还在乱用Android存储嘛!!!

14,398 阅读12分钟

简介

Q: 为什么会单独详解Android存储这个模块? A: 进一步分析Google对Android存储模块的设计,最初只支持内部存储,到后来国内ROM厂商各自改造,人为的把内部存储分为Internal,External导致开发者对Androi存储系统产生很多迷惑。同时破坏了Android原有的生态系统,Google一直对这块都没有发布更新,直到Android6.0引入了适配存储(Adoptable Storage)的方式来支持外置的SD卡。

Q: 现有Android存储模块乱用现象有哪些? A: 1、随意创建文件夹 2、随意访问别的应用数据 3、私有数据和公有数据没有明显区分

存储区概念

所有的Android设备都有两块存储区域:Internal StorageExternal Storage。它们的名称来源于早期的Android系统,那时候大家的手机都内置(Permanent)一块较小存储板(即Internal Storage),并配上一个的外置的(Removable)储存卡(即External Storage)。后来部分手机开始将最初定义的Internal Storage,即内置存储,分成InternalExternal两部分。这样一来就算没有外置储存,手机也有InternalExternal两块存储区域。当手机可以插入外置SD卡的时候,这个时候插入的SD卡被称作Physical External Storage

这两块存储区域的区别是:

Internal Storage External Storage
可信度 永远可用(Permanent) 可能不可用,最典型的当设备作为USB存储被mount时不可用

封装库(对内外存储常用API封装)

Storage

使用

dependencies {
    compile 'io.github.changjiashuai:storage:1.1.0'
}

存储选项

Android系统中你有仔细考虑过数据的存储使用吗?例如数据应该是应用的私有数据,还是可供其他应用(和用户)访问,以及您的数据需要多少空间等。在Android提供了多种选项来保存永久性的应用数据。 本文介绍其中的两种方式(其余的另开博文介绍)。1、内部存储 2、外部存储 最后会针对这两种方式常用API进行封装,并提供library

扩展阅读

Android存储(2)--适配器存储 Android存储(3)--外部存储暴露给应用程序之前Android系统挂载过程 Android存储(4)--各种设备类型的外部存储配置示例:Emulated primary,Physical primary, physical secondary 从此再也不会为获取外置存储路径中出现emulated,0而疑惑啦


以下正式开始本文内容介绍

内部存储

在设备内存中存储私有数据。 内部存储在Android文件系统的位置是当我们在打开DDMS下的File Explorer面板的时候,/data目录就是所谓的内部存储(ROM)。但是注意,当手机没有root的时候不能打开此文件夹。 其中的两个目录重点说下:

  1. /data/app : app文件夹里存放着我们所有安装的app的apk文件
  2. /data/data: 第二个文件夹是data,也就是我们常说的/data/data目录(存储包私有数据)

应用内部私有数据:/data/data/包名/XXX 此目录下将每一个APP的存储内容按照包名分类存放好。 比如:

  1. data/data/包名/shared_prefs 存放该APP内的SP信息
  2. data/data/包名/databases 存放该APP的数据库信息
  3. data/data/包名/files 将APP的文件信息存放在files文件夹
  4. data/data/包名/cache 存放的是APP的缓存信息

您可以直接在设备的内部存储中保存文件。默认情况下,保存到内部存储的文件是应用的私有文件,其他应用(和用户)不能访问这些文件。当用户卸载您的应用时,这些文件也会被移除。Android对其提供了一些方法可以操作这些数据

要创建私有文件并写入到内部存储:

  1. 使用文件名称和操作模式调用openFileOutput()。这将返回一个FileOutputStream
  2. 使用write()写入到文件。
  3. 使用close()关闭流式传输。

要从内部存储读取文件:

  1. 调用openFileInput()并向其传递要读取的文件名称。这将返回一个FileInputStream
  2. 使用read()读取文件字节。
  3. 然后使用close()关闭流式传输。

保存缓存文件

如果您想要缓存一些数据,而不是永久存储这些数据,应该使用getCacheDir() 来打开一个File,它表示您的应用应该将临时缓存文件保存到的内部目录。

当设备的内部存储空间不足时,Android 可能会删除这些缓存文件以回收空间。 但您不应该依赖系统来为您清理这些文件, 而应该始终自行维护缓存文件,使其占用的空间保持在合理的限制范围内(例如 1 MB)。 当用户卸载您的应用时,这些文件也会被移除。

其他实用方法

getFilesDir() 获取在其中存储内部文件的文件系统目录的绝对路径。 getDir() 在您的内部存储空间内创建(或打开现有的)目录。 deleteFile() 删除保存在内部存储的文件。 fileList() 返回您的应用当前保存的一系列文件。

针对以上Android提供的API简单封装内部存储类如下:

public class Storage {
    ......

    public static class InternalStorage {

        /**
         * 获取在其中存储内部文件的文件系统目录的绝对路径。
         *
         * @return /data/data/包名/files
         */
        public static File getFilesDir(Context context) {
            return context.getFilesDir();
        }

        /**
         * @return 返回您的应用当前保存的一系列文件
         */
        public static String[] getFileList(Context context) {
            return context.fileList();
        }

        /**
         * @param name 文件名
         * @return 删除保存在内部存储的文件。
         */
        public static boolean deleteFile(Context context, String name) {
            return context.deleteFile(name);
        }

        /**
         * 向指定的文件中写入指定的数据
         *
         * @param name    文件名
         * @param content 文件内容
         * @param mode    MODE_PRIVATE | MODE_APPEND 自 API 级别 17 以来,常量 MODE_WORLD_READABLE 和
         *                MODE_WORLD_WRITEABLE 已被弃用
         */
        public static void writeFileData(Context context, String name, String content, int mode) {
            FileOutputStream fos = null;
            ...
                fos = context.openFileOutput(name, mode);
                fos.write(content.getBytes());
            ...
        }

        /**
         * 打开指定文件,读取其数据,返回字符串对象
         */
        public static String readFileData(Context context, String fileName) {
            String result = "";
            FileInputStream fis = null;
            ...
                fis = context.openFileInput(fileName);
            ...
        }
        
        /**
         * @param name 文件名
         * @param mode MODE_PRIVATE | MODE_APPEND 自 API 级别 17 以来,常量 MODE_WORLD_READABLE 和
         *             MODE_WORLD_WRITEABLE 已被弃用
         * @return 在您的内部存储空间内创建(或打开现有的)目录。
         * @see #writeFileData(Context, String, String, int)
         */
        public static File getDir(Context context, String name, int mode) {
            return context.getDir(name, mode);
        }

        /**
         * 将临时缓存文件保存到的内部目录。 使其占用的空间保持在合理的限制范围内(例如 1 MB)
         *
         * @return /data/data/包名/cache
         */
        public static File getCacheDir(Context context) {
            return context.getCacheDir();
        }

        /**
         * dir: data|user/0
         *
         * @return /data/{dir}/包名
         */
        public static File getDataDir(Context context) {
            return ContextCompat.getDataDir(context);
        }

    }
    ......
}

外部存储

在共享的外部存储中存储公共数据。

每个兼容 Android 的设备都支持可用于保存文件的共享“外部存储”。 该存储可能是可移除的存储介质(例如 SD 卡)或内部(不可移除)存储。 保存到外部存储的文件是全局可读取文件,而且,在计算机上启用 USB 大容量存储以传输文件后,可由用户修改这些文件。

注:如果用户在计算机上装载了外部存储或移除了介质,则外部存储可能变为不可用状态,并且在您保存到外部存储的文件上没有实施任何安全性。所有应用都能读取和写入放置在外部存储上的文件,并且用户可以移除这些文件。

获取外部存储的访问权限

要读取或写入外部存储上的文件,您的应用必须获取READ_EXTERNAL_STORAGEWRITE_EXTERNAL_STORAGE系统权限。 例如:

<manifest ...>
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    ...
</manifest>

如果您同时需要读取和写入文件,则只需请求 WRITE_EXTERNAL_STORAGE 权限,因为此权限也隐含了读取权限要求。

注:从 Android 4.4开始,如果您仅仅读取或写入应用的私有文件,则不需要这些权限。 如需了解更多信息,请参阅下面有关保存应用私有文件的部分。

检查介质可用性

在使用外部存储执行任何工作之前,应始终调用getExternalStorageState()以检查介质是否可用。介质可能已装载到计算机,处于缺失、只读或其他某种状态。

String state = Environment.getExternalStorageState();
state = MEDIA_UNKNOWN| MEDIA_REMOVED | MEDIA_UNMOUNTED |MEDIA_CHECKING | MEDIA_NOFS | MEDIA_MOUNTED | MEDIA_MOUNTED_READ_ONLY | MEDIA_SHARED | MEDIA_BAD_REMOVAL | MEDIA_UNMOUNTABLE

保存可与其他应用共享的文件

一般而言,应该将用户可通过您的应用获取的新文件保存到设备上的“公共”位置,以便其他应用能够在其中访问这些文件,并且用户也能轻松地从该设备复制这些文件。 执行此操作时,应使用共享的公共目录之一,例如 MusicPicturesRingtones等。

要获取表示相应的公共目录的File,请调用getExternalStoragePublicDirectory(),向其传递您需要的目录类型,例如DIRECTORY_MUSICDIRECTORY_PICTURESDIRECTORY_RINGTONES或其他类型。通过将您的文件保存到相应的媒体类型目录,系统的媒体扫描程序可以在系统中正确地归类您的文件(例如铃声在系统设置中显示为铃声而不是音乐)。

例如,以下方法在公共目录中创建了一个指定名称的目录:

public File getStoragePublicDirWithName(String type, String name) {
        // Get the directory for the user's public directory.
        File file = new File(getStoragePublicDirectory(type), name);
        if (!file.mkdirs()) {
        Log.e(TAG, "Directory not created");
    }
    return file;
}

保存应用私有文件

如果您正在处理的文件不适合其他应用使用(例如仅供您的应用使用的图形纹理或音效),则应该通过调用getExternalFilesDir()来使用外部存储上的私有存储目录。此方法还会采用type参数指定子目录的类型(例如DIRECTORY_MOVIES)。 如果您不需要特定的媒体目录,请传递null以接收应用私有目录的根目录。

Android 4.4开始,读取或写入应用私有目录中的文件不再需要READ_EXTERNAL_STORAGEWRITE_EXTERNAL_STORAGE权限。因此,您可以通过添加maxSdkVersion 属性来声明,只能在较低版本的Android中请求该权限:

<manifest ...>
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"
                     android:maxSdkVersion="18" />
    ...
</manifest>

注:当用户卸载您的应用时,此目录及其内容将被删除。此外,系统媒体扫描程序不会读取这些目录中的文件,因此不能从MediaStore内容提供程序访问这些文件。 同样,不应将这些目录用于最终属于用户的媒体,例如使用您的应用拍摄或编辑的照片或用户使用您的应用购买的音乐等 — 这些文件应保存在公共目录中。

有时,已分配某个内部存储器分区用作外部存储的设备可能还提供了SD卡槽。在使用运行Android 4.3和更低版本的这类设备时,getExternalFilesDir()方法将仅提供内部分区的访问权限,而您的应用无法读取或写入SD卡。不过,从Android 4.4开始,可通过调用getExternalFilesDirs()来同时访问两个位置,该方法将会返回包含各个位置条目的File数组。数组中的第一个条目被视为外部主存储;除非该位置已满或不可用,否则应该使用该位置。 如果您希望在支持Android 4.3 和更低版本的同时访问两个可能的位置,请使用支持库中的静态方法 ContextCompat.getExternalFilesDirs()。 在Android 4.3 和更低版本中,此方法也会返回一个File数组,但其中始终仅包含一个条目

注意: 尽管MediaStore内容提供程序不能访问getExternalFilesDir()getExternalFilesDirs()所提供的目录,但其他具有READ_EXTERNAL_STORAGE权限的应用仍可访问外部存储上的所有文件,包括上述文件。如果您需要完全限制您的文件的访问权限,则应该转而将您的文件写入到内部存储。

保存缓存文件

要打开表示应该将缓存文件保存到的外部存储目录的File,请调用getExternalCacheDir()。 如果用户卸载您的应用,这些文件也会被自动删除。

与前述ContextCompat.getExternalFilesDirs()相似,您也可以通过调用ContextCompat.getExternalCacheDirs()来访问辅助外部存储(如果可用)上的缓存目录。

提示:为节省文件空间并保持应用性能,您应该在应用的整个生命周期内仔细管理您的缓存文件并移除其中不再需要的文件,这一点非常重要。

针对以上Android提供的API简单封装内部存储类如下:

package io.github.changjiashuai.library;

import android.content.Context;
import android.os.Environment;
import android.support.v4.content.ContextCompat;
import android.util.Log;

import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.UnsupportedEncodingException;

import static android.content.ContentValues.TAG;

/**
 * <a href="https://developer.android.com/guide/topics/data/data-storage.html">data-storage</a>
 *
 * Email: changjiashuai@gmail.com
 *
 * Created by CJS on 2017/2/28 11:22.
 */

public class Storage {

    ......
    
    public static class ExternalStorage {
    
        /**
         * 判断外部设置是否有效
         */
        public static boolean isEmulated() {
            return Environment.isExternalStorageEmulated();
        }

        /**
         * 判断外部设置是否可以移除
         */
        public static boolean isRemovable() {
            return Environment.isExternalStorageEmulated();
        }

        public static String getStorageState() {
            return getExternalStorageState();
        }

        /* Checks if external storage is available for read and write */
        public static boolean isStorageWritable() {
            ...
        }

        /* Checks if external storage is available to at least read */
        public static boolean isStorageReadable() {
            ...
        }

        /**
         * @return /storage/emulated/0/Android/data/包名/cache
         */
        public static File getCacheDir(Context context) {
            return context.getExternalCacheDir();
        }

        public static File createDirInCacheDir(Context context, String name) {
            ...
        }

        public static String getCacheDirPath(Context context) {
            ...
        }

        public static File[] getCacheDirs(Context context) {
            return ContextCompat.getExternalCacheDirs(context);
        }

        /**
         * 保存应用私有文件
         * @return /storage/emulated/0/Android/data/包名/files/{type}
         */
        public static File getFilesDir(Context context, String type) {
            return context.getExternalFilesDir(type);
        }

        public static File createDirInFilesDir(Context context, String type, String name) {
            ...
        }

        public static String getFilesDirPath(Context context, String type) {
            ...
        }

        public static File[] getFilesDirs(Context context, String type) {
            return ContextCompat.getExternalFilesDirs(context, type);
        }

        /**
         * @return 保存可与其他应用共享的文件
         */
        @Deprecated
        public static File getStoragePublicDirectory(String type) {
            return Environment.getExternalStoragePublicDirectory(type);
        }

        public static File getStoragePublicDir(String type) {
            return Environment.getExternalStoragePublicDirectory(type);
        }

        /**
         * Writing to this path requires the
         * {@link android.Manifest.permission#WRITE_EXTERNAL_STORAGE} permission
         *
         * @param type 目录类型
         * @param name 目录名称
         * @return 在公共目录中创建了一个指定名称的目录:
         */
        public static File createDirInStoragePublicDir(String type, String name) {
            ...
        }

        public static String getStoragePublicDirPath(String type) {
            ...
        }

        /**
         * @return /storage/emulated/0/Android/data/包名
         */
        public static File getDataPkgDir(Context context) {
            ...
        }

        /**
         * @param name 文件名
         * @return /storage/emulated/0/Android/data/io.github.changjiashuai.storage/{name}
         */
        public static File createDirInDataPkgDir(Context context, String name) {
            ...
        }

        public static String getDataPkgDirPath(Context context) {
            ...
        }
    }

    ......
    
}

注意事项

  1. 自API级别17以来,常量MODE_WORLD_READABLEMODE_WORLD_WRITEABLE已被弃用。从Android N开始,使用这些常量将会导致引发SecurityException。这意味着,面向Android N和更高版本的应用无法按名称共享私有文件,尝试共享file://URI将会导致引发FileUriExposedException。如果您的应用需要与其他应用共享私有文件,则可以将FileProviderFLAG_GRANT_READ_URI_PERMISSION配合使用。另请参阅共享文件(后续会讲解)。
  2. 提示:如果在编译时想要保存应用中的静态文件,请在项目的res/raw/目录中保存该文件。可以使用openRawResource()打开该资源并传递R.raw.<filename>资源 ID。此方法将返回一个InputStream,您可以使用该流式传输读取文件(但不能写入到原始文件)。