Android 官方RRO机制Demo示例 - 不改一行源码实现动态换肤

前言

最近参与了一个OEM的项目研发，其中有一个需求是实现主题功能，类似华为手机上的主题应用。从云端下载主题包然后换肤。实现过程中发现Google有一套RRO的动态资源加载机制，比较符合我们的要求，于是乎开始了踩坑。
由于网上很多RRO的文档都是从一个地方转载的，并且也没有上传Demo，也没有介绍Android10，11 之后RRO机制有哪些变化，因此写了这篇blog，对自己的调研做记录的同时，也希望能给你提供一些帮助。

先来看下Demo效果：

Demo演示了

1. 在Activity打开时启用/禁用资源包（界面会闪一下）
2. 在Activity退出后启用/禁用资源包
3. 在Activity退到后台启用/禁用资源包（视觉感受有一个短暂的资源过度）

RRO机制支持的替换范围

经demo测试，RRO可支持范围如下：

• res/values 下的资源，包括colors，dimens，strings，styles下的资源替换
• res/anim中的资源替换
• res/drawable，res/mipmap下的资源替换
• res/raw下的资源替换

layout文件替换有诸多限制，因此不建议替换。
layout布局可以替换，但是有局限性。相关的布局文件替换后，view通过findviewBid 找不到对应的view对象返回为null。

内容

环境介绍

Google官网文档：运行时资源叠加层 (RRO)

按照文档上说的，这套机制支持res/values 下面几乎所有的资源替换，不依赖Android系统源码编译，不依赖第三方APP，只需要知道对应的资源名就可以改。

• 在androd 10上还可以支持，对targetAPP指定可被覆盖的资源。

• 在android 11 还支持了 一种新的编译写法OverlayConfig，详情见官方文档Using OverlayConfig 章节。

模拟器用的是Android9.0 （andrid 10 reboot后总是起不来）

详细的SDK版本等自行下载Demo看吧

https://github.com/ieewbbwe/ThemeRRODemo

需要有系统签名，或者有ROOT权限，没有这些条件的请移步Android-skin-support，一个第三方库实现应用换肤

RRO机制实现

创建目标应用

也就是要被替换资源的应用，下称TargetAPP

大致长这样

创建资源包

也就是创建要覆盖targetAPP的资源，下称OvserlayApp

核心代码是在AndroidManifest.xml中做如下配置，priority越高表示优先级越高，最高999，targetPackage写上要覆盖的包名。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.theme_rro">

    <application android:hasCode="false" />

    <overlay
        android:priority="20"
        android:targetPackage="com.example.target" />
    <!--com.picherdemo.demophone-->

</manifest>

安装资源包

adb install overlay.apk
若不是系统签名则会安装失败，处理办法见下文

启动/停止资源包

//1. 先看一下资源包有没有安装成功
adb shell cmd overlay list

//2. 启用资源包
adb shell cmd overlay enable overlayAppPackageName
//3. 禁用资源包
adb shell cmd overlay disable overlayAppPackageName

//若有多用户的话需要指定UserID
adb shell pm list users // 查看是否有多用户
adb shell cmd overlay enable --user 0 overlayAppPackageName

APP Widget也可以生效

但是需要重启系统才能生效，应该可以定制FW刷新launcher就可以了（待验证）。

下图是换肤后的截图，可见把widget的图标，背景都换掉了。

遇到的问题及解决

Failure [INSTALL_FAILED_INTERNAL_ERROR: Scanning Failed.: Overlay com.example.theme_rro must target Q or later, or be signed with the platform certificate]
在安装Overlay.apk的时候可能会出现这个问题，问题也写了，需要系统签名才能安装。这个问题解决如下

//1. 在命令行以可写模式启动系统
D:\sdk\emulator>emulator -avd Nexus_6P_API_29 -writable-system

//2. ROOT系统
adb root

//3. 重新挂载
adb remount

//4. 把OvserlayApp push到vendor/overlay/ 
adb push overlay.apk /vendor/overlay/

// 若上一步不成功直接在AS Device File Explorer 中创建目录，并把APKupload上去 
// 此时adb install 可能会报错Failure [INSTALL_FAILED_TEST_ONLY: installPackageLI]，别慌，执行下面的命令，重启下设备（别说麻烦，有系统签名也没这些事儿）
adb install -t overlay.apk

//若还不成功，adb reboot 一次后再试

原理分析

Android资源管理框架-------之OverlayManagerService简介及其数据的维护更新（二)
这个博主分析的比较好了，这里就不重复写内容了，大家可以异步去看下。主要是OMS的资源加载机制。

这套机制是把原Activity杀掉，在新建一个Activity，走的生命周期如下图：

总结

至此，基本实现了不改动TargetAPP中一行代码，实现资源文件的替换。

优点：Google官方支持的方案，简单

缺点：需要有系统签名，或者root权限;Launcher无法动态改变，需要FW配合刷新。

还有一套 SRO的静态资源加载机制，在编译系统镜像时选择对应的资源包，需要了解的请查看官方文档

参考文档：

Android Overlay机制
Android adb remount failed处理及Read-only file system处理(Android O)
How to use RRO framework to tune system app custom defined colors?
Android 运行时资源替换