Android外部系统应用控制USB共享网络打开接口的实现与优化

1次阅读

没有评论

共计 3111 个字符，预计需要花费 8 分钟才能阅读完成。

在 Android 系统开发中，外部应用需要控制系统级的 USB 网络共享功能（USB Tethering）时，往往会遇到诸多限制。典型场景包括：

IoT 设备通过 USB 连接进行配网时，需要自动开启网络共享
企业级 MDM（移动设备管理）系统集中管控设备网络策略
定制 ROM 需要提供更灵活的网络共享控制界面

开发者常遇到的三大核心问题：

权限限制 ：普通应用无法直接调用startTethering 等系统级 API，需要 TETHER_PRIVILEGED 权限
版本碎片化：Android 7.0 到 13.0 的接口行为差异显著，特别是 Android 11 引入的新限制
状态同步困难：USB 物理连接状态与网络共享状态需要实时监听和同步

ADB 命令方式（临时调试可用）：
```
adb shell svc usb setFunctions rndis
```
优点：无需编码，快速验证
缺点：需要 root 权限，无法集成到应用逻辑
AIDL 系统服务方式（推荐方案）：
通过 ConnectivityManager 的startTethering API 实现
优点：正规系统接口，支持回调监听
缺点：需要处理复杂的权限和版本适配

权限声明 ：在AndroidManifest.xml 中声明系统级权限
服务调用 ：通过ConnectivityManager 控制共享状态
状态监听 ：注册USB_STATE 和TETHER_STATE广播接收器
异常处理：针对不同 API 版本做兼容处理

<!-- AndroidManifest.xml -->
<uses-permission android:name="android.permission.TETHER_PRIVILEGED" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.hardware.usb.accessory" />

class UsbTetheringController(private val context: Context) {
    private val connectivityManager by lazy {context.getSystemService(Context.CONNECTIVITY_SERVICE) as ConnectivityManager
    }

    // 启动 USB 网络共享
    fun startUsbTethering() {if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            connectivityManager.startTethering(
                ConnectivityManager.TETHERING_USB,
                true,
                { result -> 
                    // 回调处理结果
                    if (result == ConnectivityManager.TETHER_ERROR_NO_ERROR) {Log.d("Tethering", "USB 共享启动成功")
                    }
                },
                Handler(Looper.getMainLooper())
            )
        }
    }

    // 注册 USB 状态监听
    fun registerUsbReceiver() {val filter = IntentFilter().apply {addAction(UsbManager.ACTION_USB_STATE)
            addAction(ConnectivityManager.ACTION_TETHER_STATE_CHANGED)
        }
        context.registerReceiver(usbReceiver, filter)
    }

    private val usbReceiver = object : BroadcastReceiver() {override fun onReceive(context: Context, intent: Intent) {when (intent.action) {
                UsbManager.ACTION_USB_STATE -> {
                    // 处理 USB 物理连接状态变化
                    val connected = intent.getBooleanExtra(UsbManager.USB_CONNECTED, false)
                    updateTetheringState(connected)
                }
                ConnectivityManager.ACTION_TETHER_STATE_CHANGED -> {
                    // 处理网络共享状态变化
                    val activeArray = intent.getStringArrayListExtra(ConnectivityManager.EXTRA_ACTIVE_TETHER)
                    Log.d("Tethering", "当前活跃共享: ${activeArray?.joinToString()}")
                }
            }
        }
    }
}

Android 11+ 限制：
必须使用 TETHER_PRIVILEGED 权限
仅系统应用或平台签名应用可用
需要用户手动授权 USB 调试
系统签名方案：
方案一：使用平台签名密钥（需 ROM 支持）
方案二：预装到 /system/priv-app 目录
方案三：通过 shizuku 等工具临时授权
异步处理建议：
所有 startTethering 调用必须放在子线程
使用 Handler 将结果回调到主线程更新 UI

# 检查当前共享状态
adb shell dumpsys connectivity tethering

# 模拟 USB 连接
adb shell svc usb setFunctions rndis

@RunWith(AndroidJUnit4::class)
class UsbTetheringTest {
    @get:Rule
    val rule = ServiceTestRule()

    @Test
    fun testTetheringStart() {val controller = UsbTetheringController(ApplicationProvider.getApplicationContext())

        // 模拟 USB 连接
        val intent = Intent(UsbManager.ACTION_USB_STATE).apply {putExtra(UsbManager.USB_CONNECTED, true)
        }
        InstrumentationRegistry.getInstrumentation().sendBroadcast(intent)

        // 验证启动结果
        val result = controller.startUsbTethering()
        assertThat(result).isEqualTo(ConnectivityManager.TETHERING_USB)
    }
}