向Android外置TF卡中写入数据

发表于 2022-10-26 分类于 Android 本文字数： 3.4k

通过DocuemntFile读写外置TF卡数据

判断是否存在外置TF卡

文中为了防止手机机身储存与外接储存卡的名称混淆，将手机机身储存称为：内置SD卡；将外接储存卡称为：外置TF卡

获取设备的所有存储卷路径

使用反射的方式获取到getVolumePaths()方法，该方法可以获取设备上所有可用存储卷的路径，获取之后将所有存储卷的路径放置在数组中

public static String[] getAllExternal(Context context) {
    StorageManager storageManager = (StorageManager) context.getSystemService(Context.STORAGE_SERVICE);
    try {
        Method getVolumePaths = storageManager.getClass().getMethod("getVolumePaths");
        return (String[]) getVolumePaths.invoke(storageManager);
    } catch (Exception e) {
        e.printStackTrace();
    }
    return null;
}

获取外置TF卡储存路径

就一般情况而言，如果打包后的apk运行在手机上，那么代码数组中第一个储存卷路径是内置SD卡路径，第二个储存卷路径是外置TF卡路径(如果有)
当然也存在特殊情况，例如手机没有接入外置TF卡，但是通过数据接口接入了U盘，那么第二个储存卷路径就是该U盘的路径

public static String getTFCardPath(Context context) {
    // 获取设备的所有存储卷路径
    String[] allExternal = getAllExternal(context);
    // 所有储存卷路径的个数至少要存在两个
    if (allExternal != null && allExternal.length >= 2) {
        return allExternal[1];
    }
    return null;
}

获取外置TF卡挂载状态

方法中使用反射的方式获取到getVolumeState()方法，该方法用于获取指定存储卷的状态，储存卷的状态包括以下几种

mounted：已挂载
unmounted：已卸载

mounted_ro：以只读方式挂载

public static String getTFCardState(Context context) {
    // ### 获取外置TF卡储存路径
    String tfCardPath = getTFCardPath(context);
    if (tfCardPath != null) {
        StorageManager storageManager = (StorageManager) context.getSystemService(Context.STORAGE_SERVICE);
        try {
            Method getVolumeState = storageManager.getClass().getMethod("getVolumeState", String.class);
            return (String) getVolumeState.invoke(storageManager, tfCardPath);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
    return null;
}

使用方式

例如获取外置TF卡可用储存空间

public static long getTFAvailableSize(Context context) {
    String tfCardState = getTFCardState(context);
    // 外置TF卡是否已经挂载
    if (tfCardState != null && tfCardState.equals(Environment.MEDIA_MOUNTED)){
        StatFs statFs = new StatFs(getTFCardPath(context));
        int blockSize = statFs.getBlockSize();
        int availableBlocks = statFs.getAvailableBlocks();
        return (long) blockSize * availableBlocks;
    }
    return -1;
}

读写外置TF卡文件

在Android 4.4之后的版本中，读写外置TF卡数据要通过SAF框架，使用DocumentFile来对文件或文件夹进行操作。
下文中操作外置TF卡中的文件基于一个封装的DocumentFileUtils类，DocumentFileUtils工具类封装的可以查看封装DocumentFile

请求权限

创建工具类对象需要传入一个文件目录，一定要将外置TF卡根目录传入，因为传入的目录就是申请权限的目录，一个目录拥有权限后，该目录下的所有文件及文件夹都将拥有读写权限

public void requestPermission(Activity activity) {
    // 获取外置TF卡路径
    String tfCardPath = getTFCardPath(activity);
    // 创建DocumentFileUtils对象，一定要传入外置TF卡根路径
    DocumentFileUtils documentFileUtils = new DocumentFileUtils(activity, tfCardPath);
    // 申请权限
    documentFileUtils.requestPermission(activity, 10001);
}

跳转到文件夹权限并授权后，在回调阿onActivityResult()方法中判断申请结果，如果权限申请成功需要保存权限

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == 10001 && documentFileUtils != null) {
        // 保存权限
        documentFileUtils.savePermission(requestCode, data);
    }
}

获取文件夹或文件对象

获取文件的DocumentFile对象，如果该文件不存在，将会自动创建，创建后的新文件大小为0

1	DocumentFile documentFile = documentFileUtils.getDocumentFile(filePath, true);

获取文件夹的DocumentFile对象，如果文件夹不存在，将会自动创建

1	DocumentFile documentFile = documentFileUtils.getDocumentFile(filePath, false);