Android OTG 读写U盘文件

最近项目需要做一个关于OTG的功能，其实也就使用到U盘的文件读取，一般这种需求是不需要的，因为大部分的系统都会自动挂载U盘，但是个别系统还是需要自己去实现，查了很多资料都没有找到一个完整的能用的例子，要么就是年代偏远，好不容易运行起来跑不了，或者没效果，这个过程是很烦的，google了一下后，发现了一个开源的文件管理器，但是该管理器在使用的时候却出现了OTG无法读取的问题，详细的话可以自己去看看 GitHub - 1hakr/AnExplorer: 📁 Another Android Explorer ( File Manager ) is an All-in-One Open source file manager. AnExplorer File Manager (File Explorer) is designed for all android devices including Phones, Phablets, Tablets, Chromecast, Wear OS, Android TV and Chromebooks. It's a fully designed with Material guidelines by Google.，我是去看源码它的USB实现过程中从中提取了一部分东西，再结合看的其他博客，总算能实现读写的效果。
阅读之前，可先看一下这几篇文章了解一些概念：

android-USB-OTG 外部设备通讯 USB插拔检测

Android实战技巧之四十九：Usb通信之USB Host

https://developer.android.com/guide/topics/connectivity/usb/host.html

好吧，其实看了也只是有个大概的了解，要想实现其实还是差了点,特别是获取U盘目录什么的简直不知道该怎么下手，废话不多说，看一下个人实现，如果你有更好的实现，欢迎留言讨论。

首先，肯定需要获取读取OTG和文件权限，在manifest.xml中加入以下权限

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.hardware.usb.host" android:required="false" />

然后，部分手机上是没有otg的所以需要加入特性。

 <uses-feature android:name="android.hardware.usb.host" android:required="true" />

有了权限后，就可以开始编码了。

第一步，注册广播，监听otg插拔事件。

//监听otg插入 拔出
IntentFilter usbDeviceStateFilter = new IntentFilter();
usbDeviceStateFilter.addAction(UsbManager.ACTION_USB_DEVICE_ATTACHED);
usbDeviceStateFilter.addAction(UsbManager.ACTION_USB_DEVICE_DETACHED);
//注册监听自定义广播
IntentFilter filter = new IntentFilter(ACTION_USB_PERMISSION);
registerReceiver(mUsbReceiver, filter);

ACTION_USB_PERMISSION是定义的一个权限字段

private static final String ACTION_USB_PERMISSION = "com.android.example.USB_PERMISSION";

接上

    //otg插入 拔出广播getActivity().registerReceiver(mUsbReceiver, usbDeviceStateFilter);//这里我用的碎片registerReceiver(mUsbReceiver, usbDeviceStateFilter);//这里我用的碎片//mUsbReceiver只是一个普通的广播，根据action，去分别处理对应的事件。private final BroadcastReceiver mUsbReceiver = new BroadcastReceiver() {public void onReceive(Context context, Intent intent) {String action = intent.getAction();switch (action) {case ACTION_USB_PERMISSION://接受到自定义广播synchronized (this) {UsbDevice usbDevice = intent.getParcelableExtra(UsbManager.EXTRA_DEVICE);if (intent.getBooleanExtra(UsbManager.EXTRA_PERMISSION_GRANTED, false)) { //允许权限申请if (usbDevice != null) {//Do something}} else {TShow("用户未授权，读取失败");}}break;case UsbManager.ACTION_USB_DEVICE_ATTACHED://接收到存储设备插入广播UsbDevice device_add = intent.getParcelableExtra(UsbManager.EXTRA_DEVICE);if (device_add != null) {TShow("接收到存储设备插入广播");}break;case UsbManager.ACTION_USB_DEVICE_DETACHED://接收到存储设备拔出广播UsbDevice device_remove = intent.getParcelableExtra(UsbManager.EXTRA_DEVICE);if (device_remove != null) {TShow("接收到存储设备拔出广播");//拔出或者碎片 Activity销毁时 释放引用//device.close();}break;}}};

TShow()是我个人的Toast消息封装，上述中的广播每一个都可以获取到usb设备的实体信息类，可以根据个人逻辑处理。

