Android自定义文件路径选择器

下面是关于 Android 自定义文件路径选择器的完整攻略，包括以下几个部分：

1. 了解文件路径选择器的基本原理；
2. 实现文件路径选择器；
3. 示例说明。

1. 了解文件路径选择器的基本原理

文件路径选择器通常用于选择文件或目录，它可以帮助用户在 Android 设备中定位目标文件或目录，并返回其路径信息。在 Android 中，我们可以使用以下两种方式实现文件路径选择器：

• 使用系统提供的文件选择器；
• 自定义文件选择器。

系统提供的文件选择器可以在打开对话框中直接使用，但是它通常不能满足所有的需求。如果你需要一个更加专业的文件选择器，那么建议使用自定义文件选择器。

2. 实现文件路径选择器

接下来，我们将详细讲解如何实现自定义文件路径选择器。

2.1 创建布局文件

首先，创建一个布局文件用于显示文件路径选择器：

<!-- file_picker_dialog.xml -->
<LinearLayout
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:orientation="vertical">

    <ListView
        android:id="@+id/list_view"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />

    <Button
        android:id="@+id/btn_confirm"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="确认" />
</LinearLayout>

2.2 创建适配器

接下来，创建一个适配器类，用于将目录和文件列表显示在 ListView 控件中：

public class FileListAdapter extends BaseAdapter {
    private List<File> mFileList;
    private LayoutInflater mInflater;

    public FileListAdapter(List<File> fileList, Context context) {
        this.mFileList = fileList;
        this.mInflater = LayoutInflater.from(context);
    }

    @Override
    public int getCount() {
        if (mFileList != null) {
            return mFileList.size();
        }
        return 0;
    }

    @Override
    public Object getItem(int position) {
        if (mFileList != null) {
            return mFileList.get(position);
        }
        return null;
    }

    @Override
    public long getItemId(int position) {
        return position;
    }

    @Override
    public View getView(int position, View convertView, ViewGroup parent) {
        ViewHolder holder;
        if (convertView == null) {
            convertView = mInflater.inflate(R.layout.item_file_list, null);
            holder = new ViewHolder();
            holder.fileNameView = convertView.findViewById(R.id.view_file_name);
            holder.fileIconView = convertView.findViewById(R.id.view_file_icon);
            convertView.setTag(holder);
        } else {
            holder = (ViewHolder) convertView.getTag();
        }

        File file = mFileList.get(position);
        String fileName = file.getName();
        holder.fileNameView.setText(fileName);
        if (file.isFile()) {
            holder.fileIconView.setImageResource(R.drawable.file_icon);
        } else if (file.isDirectory()) {
            holder.fileIconView.setImageResource(R.drawable.folder_icon);
        }

        return convertView;
    }

    private static class ViewHolder {
        private TextView fileNameView;
        private ImageView fileIconView;
    }
}

2.3 创建文件选择器Dialog

创建一个文件选择器 Dialog 类，用于显示文件列表，并处理用户选择的结果：

public class FilePickerDialog extends Dialog {
    private ListView mListView;
    private Button mConfirmButton;

    private List<File> mFileList;
    private File mCurrentDirectory;
    private OnFileSelectedListener mListener;

    public FilePickerDialog(Context context, File rootDirectory, OnFileSelectedListener listener) {
        super(context);
        setContentView(R.layout.file_picker_dialog);
        setTitle("选择文件");

        this.mCurrentDirectory = rootDirectory;
        this.mListener = listener;

        mListView = findViewById(R.id.list_view);
        mConfirmButton = findViewById(R.id.btn_confirm);

        refreshFileList();

        mListView.setOnItemClickListener(new AdapterView.OnItemClickListener() {
            @Override
            public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
                File file = mFileList.get(position);
                if (file.isDirectory()) {
                    mCurrentDirectory = file;
                    refreshFileList();
                } else if (file.isFile()) {
                    if (mListener != null) {
                        mListener.onFileSelected(file.getAbsolutePath());
                        FilePickerDialog.this.dismiss();
                    }
                }
            }
        });

        mConfirmButton.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                if (mListener != null) {
                    mListener.onFileSelected(mCurrentDirectory.getAbsolutePath());
                    FilePickerDialog.this.dismiss();
                }
            }
        });
    }

    private void refreshFileList() {
        mFileList = Arrays.asList(mCurrentDirectory.listFiles());
        FileListAdapter adapter = new FileListAdapter(mFileList, getContext());
        mListView.setAdapter(adapter);
    }

    public interface OnFileSelectedListener {
        void onFileSelected(String filePath);
    }
}

2.4 调用文件选择器

最后，在需要选择文件路径的 Activity 或 Fragment 中，实例化一个文件选择器 Dialog，设置根目录和选择结果的回调监听器，然后调用 Dialog 显示：

File rootDirectory = Environment.getExternalStorageDirectory();
FilePickerDialog dialog = new FilePickerDialog(getContext(), rootDirectory, new FilePickerDialog.OnFileSelectedListener() {
    @Override
    public void onFileSelected(String filePath) {
        // 处理选择结果
    }
});
dialog.show();

这样，一个简单的文件路径选择器就完成了。

3. 示例说明

下面，我们使用两个示例来说明如何使用该自定义文件路径选择器：

3.1 示例1：选择文件夹

在这个示例中，我们将创建一个按钮，点击后会显示文件路径选择器，并默认显示手机存储根目录，用户可以在选择框中选择文件夹。

首先，在布局文件中创建一个按钮：

<Button
    android:id="@+id/btn_pick_folder"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:text="选择文件夹" />

接下来，在 Activity（或 Fragment）中，设置按钮的点击事件，启动文件路径选择器：

Button pickFolderButton = findViewById(R.id.btn_pick_folder);
pickFolderButton.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View v) {
        File rootDirectory = Environment.getExternalStorageDirectory();
        FilePickerDialog dialog = new FilePickerDialog(MainActivity.this, rootDirectory, new FilePickerDialog.OnFileSelectedListener() {
            @Override
            public void onFileSelected(String filePath) {
                Toast.makeText(MainActivity.this, "已选择文件夹：" + filePath, Toast.LENGTH_SHORT).show();
            }
        });
        dialog.show();
    }
});

这样就可以在界面中点击按钮，打开文件选择框，并选择文件夹。

3.2 示例2：选择文件

在这个示例中，我们将创建一个按钮，点击后会显示文件路径选择器，并默认显示手机存储根目录，用户可以在选择框中选择文件。

首先，在布局文件中创建一个按钮：

<Button
    android:id="@+id/btn_pick_file"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:text="选择文件" />

接下来，在 Activity（或 Fragment）中，设置按钮的点击事件，启动文件路径选择器：

Button pickFileButton = findViewById(R.id.btn_pick_file);
pickFileButton.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View v) {
        File rootDirectory = Environment.getExternalStorageDirectory();
        FilePickerDialog dialog = new FilePickerDialog(MainActivity.this, rootDirectory, new FilePickerDialog.OnFileSelectedListener() {
            @Override
            public void onFileSelected(String filePath) {
                Toast.makeText(MainActivity.this, "已选择文件：" + filePath, Toast.LENGTH_SHORT).show();
            }
        });
        dialog.show();
    }
});

这样就可以在界面中点击按钮，打开文件选择框，并选择文件。

以上就是关于 Android 自定义文件路径选择器的完整攻略，包括基本原理、代码实现和示例说明。