AndroidP RRO overlay （一）

1、Android P overlay

新年第一帖，最近又开始接手Android overlay了，说实话一开始接手overlay的时候我是拒绝的，因为我不是很喜欢和界面打交道，但是总是要恰饭的，结果越干还越有意思，这里就给大家分享一下，我的心得。
干overlay的应该都知道，android 的overlay分为静态overlay（SRO）和动态overlay（RRO），两者的区别在于SRO在编译的时候就已经决定了系统及应用的显示内容，而RRO可以系统运行的时候动态的改变系统和应用显示内容。

1.2 静态 overlay

我接触静态overlay是修改systemUI的内容的时候，不想在android 原生的systemUI目录里面添加或者修改资源文件，于是就在device目录下创建了overlay目录用来替换systemUI原生的资源 -> device/XXXX/overlay/frameworks/base/packages/SystemUI/res.
一般厂商都会有一些个性化定制的产品，会参照device目录结构创建一个vendor目录，所以有的产品的overlay需要在这个vendor目录中进行修改, 我感觉这是静态overlay比较重要的用途了吧。

原理

实际上，SRO的实现很简单，只是在通过AAPT打包成APK时，通过-S命令多增加了一个资源目录(overlay目录)而已，我们平时打包APK只是通过AAPT -S指定了一个资源目录，而Overlay又额外增加了一个资源目录而已。

这里没什么好讲的，就此略过了。

1.3 动态overlay

我们重点介绍一下RRO，这个用途还是比较广的，比较常见的就是手机系统或者应用动态换肤。
举个例子一对一的应用换肤。
1、在android原生目录frameworks/base/packages/overlays/下面创建一个HavcOverlay目录

frameworks/base/packages/overlays/HavcOverlay

2、HavcOverlay下面创建AndroidManifest.xml Android.mk 文件 和 res目录
AndroidManifest.xml 内容如下

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.android.car.havcOverlay"
    android:versionCode="1"
    android:versionName="1.0">
    <overlay android:targetPackage="com.android.car.hvac" android:priority="1"/>      
    <application android:label="havc Theme" android:hasCode="false"/>
</manifest>

package=“com.android.car.havcOverlay” ， 就是overlay package name
targetPackage=“com.android.car.hvac” ， 就是你要对那个apk做overlay的package name
android:priority=“1” ，android 是支持一个targetPackage对应多个overlay的，这个priority就是优先级，值越大表示优先级越高
android:hasCode=“false” ，大概就是这个apk只存在res资源编译，不存在code。

Android.mk

LOCAL_PATH:= $(call my-dir)
include $(CLEAR_VARS)

LOCAL_CERTIFICATE := platform

LOCAL_SRC_FILES := $(call all-subdir-java-files)

LOCAL_RESOURCE_DIR := $(LOCAL_PATH)/res

LOCAL_PACKAGE_NAME := havcOverlay
LOCAL_SDK_VERSION := current

include $(BUILD_RRO_PACKAGE)

res目录下就是你要替换的资源，比如我们要替换空调的hvac_background_color 的显示颜色，则在res创建 res/values/colors.xml文件，里面填上

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <color name="hvac_background_color">#89F5F5F5</color>
</resources>

原本的hvac_background_color是 #FF172026，我们修改后显示是#89F5F5F5

然后我们编译一下会在out/target/product/xxxx/vendor/overlay/ 目录下出现havcOverlay.apk, 把它push到我们实机的vendor/overlay/下面，重启机器机会看到变化，在实机的/data/resource-cache/ 目录下看到

vendor@overlay@hvacOverlay.apk@system@priv-app@CarHvacApp@CarHvacApp.apk@idmap

然后使用命令

idmap --inspect  vendor@overlay@hvacOverlay.apk@system@priv-app@CarHvacApp@CarHvacApp.apk@idmap

就会看到

SECTION      ENTRY        VALUE      COMMENT
IDMAP HEADER magic        0x504d4449 
             version      0x00000001 
             base crc     0x533713cd 
             overlay crc  0xbce2eda9 
             base path    .......... /system/priv-app/CarHvacApp/CarHvacApp.apk
             overlay path .......... /vendor/overlay/hvacOverlay.apk
DATA HEADER  target pkg   0x0000007f 
             types count  0x00000001 
DATA BLOCK   target type  0x00000005 
             overlay type 0x00000002 
             entry count  0x00000001 
             entry offset 0x000000a7 
             entry        0x00000000 color/hvac_background_color

base path    .......... /system/priv-app/CarHvacApp/CarHvacApp.apk           ，target package name
overlay path .......... /vendor/overlay/hvacOverlay.apk                      ，overlay package name
types count  0x00000001                                                      ，表示替换的资源数量
entry        0x00000000 color/hvac_background_color                         ，我们替换的资源名

你可以通过命令来取消或者使能 overlay package

adb shell cmd overlay enable --user 0  com.android.car.hvacOverlay
adb shell cmd overlay disable --user 0  com.android.car.hvacOverlay

接下来主要讲解RRO的原理.