为什么我把 Run 出来的 Apk 发给老板,却装不上!

一. 序

当我们在 Android Studio 中,直接 Run 一个项目时,AS 会自动打一个 Debug 的 Apk,并通过 ADB 命令,将 App 安装到我们连接的设备上。

这个 Run 出来的 Apk,在工程的 build/ 目录可以找到。如果你还想把这个 Apk 分享出去,抢先体验功能,不好意思,正常情况下,这个 Apk 是无法安装的。

接下来看看,是什么导致 Run 出来的 APK 无法安装。

二. Run 的 Apk

2.1 textOnly 属性

我们知道,AS Run 起来的 Apk,会使用 Debug 签名进行签名,不过安装不上,并不是签名的问题。

而是因为,Run 出来的 APK,会在 AndroidManifest.xml 文件中,增加 android:textOnly 属性,正是因为这个属性,阻止了我们使用正常方式安装 APK。

android:testOnly 对应的是 ApplicationInfo 中的 FLAG_TEST_ONLY ,这个 Flag 最早在 Api Level 4 就已经存在,使用它不会有任何低版本兼容的问题。

当你使用 adb install 安装 android:testOnly="true" 的包时,输出的错误信息,明确的标记了无法安装一个 TEST_ONLY 的包。

Failed to install app-debug.apk: Failure [INSTALL_FAILED_TEST_ONLY: installPackageLI]

对于多年 Android 经验的开发者来说,如果曾经将 Run 出来的 Debug.apk 分享给别人时,早年间是可以正常安装的,那 textOnly 属性是在什么时候被加在 Debug.apk 上的呢?

虽然 FLAG_TEST_ONLY 属性最早可以追溯到 APK Level 4,但是它其实是在 Android Studio 3.0 上才被默认加入到 APK 中的。只有 AS 3.0+ 的 IDE 上,Run 出来的 APK,才会默认带上 textOnly 属性,这将阻止你使用正常的方式安装。

简单小结一下:

  1. 我们无法通过正常安装方式,安装一个带有 android:textOnly="true" 的 Apk。

  2. 这个属性,是在 AS 3.0 中加入的。

这就是为什么你无法安装 Run 出来的 Debug.apk。

2.2 为什么要这么设计?

这个问题,对于大多数开发者来说,基本上不是问题。

因为我们只要保证正常的提测、发布流程,基本上是很难将一个 Run 出来的 Apk 分享给别人的。

textOnly 只是一个标记,标记了它是一个测试的版本,其实并没有任何实质性的东西。如果因为流程上的失误,将其分享出去,这也是很容易就可以发现的,因为这个包正常流程无法安装。

2.3 是不是真的无法安装?

如果我们非要安装一个带有 textOnly 的 Apk,其实也是有办法的,否者 AS 又是如何将 Run 起来的包,安装到设备上的呢?

解决方法也很简单,只需要在 adb install 上,增加 -t 即可。

adb install -t debug.apk

如果想要阻止 AS 在 Run 时,构建的 APK 中增加 android:textOnly 标记,也是有办法的。

可以在 gradle.properties 文件中,增加 android.injected.textOnly=false 即可。

# gradle.properties
android.injected.testOnly=false

然后这个 android:textOnly 属性就会消失。

三. 小结时刻

AS Run 出来的 Apk,之所以无法安装,是因为其携带了 FLAG_TEXT_ONLY 这个 Flag,它会阻止我们使用正常的方式安装。想要安装,可以通过 adb install -t 来解决。

虽然这个 Flag 初始于 API Level 4,但是它在 AS 3.0 中,才被默认加入。想要去掉可以通过增加 android.injected.textOnly=false 来实现。

这个问题当个小知识点了解一下即可,正常我们也不会遇到这样的问题,毕竟谁会把一个 Run 出来的包出去呢。

references:

https://commonsware.com/blog/2017/10/31/android-studio-3p0-flag-test-only.html

本文对你有帮助吗? 留言、转发、点好看 是最大的支持,谢谢!

联机圆桌 」:point_left:推荐我的知识星球,一年 50 个优质问题,上桌联机学习。

公众号后台回复成长『 成长 』,将会得到我准备的学习资料,也能回复『 加群 』,一起学习进步。