如何判断Android应用运行在鸿蒙系统上

「椎锋陷陈」微信技术号现已开通，为了获得第一手的技术文章推送，欢迎搜索关注！

前言

不久前，HarmonyOS 2.0的正式发布，在华为用户及科技产品爱好者之间掀起了不小的波澜。其中，讨论关于HarmonyOS是如何兼容Android应用的话题最为频繁，从而引发了多方阵营关于「HarmonyOS究竟是否是套壳Android」的激烈争论。

与此同时，部分嗅到风向的开发者，已经在部署如何收集应用在HarmonyOS上的兼容情况了。这不，笔者所在的公司就安排我去进行相关的技术调研。其中，最重要的一点就是判断当前应用是否搭载在了HarmonyOS上，从而统计升级HarmonyOS的用户数量，作为后续公司战略方向可能调整的依据。

OpenHarmony与HarmonyOS

首先，让我们先为前面的争论下一个明确的定论，即：

HarmonyOS并非套壳Android。

我们通常意义上所讲的HarmonyOS，实际分成了两部分，一部分是 OpenHarmony，另一部分则是包括HMS在内的闭源应用与服务。

OpenHarmony是由开放原子开源基金会孵化及运营的开源项目，其性质与定位可参照Android开放源代码项目(AOSP) 。

而HarmonyOS 2.0则是华为基于OpenHarmony 2.0开发的面向多种全场景智能设备的商用版本。HarmonyOS 2.0遵循了AOSP的开源许可，从而实现了现有Android生态应用在部分搭载HarmonyOS 2.0的设备上的正常运行。

目前在HarmonyOS 2.0上存在两种类型的应用，即

纯HarmonyOS应用（指基于HarmonyOS开发的应用，不能安装在其他Android手机上，应用体积很小，但同时功能也很少）
支持HarmonyOS特性的应用（基于Android开发的应用，但是使用了 HarmonyOS的特性，通过工具导出时后缀仍然是APK）

HarmonyOS检测方法

现在回到我们最初的需求，即基于Android开发的应用，该如何判断是否是搭载在了HarmonyOS上呢？

对于这个问题的我的第一个解决思路就是：

通过读取Android系统配置，遍历能够作为判断依据的属性

Android系统配置介绍

为了让所有运行中的进程共享系统运行时所需要的各种属性值，Android系统开辟了属性存储区域，并提供了访问该区域的API。属性由键(key)与值(value)构成，两者都是字符串类型。

属性被大量使用在Android系统中，用来记录系统设置或进程之间的信息交换。属性是在整个系统中全局可见的。每个进程可以get/set属性。

我们可以通过以下两种方式访问到系统配置中的属性值：

adb命令行工具

adb shell getprop 可以查看手机上所有属性值。
abb shell getprop xxx 可以查看某个指定属性值。

SystemProperties类

Systemproperties类在android.os目录下，但这个类是被标记为隐藏的，上层应用开发无法直接使用，但我们可以用反射的方式调用。创建/修改属性可以用Systemproperties.set(property,value)方法，获取属性则可以用Systemproperties.get(property)方法。

比如，我们可以通过此方式获取设置-关于手机中显示的版本号：

/*** 获取鸿蒙系统版本号*/
fun getHarmonyOsVersion(): String {return if (isHuaweiBrand() && isHarmonyOs()) {try {val cls = Class.forName("android.os.SystemProperties")val method = cls.getMethod("get", String::class.java)method.invoke(cls, "ro.huawei.build.display.id") as String} catch (e: Exception) {"-1"}} else {"-1"}
}

当然，这个版本号可以用一种更直接的方式获取：

/*** 获取鸿蒙系统版本号*/
fun getHarmonyOsVersion(): String {return if (isHuaweiBrand() && isHarmonyOs()) {Build.DISPLAY} else {"-1"}
}

