libaums：安卓平台无需越狱即可访问USB存储设备的开源库安装与配置指南

项目基础介绍及编程语言

libaums 是一个开源库，允许Android应用在不需root权限的情况下访问USB闪存盘、外部硬盘驱动器和读卡器等USB存储设备。它基于Android USB主机API实现，并支持SCSI命令集以及FAT32文件系统。此项目采用 Java 和少量 Kotlin 进行开发，确保了与Android生态的高度兼容性。

关键技术和框架

• Android USB Host API：用于直接与USB设备通信。
• SCSI Command Set：处理与USB存储设备的底层交互。
• FAT32文件系统支持：直接读写FAT32格式的存储设备。
• 可选的libusb模块：提供了一种备用的低级别USB通信方式，适用于某些难以通过标准API解决的问题，但请注意其遵循LGPL许可，不同于项目的Apache-2.0许可。
• 对于提升访问体验，还有两个额外模块支持HTTP服务器（NanoHTTPD或AsyncHttpServer）和存储提供者，便于第三方应用访问存储设备上的文件。

安装和配置步骤

准备工作

1. 环境需求：确保你的开发环境已设置好Android Studio，且具有USB调试模式的Android设备或模拟器。
2. Git客户端：你需要安装Git来克隆项目源码。

克隆项目

打开终端或命令提示符，执行以下命令以克隆项目：

git clone https://github.com/magnusja/libaums.git

添加依赖至你的Android项目

1. 在build.gradle(Module: app) 文件中添加仓库和依赖项：

   repositories {
       mavenCentral()
   }
   
   dependencies {
       implementation 'me.jahnen:libaums:core:0.10.0' // 核心库
       // 如需HTTP服务或存储提供者功能，则添加以下依赖
       // implementation 'me.jahnen:libaums:httpserver:0.6.2'
       // implementation 'me.jahnen:libaums:storageprovider:0.6.2'
   }
   

2. 同步Gradle：保存更改后，在Android Studio中同步Gradle项目。

实现基本功能

查询可用存储设备

在你的Activity或Fragment中，加入以下代码查询并初始化设备：

// Java
UsbMassStorageDevice[] devices = UsbMassStorageDevice.getMassStorageDevices(this);
for (UsbMassStorageDevice device : devices) {
    device.init();
    FileSystem fs = device.getPartitions().get(0).getFileSystem();
    // 使用文件系统进行相关操作
}

// Kotlin
val devices = UsbMassStorageDevice.getMassStorageDevices(this)
for (device in devices) {
    device.init()
    val fs = device.partitions[0].fileSystem
    // 继续进行文件系统操作
}

权限申请

由于涉及USB设备的访问，需在运行时请求ACTION_USB_PERMISSION权限：

PendingIntent permissionIntent = PendingIntent.getBroadcast(this, 0, new Intent(ACTION_USB_PERMISSION), 0);
UsbManager usbManager = (UsbManager) getSystemService(Context.USB_SERVICE);
usbManager.requestPermission(device.getUsbDevice(), permissionIntent);

// Kotlin版本相似，使用意图广播进行权限请求

测试与验证

• 在设备上运行你的应用，确保已连接USB存储设备。
• 应用应当能够识别设备并按上述示例操作文件系统，如列出文件、读写文件等。

至此，你已经成功安装并配置了libaums库，可以进一步探索其实现细节与高级功能，例如使用HTTP服务器分享设备中的文件给其他应用。记得在完成设备操作后调用device.close()来释放资源。