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

本文链接：https://blog.youkuaiyun.com/gitblog_07958/article/details/142229497

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

libaums Open source library to access USB Mass Storage devices on Android without rooting your device 项目地址: https://gitcode.com/gh_mirrors/li/libaums

项目基础介绍及编程语言

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）和存储提供者，便于第三方应用访问存储设备上的文件。

安装和配置步骤

准备工作

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

克隆项目

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

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

添加依赖至你的Android项目

在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'
}

同步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版本相似，使用意图广播进行权限请求