第二步，枚举设备

        //获取管理者UsbManager usbManager = (UsbManager) getContext().getSystemService(Context.USB_SERVICE);//枚举设备UsbMassStorageDevice[] storageDevices = UsbMassStorageDevice.getMassStorageDevices(getContext());//获取存储设备PendingIntent pendingIntent = PendingIntent.getBroadcast(getActivity(), 0, new Intent(ACTION_USB_PERMISSION), 0);for (UsbMassStorageDevice device : storageDevices) {//可能有几个 一般只有一个 因为大部分手机只有1个otg插口if (usbManager.hasPermission(device.getUsbDevice())) {//有就直接读取设备是否有权限read(device);} else {//没有就去发起意图申请usbManager.requestPermission(device.getUsbDevice(), pendingIntent); //该代码执行后，系统弹出一个对话框，}}

申请意图执行后，会进入上面的广播中，然后，在需要处理的地方去执行读取操作。

第三步，读取U盘信息

这里需要说明一下，UsbMassStorageDevice这个类来自开源库，里面包含了一些获取大容量存储设备的操作和其他封装。可以在Gradle中加入依赖:

compile 'com.github.mjdev:libaums:+'

该库GitHub地址：https://github.com/magnusja/libaums#using-buffered-streams-for-more-efficency

read(device);的详细代码：

private void read(UsbMassStorageDevice massDevice) {// before interacting with a device you need to call init()!try {massDevice.init();//初始化//Only uses the first partition on the devicePartition partition = massDevice.getPartitions().get(0);FileSystem currentFs = partition.getFileSystem();//fileSystem.getVolumeLabel()可以获取到设备的标识//通过FileSystem可以获取当前U盘的一些存储信息，包括剩余空间大小，容量等等Log.d(TAG, "Capacity: " + currentFs.getCapacity());Log.d(TAG, "Occupied Space: " + currentFs.getOccupiedSpace());Log.d(TAG, "Free Space: " + currentFs.getFreeSpace());Log.d(TAG, "Chunk size: " + currentFs.getChunkSize());UsbFile root = currentFs.getRootDirectory();} catch (Exception e) {e.printStackTrace();TShow("读取失败");}}

到这里就已经可以获取到U盘根目录的实体类UsbFile了

UsbFile的部分函数：

listFiles();//该函数可以获取到某个目录下所有的文件boolean isDirectory();//判断是否是目录void setName(String newName) throws IOException//给目录或文件设置名称String getName();//获取该文件或目录的名称UsbFile getParent();//该函数可以获取父类对象，比如根目录是root，它有个子目录music，那么通过music的UsbFile对象可以获取到root的文件和目录列表，也就解决了获取上一级目录文件的问题。    long getLength();//如果是个文件，可以获取到文件大小void read(long offset, ByteBuffer destination) throws IOException;//文件读取操作void write(long offset, ByteBuffer source) throws IOException;//文件写入操作UsbFile createDirectory(String name) throws IOException;//如果是个目录，那么会在该目录下创建一个新的目录UsbFile createFile(String name) throws IOException;//如果该目录存在，会在该目录下生成一个新的文件void delete() throws IOException;//文件和目录删除操作boolean isRoot();//当前目录是否是根目录

常用的函数就这几个，基本上包括了U盘文件的增删改查，如果说需要一个File的对象，那么可以通过流的形式进行先保存到本地再获取。因为File对象指向了一个具体的uri地址，也就是说，必须要有能访问的具体路径，比如内置存储和sd卡的目录。

具体步骤：先创建一个具体的文件，然后以io形式进行文件写入，相当于复制，io完成后即可获取File对象

如下：

 new Thread(new Runnable() {@Overridepublic void run() {try {FileOutputStream os = new FileOutputStream(tempFile);InputStream is = new UsbFileInputStream(usbFile);int bytesRead = 0;byte[] buffer = new byte[1024 * 8];//作者的推荐写法是currentFs.getChunkSize()为buffer长度while ((bytesRead = is.read(buffer)) != -1) {os.write(buffer, 0, bytesRead);}os.flush();os.close();is.close();//Do something} catch (Exception e) {e.printStackTrace();}}}).start();

好了，基本上整个流程就是这样的，由于百度账户注销了，所以源码没了，但是只要看懂了这个流程基本上就没什么问题了。