Android编译APK后Wiz灯泡UDP广播设备发现失败问题求助

核心原因分析 #

调试版（app-debug.apk）能正常工作，是因为：

• 调试模式下Android系统会自动豁免部分权限校验
• 默认关闭代码混淆，不会破坏Wiz库的UDP通信逻辑
• 调试环境中可能已自动授予所需权限

而Release版（用flutter build apk --split-per-abi编译）出现问题，大概率和权限动态申请、代码混淆、网络安全限制这三点有关，下面是具体解决步骤：

1. 补全动态权限申请逻辑 #

你的AndroidManifest.xml里仅声明了静态权限，但Android 6.0（API 23）及以上系统，部分关键权限需要在运行时主动申请：

• 部分安卓设备要求ACCESS_FINE_LOCATION权限才能扫描局域网设备，UDP广播依赖局域网扫描
• 静态声明CHANGE_WIFI_MULTICAST_STATE不代表运行时已获得授权

在Flutter中可以用permission_handler包实现动态申请，示例代码：

import 'package:permission_handler/permission_handler.dart';

Future<void> requestRequiredPermissions() async {
  final permissionStatuses = await [
    Permission.location,
    Permission.networkState,
    Permission.wifiStatus,
  ].request();
  
  // 检查权限是否全部通过，未通过则提示用户开启
  if (permissionStatuses.values.any((status) => status.isDenied)) {
    // 这里可以添加弹窗提示用户前往设置页开启权限
  }
}

要确保在点击sync按钮前调用这个方法，保证权限已授予。

2. 禁用Wiz库的代码混淆 #

Release版默认开启R8代码混淆，可能会把Wiz库中UDP通信相关的类、方法混淆，导致广播逻辑失效。在android/app/proguard-rules.pro中添加以下规则：

# 保留Wiz库的所有类和方法，避免混淆破坏通信逻辑
-keep class io.github.ayjf.wiz.** { *; }

同时确保android/app/build.gradle中minifyEnabled为true时，已正确引用该规则文件。

3. 添加局域网网络安全配置 #

Android 9（API 28）及以上系统默认限制明文网络请求，部分设备会连带限制局域网内的UDP通信。可以添加网络安全配置文件：

1. 在android/app/src/main/res/xml目录下创建network_security_config.xml：

<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <domain-config cleartextTrafficPermitted="true">
        <domain includeSubdomains="true">192.168.0.0/16</domain>
        <domain includeSubdomains="true">10.0.0.0/8</domain>
        <domain includeSubdomains="true">172.16.0.0/12</domain>
    </domain-config>
</network-security-config>

2. 在AndroidManifest.xml的<application>标签中添加引用：

android:networkSecurityConfig="@xml/network_security_config"

4. 测试非ABI拆分的Release包 #

先尝试用flutter build apk（不带--split-per-abi参数）编译Release包，验证是否能正常工作。如果可以，说明拆分ABI时某架构的网络库存在兼容性问题，可针对性排查对应架构的编译配置。

内容的提问来源于stack exchange，提问作者davidbe