Android通过USB路径读取文件的实现指南

在Android应用开发中，通过USB连接读取文件是一个常见的需求。对于刚入行的新手，可能会觉得这一过程比较复杂。本文将详细讲解如何实现这一功能，并提供相应的代码示例。我们将按照以下流程来进行：

流程步骤

步骤描述
1配置AndroidManifest.xml
2设计用户界面(UI)
3编写读取文件的代码
4测试及调试
1. 配置AndroidManifest.xml

首先，我们需要在项目的AndroidManifest.xml文件中声明读取USB文件所需的权限和USB Host功能。

<manifest xmlns:android="
    package="com.example.usbfilereader">

    <uses-permission android:name="android.permission.USB_PERMISSION"/>
    <uses-feature android:name="android.hardware.usb.host"/>

    <application
        ... >
        ...
    </application>
</manifest>
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
2. 设计用户界面(UI)

接下来，我们需要创建一个简单的用户界面，让用户能够选择USB路径并触发读取文件的操作。以下是一个基本的示例布局文件activity_main.xml。

<LinearLayout xmlns:android="
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:padding="16dp">

    <Button
        android:id="@+id/button_read_file"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="读取文件" />

    <TextView
        android:id="@+id/textView_output"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:paddingTop="16dp" />
</LinearLayout>
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
3. 编写读取文件的代码

在活动的Java文件中，我们需要实现USB检测和文件读取的逻辑。以下是关键代码的示例：

import android.Manifest;
import android.content.Intent;
import android.database.Cursor;
import android.net.Uri;
import android.os.Bundle;
import android.provider.OpenableColumns;
import android.view.View;
import android.widget.Button;
import android.widget.TextView;
import android.widget.Toast;

import androidx.annotation.Nullable;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;
import androidx.core.content.ContextCompat;

import java.io.BufferedReader;
import java.io.InputStream;
import java.io.InputStreamReader;

public class MainActivity extends AppCompatActivity {

    private static final int READ_REQUEST_CODE = 42; // 用于文件选择请求

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        Button buttonReadFile = findViewById(R.id.button_read_file);
        TextView textViewOutput = findViewById(R.id.textView_output);

        buttonReadFile.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                performFileSearch(); // 调用文件选择方法
            }
        });
    }

    // 打开文件选择器
    private void performFileSearch() {
        Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT);
        intent.addCategory(Intent.CATEGORY_OPENABLE);
        intent.setType("*/*"); // 选择任意类型的文件
        startActivityForResult(intent, READ_REQUEST_CODE); // 请求文件选择
    }

    @Override
    protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        if (requestCode == READ_REQUEST_CODE && resultCode == RESULT_OK) {
            if (data != null) {
                Uri uri = data.getData(); // 获取选中的文件Uri
                readFile(uri); // 读文件内容
            }
        }
    }

    // 读取选中的文件内容
    private void readFile(Uri uri) {
        try {
            InputStream inputStream = getContentResolver().openInputStream(uri);
            BufferedReader reader = new BufferedReader(new InputStreamReader(inputStream));
            StringBuilder stringBuilder = new StringBuilder();
            String line;
            while ((line = reader.readLine()) != null) {
                stringBuilder.append(line).append("\n"); // 逐行读取
            }
            reader.close();
            TextView textViewOutput = findViewById(R.id.textView_output);
            textViewOutput.setText(stringBuilder.toString()); // 显示文件内容
        } catch (Exception e) {
            Toast.makeText(this, "读取文件失败: " + e.getMessage(), Toast.LENGTH_SHORT).show();
        }
    }
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.
  • 32.
  • 33.
  • 34.
  • 35.
  • 36.
  • 37.
  • 38.
  • 39.
  • 40.
  • 41.
  • 42.
  • 43.
  • 44.
  • 45.
  • 46.
  • 47.
  • 48.
  • 49.
  • 50.
  • 51.
  • 52.
  • 53.
  • 54.
  • 55.
  • 56.
  • 57.
  • 58.
  • 59.
  • 60.
  • 61.
  • 62.
  • 63.
  • 64.
  • 65.
  • 66.
  • 67.
  • 68.
  • 69.
  • 70.
  • 71.
  • 72.
  • 73.
  • 74.
  • 75.
  • 76.
  • 77.
4. 测试及调试

至此，我们完成了USB路径读取文件的基本功能。可以在真实设备上进行测试，确认是否能够顺利读取文件内容。如果遇到问题，可以检查USB连接、权限设置和代码逻辑。

结论

通过本教程，你应该能够掌握如何在Android应用中通过USB路径读取文件。尽管初学阶段可能会感到一些挑战，但勤加练习将使你更加熟练。希望这篇文章能够帮助你顺利实现所需功能。如果在实现过程中遇到任何问题，欢迎随时查阅官方文档或寻求社区支持。