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();
                    }
                }
            }
        }
    }
}