无需USB在Android真机上测试应用 打包后安装运行失败求助

第一步：确认打包类型与签名配置 #

• 首先排查打包的变体类型：Android Studio默认USB调试运行的是debug变体，直接打包debug包发送到其他设备，可能因为调试权限限制、签名不匹配问题无法安装或运行，建议优先打包带正式签名的release包
• 检查release包签名配置：打开build.gradle(Module: app)，确认android节点下的signingConfigs配置了有效签名文件，且buildTypes.release节点配置了signingConfig signingConfigs.release
• 检查混淆规则适配：如果release变体开启了代码混淆（minifyEnabled = true），必须在proguard-rules.pro中添加OneSignal对应的混淆规则，避免API相关类被混淆后无法正常调用

第二步：排查运行时权限与网络配置 #

• 确认基础权限配置：OneSignal需要联网能力，检查AndroidManifest.xml中是否已添加android.permission.INTERNET、android.permission.ACCESS_NETWORK_STATE权限声明
• 适配高版本系统网络规则：如果测试设备系统为Android 9及以上，且OneSignal相关请求存在http明文流量，需要在Manifest的application节点添加android:usesCleartextTraffic="true"，或者配置对应的networkSecurityConfig规则
• 检查通知动态权限：Android 13及以上系统需要主动申请POST_NOTIFICATIONS权限，打包后的应用首次启动如果没有申请该权限，点击按钮调用发送通知逻辑会直接失败

第三步：正确打包与分发操作 #

• 测试阶段优先导出带签名的APK：操作路径为Android Studio顶部菜单 `Build > Generate Signed Bundle / APK > 选择APK选项 > 导入签名文件 > 选择release变体 > 打包完成后将生成的APK发送到设备安装即可
• 若需要分发给多人测试，可将打包后的APK直接通过社交工具传输，不需要额外依赖USB连接即可安装使用

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