在 Android 开发中，ACCESS_LOCAL_NETWORK 权限用于控制应用访问本地局域网设备或服务的能力，例如扫描局域网设备、连接投屏设备或调试本地 Web 服务桥接等场景。由于该权限涉及本地网络的访问，各大应用商店（尤其是 Google Play）对其审核极为严格：若正式包在无实质局域网业务的情况下声明该权限，极易导致应用被驳回或下架。因此，将该权限严格隔离于开发调试环境，是保障生产包安全与合规的必要措施。
1. Android 17 局域网调试与 ACCESS_LOCAL_NETWORK 权限变动
自 Android 16 及更早版本以来，INTERNET 权限同时涵盖公网与局域网访问。然而在 Android 17 中，系统将局域网访问权从 INTERNET 中解耦，并引入新的运行时危险权限 ACCESS_LOCAL_NETWORK（归属于 NEARBY_DEVICES 权限组），以防止恶意应用利用局域网设备信息（如 MAC 地址、设备列表）实施隐蔽的用户指纹追踪与精准定位。
1.1 强制化要求
Android 17 起，该权限对 targetSdk 37（API 37）及以上版本的应用强制执行；targetSdk 低于 37 的应用若已持有 INTERNET 权限，可自动获得 ACCESS_LOCAL_NETWORK 权限，不受此变更影响。
1.2 局域网调试条件
以 Android 17 及以上为目标平台的应用，进行局域网调试（如 adb over WiFi、抓包代理、本地设备直连等）需满足以下两条路径之一：
- 隐私保护选择器：使用系统提供的隐私保护设备选择器（privacy-preserving picker）跳过权限提示。
- 显式请求权限 ：在运行时显式请求
ACCESS_LOCAL_NETWORK权限。
1.3 影响范围与豁免场景
未声明或未授予该权限的应用访问局域网时，系统会在底层直接拦截并静默丢弃网络包，"连接同一 WiFi 查找设备"等场景将静默失败。受影响场景包括局域网文件快传、本地 HTTP 请求、设备直连、智能家居控制、投屏、局域网文件共享与多人游戏等。豁免场景包括进出本地 DNS 服务器（端口 53）的流量，以及使用系统原生"输出源切换器"的应用。由于该权限属于 NEARBY_DEVICES 权限组，已授予过该组其他权限的用户不会再次收到权限提示。
2. Product Flavors 清单隔离方案
Android Gradle 插件（AGP）在构建时会将 main 源集与当前构建变体（Flavor/Build Type）源集下的所有 AndroidManifest.xml 合并。利用这一特性，可以轻松实现权限的按需声明。
2.1 移除主清单中的权限声明
首先，从主清单文件移除以避免正式包携带该权限：
xml
- <uses-permission android:name="android.permission.ACCESS_LOCAL_NETWORK"/>2.2 在 dev 变体清单中新增权限
接着，在 src/dev/ 目录下的 AndroidManifest.xml 中声明该权限：
xml
<?xml version="1.0" encoding="utf-8"?>
{/* 仅在 dev 渠道中声明本地网络访问权限 */}
<uses-permission android:name="android.permission.ACCESS_LOCAL_NETWORK"/>原理说明 ：编译 dev 渠道时，src/dev/AndroidManifest.xml 中的 <uses-permission> 节点会合并至最终清单；而编译 prod 渠道时，该文件不参与构建，确保生产包权限干净、安全。
3. 动态权限申请与业务跳转
由于环境切换页面仅存在于 dev 源码集，可在其内部直接引用并动态申请该权限。
3.1 注册权限申请回调
采用 Jetpack Activity 提供的 registerForActivityResult 注册 RequestPermission 契约，替代传统的 onRequestPermissionsResult，代码更简洁且生命周期安全：
kotlin
private val requestLocalNetworkPermissionLauncher = registerForActivityResult(
ActivityResultContracts.RequestPermission()
) { isGranted ->
if (isGranted) {
navigateToWebBridge()
} else {
Toast.makeText(this, "需要本地网络权限才能访问该网页", Toast.LENGTH_SHORT).show()
}
}3.2 点击事件拦截与权限检查
点击按钮时，先通过 ContextCompat.checkSelfPermission 检查权限；已授权则直接跳转，否则发起动态申请：
kotlin
binding.btnWebBridge.setOnClickListener {
if (ContextCompat.checkSelfPermission(
this@EnvironmentSwitchActivity,
"android.permission.ACCESS_LOCAL_NETWORK"
) == PackageManager.PERMISSION_GRANTED
) {
navigateToWebBridge()
} else {
requestLocalNetworkPermissionLauncher.launch("android.permission.ACCESS_LOCAL_NETWORK")
}
}4. 总结与最佳实践
- 安全性：通过 Flavor 清单隔离，将敏感权限完全限制在开发环境，避免正式包因权限滥用而被应用商店拒审。
- 现代权限模型：采 用
registerForActivityResult托管权限回调，符合官方推荐，代码结构清晰、易于维护。 - 可扩展性：相同的隔离思路可扩展到其他调试类权限或内部工具开关，保持生产包的轻量与合规。
在实际项目中，建议将此类调试专用权限、页面及资源统一收敛到 dev 或独立的 flavor 中，从构建源头杜绝风险，既保障调试便利性，也守住应用上架的安全底线。