Android文件选择的实现方法及注意事项

一、准备工作

在实现Android文件选择前，我们需要做一些准备工作。

首先，需要在AndroidManifest.xml文件中添加以下权限：

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

这两个权限分别用于读取和写入外部存储器的数据。如果我们需要向外部存储器中写入数据，需要在运行时向用户请求授权。

其次，我们需要在项目中添加依赖库FilePicker，可以在build.gradle文件的dependencies中添加以下代码：

dependencies {
    implementation 'com.github.droidbyme:filepicker:2.1.2'
}

这个库可以协助我们处理文件选择的相关操作。

二、使用库实现文件选择

在添加了依赖库FilePicker之后，我们就可以在代码中使用它提供的类和方法来实现文件选择功能。

首先，我们需要构造FilePickerBuilder对象，并设置一些选项，比如选择模式、文件类型和文件路径等，如下所示：

FilePickerBuilder.getInstance().setMaxCount(1)
    .setSelectedFiles(filePaths)
    .setActivityTheme(R.style.AppTheme)
    .addFileSupport("ZIP", zipTypes)
    .setActivityTitle("Select ZIP file")
    .enableDocSupport(false)
    .pickFile(MainActivity.this);

这个对象的pickFile()方法会打开文件选择器界面，并让用户选择文件。选择完成后，我们可以在onActivityResult()方法中接收返回的文件路径：

@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == FilePickerConst.REQUEST_CODE) {
        if (resultCode == Activity.RESULT_OK && data != null) {
            ArrayList<String> filePaths = data.getStringArrayListExtra(FilePickerConst.KEY_SELECTED_FILES);
            // 文件路径处理
        }
    }
}

在获得选择的文件路径之后，我们可以根据需要进行一些文件处理的操作，比如读取文件内容、上传文件等。

三、注意事项

在使用Android文件选择的过程中，有一些需要注意的事项：

1、我们需要考虑用户授权的问题。在Android 6.0及以上版本中，需要在运行时向用户请求授权。我们可以使用Android提供的类似于AlertDialog的对话框来实现这一操作。

2、文件路径处理可能会遇到NullPointException等异常，需要进行异常处理。

3、在选择多个文件时，返回的文件路径可能是一个ArrayList，需要进行循环处理。

4、在文件处理时，需要关注文件类型、文件大小和文件内容等问题。

5、如果需要在应用程序中进行文件操作，需要获取外部存储器的写入权限。

完整代码示例

下面是一个完整的Android文件选择和读取的代码示例：

// 请求权限
private void requestPermission() {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
        if (ContextCompat.checkSelfPermission(this,
                Manifest.permission.READ_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
            ActivityCompat.requestPermissions(this,
                    new String[]{Manifest.permission.READ_EXTERNAL_STORAGE},
                    MY_PERMISSIONS_REQUEST_READ_EXTERNAL_STORAGE);
        }
    }
}

// 授权回调函数
@Override
public void onRequestPermissionsResult(int requestCode, String[] permissions,
                                       int[] grantResults) {
    switch (requestCode) {
        case MY_PERMISSIONS_REQUEST_READ_EXTERNAL_STORAGE: {
            if (grantResults.length > 0
                    && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                // 权限已授予，可以进行文件操作
            } else {
                // 权限被拒绝，无法进行文件操作
            }
            return;
        }
    }
}

// 打开文件选择器
private void openFilePicker() {
    String[] zipTypes = new String[]{"zip", "rar"};
    FilePickerBuilder.getInstance().setMaxCount(1)
            .setActivityTheme(R.style.AppTheme)
            .addFileSupport("ZIP", zipTypes)
            .setActivityTitle("Select ZIP file")
            .pickFile(MainActivity.this);
}

// 处理返回的文件路径
@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == FilePickerConst.REQUEST_CODE) {
        if (resultCode == Activity.RESULT_OK && data != null) {
            ArrayList<String> filePaths = data.getStringArrayListExtra(FilePickerConst.KEY_SELECTED_FILES);
            if (filePaths.size() > 0) {
                String filePath = filePaths.get(0);
                File file = new File(filePath);
                if (file.isFile() && file.exists() && file.getName().endsWith(".zip")) {
                    // 读取文件内容
                    String content = "";
                    try {
                        InputStream is = new FileInputStream(file);
                        ZipInputStream zis = new ZipInputStream(new BufferedInputStream(is));
                        ZipEntry ze;
                        byte[] buffer = new byte[1024];
                        while ((ze = zis.getNextEntry()) != null) {
                            String fileName = ze.getName();
                            if (!fileName.contains("/")) {
                                int count;
                                ByteArrayOutputStream bos = new ByteArrayOutputStream();
                                while ((count = zis.read(buffer)) != -1) {
                                    bos.write(buffer, 0, count);
                                }
                                bos.close();
                                content = new String(bos.toByteArray(), "UTF-8");
                                break;
                            }
                        }
                        zis.closeEntry();
                        zis.close();
                        is.close();
                    } catch (IOException e) {
                        e.printStackTrace();
                    }
                }
            }
        }
    }
}