Android文件選擇器——讓用戶選擇文件變得輕鬆簡便

一、文件選擇器的作用：

Android開發中，用戶需要選擇文件的情況非常普遍，比如用戶需要選擇導入數據、上傳文件等。此時，使用文件選擇器可以極大地簡化用戶操作，減小用戶的心智負擔，提高用戶體驗。

Android系統提供了許多便於操作文件的工具類，如ContentProvider、MediaProvider等。在這些工具類的支持下，我們可以很方便地實現文件的讀取、解析、展示以及上傳等操作。下面，我們就來學習如何在Android應用中運用文件選擇器。

二、兩種常用的文件選擇器：

1. Android系統提供的文件選擇器

Android系統提供了官方的文件選擇器，可以讓用戶在文件系統中選擇文件，並返回選擇結果。調用方式如下：

// 創建intent
Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
// 設置類型為*/*，表示允許選擇任何類型的文件
intent.setType("*/*");
// 是否允許多選，默認為false
intent.putExtra(Intent.EXTRA_ALLOW_MULTIPLE, false);
// 啟動文件選擇器
startActivityForResult(intent, requestCode);

在startActivityForResult()方法中，requestCode為請求碼，用於區分返回的結果。在onActivityResult()方法中，我們就可以接收到用戶選擇的文件了。

2. 第三方庫FilePicker

為了進一步優化體驗，我們可以使用第三方文件選擇器庫FilePicker。它支持單選、多選、分組展示、自定義UI等多種功能，使用簡單方便。

首先，在工程的build.gradle文件中添加以下依賴項：

dependencies {
   implementation 'com.github.frankiesardo:material-file-picker:1.5.1'
}

接下來，在代碼中調用FilePicker的方式如下：

// 創建FilePicker對象
MaterialFilePicker materialFilePicker = new MaterialFilePicker();
// 設定過濾器，表示只顯示jpg、png、bmp和gif格式的圖片
materialFilePicker.withFilter(Pattern.compile(".*\\.(jpg|png|bmp|gif)$"));
// 設置文件選擇的根路徑為/sdcard/Download/
materialFilePicker.withRootPath(Environment.getExternalStorageDirectory().getPath() + "/Download");
// 設定選擇模式為單選
materialFilePicker.withSingleFileMode(true);
// 設置Activity
materialFilePicker.withActivity(MainActivity.this);
// 設置選擇結果回調
materialFilePicker.withCallback(new MaterialFilePicker.Callback() {
    @Override
    public void onPickMaterialFile(MaterialFilePicker materialFilePicker, File file) {
        // 處理選擇結果，file為選擇的文件
    }
}).show();

三、如何自定義文件選擇器：

默認的文件選擇器雖然可以滿足基本需求，但卻不夠美觀、靈活、方便。有時候，我們需要根據自己的需求來定製一個更好的文件選擇器。這裡，我們就介紹一下如何自定義文件選擇器。

1. 定義文件選擇器的XML布局

首先，我們需要自定義布局文件。例如，我們創建一個名為file_picker.xml的XML布局文件，如下所示：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">
   
    <TextView
        android:id="@+id/tv_title"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="選擇文件"
        android:textStyle="bold"
        android:textSize="20sp"
        android:gravity="center"
        android:padding="10dp"/>

    <ListView
        android:id="@+id/lv_files"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_marginTop="5dp"
        android:divider="@null"
        android:dividerHeight="0dp"/>
        
</LinearLayout>

定義好布局文件後，在代碼中使用setContentView方法將布局文件載入到Activity中：

setContentView(R.layout.file_picker);

2. 定義文件選擇器的Adapter

接下來，我們需要定義一個文件列表的Adapter，用於載入和顯示文件列表。我們可以繼承BaseAdapter，並實現以下方法：

getCount()，返迴文件列表的長度
getItem(position)，返迴文件列表position位置的文件對象
getItemId(position)，返迴文件列表position位置的ID
getView(position, convertView, parent)，返迴文件列表中position位置的視圖

在getView()方法中，我們需要載入文件列表的Item布局，並將文件信息顯示在視圖中。例如：

@Override
public View getView(int position, View convertView, ViewGroup parent) {
    ViewHolder holder;
    if (convertView == null) {
        convertView = LayoutInflater.from(mContext).inflate(R.layout.file_item, null);
        holder = new ViewHolder();
        holder.ivIcon = convertView.findViewById(R.id.iv_icon);
        holder.tvName = convertView.findViewById(R.id.tv_name);
        convertView.setTag(holder);
    } else {
        holder = (ViewHolder) convertView.getTag();
    }

    // 設置視圖內容
    File file = mDataList.get(position);
    holder.tvName.setText(file.getName());
    if (file.isDirectory()) {
        holder.ivIcon.setImageResource(R.drawable.ic_folder);
    } else {
        holder.ivIcon.setImageResource(R.drawable.ic_file);
    }
    return convertView;
}

private class ViewHolder {
    ImageView ivIcon;
    TextView tvName;
}

3. 在Activity中實現文件選擇器

最後，我們需要在Activity中實現文件選擇器的功能。例如，當用戶點擊「選擇文件」按鈕時，我們可以啟動文件選擇器對話框，並根據用戶選擇的文件路徑進行處理。代碼示例如下：

// 彈出文件選擇器對話框
AlertDialog.Builder builder = new AlertDialog.Builder(this);
builder.setView(R.layout.file_picker);
final AlertDialog dialog = builder.create();
dialog.show();

// 載入文件列表
final ListView lvFiles = dialog.findViewById(R.id.lv_files);
final List fileList = new ArrayList();
String rootPath = Environment.getExternalStorageDirectory().getPath();
File rootFile = new File(rootPath);
if (rootFile.listFiles() != null) {
    for (File file : rootFile.listFiles()) {
        if (file.isFile()) {
            fileList.add(file);
        }
    }
}
final FileAdapter adapter = new FileAdapter(this, fileList);
lvFiles.setAdapter(adapter);

// 設置列表項的點擊事件
lvFiles.setOnItemClickListener(new AdapterView.OnItemClickListener() {
    @Override
    public void onItemClick(AdapterView adapterView, View view, int i, long l) {
        File file = fileList.get(i);
        if (file.isDirectory()) {
            // 如果是文件夾，則重新載入子文件列表
            fileList.clear();
            for (File childFile : file.listFiles()) {
                if (childFile.isFile()) {
                    fileList.add(childFile);
                }
            }
            adapter.notifyDataSetChanged();
        } else {
            // 如果是文件，則返迴文件路徑
            Toast.makeText(MainActivity.this, "選中文件：" + file.getAbsolutePath(), Toast.LENGTH_SHORT).show();
            dialog.dismiss();
        }
    }
});

四、總結

文件選擇器是Android開發中非常實用的工具，它可以極大地簡化用戶操作，提高用戶體驗。本文介紹了常用的兩種文件選擇器，以及如何自定義文件選擇器。希望讀者可以通過本文的學習，掌握文件選擇器的基本用法，並在實踐中運用文件選擇器優化應用的用戶體驗。

原創文章，作者：OECUL，如若轉載，請註明出處：https://www.506064.com/zh-tw/n/334929.html