Android Studio编译的APP仅USB连接设备可运行 其他设备安装失败

1. 排查安装包类型与签名问题 #

• 首先确认你分享的不是测试签名的Debug包：Android Studio默认运行到调试设备时生成的Debug包，使用的是IDE自动生成的非正式测试签名，多数安卓系统会默认禁止安装这类未经过正式签名的应用
• 正确构建正式安装包的步骤：
  1. 点击Android Studio顶部菜单栏 Build > Generate Signed Bundle / APK
  2. 选择APK选项后点击下一步
  3. 新建或选择已有的jks签名文件，填写签名密码、别名等对应信息
  4. 构建类型选择Release，同时勾选V1(Jar Signature)和V2(Full APK Signature)两个签名选项后执行构建

2. 排查设备兼容性配置问题 #

• 检查模块级build.gradle文件中的minSdk配置：如果目标安装设备的安卓系统版本低于你配置的最低支持版本，会直接触发安装失败，参考配置如下：

  android {
      defaultConfig {
          // 确认该值不高于目标设备的Android API等级
          minSdk 21
          targetSdk 33
          versionCode 1
          versionName "1.0"
      }
  }
  

• 排查ABI架构适配问题：如果项目引入了原生so库，没有对应目标设备CPU架构的so包也会安装失败，可以通过如下配置适配全架构：

  android {
      defaultConfig {
          ndk {
              abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
          }
      }
  }
  

3. 排查目标设备限制问题 #

• 确认目标设备已经开启「允许安装未知来源应用」权限，不同品牌设备的开启路径略有差异，一般在设置的安全、隐私或应用管理板块
• 如果目标设备之前安装过同包名但签名不一致的应用，需要先卸载旧版本再安装新包

4. 排查安装包传输损坏问题 #

• 不要通过微信、QQ等会自动压缩/修改文件的渠道传输APK，这类渠道可能会修改APK后缀或损坏安装包，建议通过蓝牙、邮箱附件或者文件直传的方式分享

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