通过阅读源码我们可以得知，其真正的实现也是通过调用SystemProperties.get(property)进行的，底层通过jni调用native方法实现属性的存取：

    public static final String DISPLAY = getString("ro.build.display.id");private static String getString(String property) {return SystemProperties.get(property, UNKNOWN);}public static String get(@NonNull String key, @Nullable String def) {if (TRACK_KEY_ACCESS) onKeyAccess(key);return native_get(key, def);}

但是很遗憾，遍历了所有的属性值之后，发现跟OS相关的属性值仍是关联到Android系统的，唯一出现Harmony字样的，是一个默认来电铃声的属性值：

所以，想要以此方案作为判断依据，我们需要通过读取默认来电铃声属性值并判断是否以Harmony结尾，但由于目前我手头上只有一台升级到HarmonyOS 2.0的手机，无法确保在其他机型的手机上该属性值也一致，因此只能将此方案作为保留方案。

另外一个解决思路则是：

通过是否支持调用HarmonyOS Java API来判断。

至于调用方式，和你猜想的一样，依然是以反射的形式，看看能否在运行时获取相关API的类的Class对象。

在HarmonyOS开发者官网上可以看到，最新发布的HarmonyOS SDK Release版的版本号是2.1.1.21，API版本为5（截至2021.6.22）。

而在HarmonyOS Java API文档中通过Since来标记包、类或接口等开始支持的版本号，如“Since：1”表示从API Version 1开始支持。

于是我们选择最新的API版本为5的类来作为试验对象：

具体代码也很简单，使用Class类的forName静态方法，以完整类名为参数获取Class对象，如果Class对象不为空，即可证明当前应用搭载在了HarmonyOS上：

/*** 当前是否是鸿蒙系统* 根据是否能调用Harmony JAVA API判断*/
fun isHarmonyOs(): Boolean {return try {val cls = Class.forName("ohos.utils.system.SystemCapability")cls != null} catch (e: Exception) {false}
}

一点小疑惑

我为什么要选择API版本为5的类来判断呢？这是因为，通过是否支持调用HarmonyOS Java API来判断应用搭载在HarmonyOS的设备上这种思路，其实我一开始就想到了，但我最初是选用了HarmonyOS开发者官网第一个介绍的特性——Ability相关的类，而该类的API版本为1。

测试发现，升级了HarmonyOS和未升级的手机上居然都能够获取到Ability的Class对象！！！

百思不得其解的我，直到在查阅了HarmonyOS的历史版本说明后才注意到以下这一句：

于是进一步在HarmonyOS开发者的官方公众号上确认，得到了以下回复：

因此证明，通过是否支持调用HarmonyOS Java API来判断应用搭载在HarmonyOS的设备上这种思路是正确的，但要选用API版本为5的类才可以。

但是另外一个疑惑又产生了，即未升级HarmonyOS的手机为什么也能调用API版本低于5以下的HarmonyOS Java API呢？难道HarmonyOS的一部分特性相关的库早就在现有华为手机的EMUI上部署了吗？此问题目前还得不到合理的解释。

总结

为了减少用户的迁移成本，保护用户的现有数据，现阶段的HarmonyOS选择了在遵循AOSP的开源许可基础上兼容Android生态应用。

也是由于这一点，加上华为开发者官网上并没有明确给出API，导致基于Android开发的应用，要判断是否搭载在HarmonyOS上会比较迂回。

目前比较可靠的方式，是通过是否支持调用HarmonyOS Java API来判断，并且必须选择API版本为5的类。

如果你有更好的方式，欢迎在文章下方留言告诉我，谢谢~

「椎锋陷陈」微信技术号现已开通，为了获得第一手的技术文章推送，欢迎搜索关注！

参考

OpenHarmony和HarmonyOS有什么区别？
https://developer.huawei.com/consumer/cn/forum/topic/0202596835671930522?fid=0101303901040230869

HarmonyOS Java API参考
https://developer.harmonyos.com/cn/docs/documentation/doc-references/systemversion-0000001054358980#ZH-CN_TOPIC_0000001054358980__getReleaseType–

Android 系统属性SystemProperty分析
https://blog.csdn.net/yangwen123/article/details/8936555