在 aosp 中启用 Material You design

因为项目原因，近期研究了一下如安在 aosp 中启用 Material You design，在把踩过的坑记载一下，便利后续有厂商能够快速集成。

本文基于 aosp 最新代码，版别号为 Android 13，并运用 Cuttlefish 快速验证。

Material You design 是什么

Material You design 是 Google 2021年5月18日宣告的最新视觉规划风格，我常常把它简单描述成“你一眼看上去那种扁扁的，五颜六色的，都是矢量图形的风格”，下面这张图咱们看一眼就理解了。

Google 对自己的这套视觉风格一向很自信。这套主题最大的特色就是，它有一个“主题色”的概念。用户挑选了一个主题色之后，体系里的大部分控件，只要使用了这套主题，色彩都会跟着变成这个主题色。而除了使用，结构里比方 SystemUI 这样的模块，因为也使用了这套主题，因而也会跟着主题色走。

aosp 在 2021年8月也导入了这套主题，但不知道为什么一向没有默许启用，这篇文章就教咱们如何启用。

在结构中启用 Material You design

装备 SystemUI

翻开 frameworks/base/packages/SystemUI/res/values/flags.xml，保证 flag_monet值为 true。这一点 aosp 最新版别现在默许值现已为 true 了，作为厂商能够二次确认一下，防止编译时被 overlay 了。

为 ThemePicker 装备权限

留意：此步骤已不再需求，因为有开发者现已修正了此问题：android-review.googlesource.com/c/platform/…

Google 把 Pixel 的壁纸挑选器脱敏之后，开源在了 packages/apps/ThemePicker，可是他们似乎把权限装备文件忘记开源了，假如咱们直接把 ThemePicker 编进体系，开机之后 system_server 会一向报错如下：

 java.lang.IllegalStateException: Signature|privileged permissions not in privapp-permissions allowlist: {com.android.wallpaper (/system_ext/priv-app/ThemePicker): android.permission.SET_WALLPAPER_COMPONENT, com.android.wallpaper (/system_ext/priv-app/ThemePicker): android.permission.BIND_WALLPAPER, com.android.wallpaper (/system_ext/priv-app/ThemePicker): android.permission.WRITE_SECURE_SETTINGS, com.android.wallpaper (/system_ext/priv-app/ThemePicker): android.permission.READ_WALLPAPER_INTERNAL, com.android.wallpaper (/system_ext/priv-app/ThemePicker): android.permission.MODIFY_DAY_NIGHT_MODE, com.android.wallpaper (/system_ext/priv-app/ThemePicker): android.permission.CHANGE_OVERLAY_PACKAGES}
      at com.android.server.pm.permission.PermissionManagerServiceImpl.onSystemReady(PermissionManagerServiceImpl.java:4389)
      at com.android.server.pm.permission.PermissionManagerService$PermissionManagerServiceInternalImpl.onSystemReady(PermissionManagerService.java:739)
      at com.android.server.SystemServer.startOtherServices(SystemServer.java:2719)
      at com.android.server.SystemServer.main(SystemServer.java:651)
      at java.lang.reflect.Method.invoke(Native Method)
      at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:552)
      at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:930)

解决方案也简单，咱们只需求把权限装备补上就行。在 packages/apps/ThemePicker下面新建一个 privapp_whitelist_com.android.wallpaper.xml，内容如下：

<?xml version="1.0" encoding="utf-8"?>
<permissions>
    <privapp-permissions package="com.android.wallpaper">
        <permission name="android.permission.CHANGE_OVERLAY_PACKAGES"/>
        <permission name="android.permission.MODIFY_DAY_NIGHT_MODE"/>
        <permission name="android.permission.SET_WALLPAPER_COMPONENT"/>
        <permission name="android.permission.WRITE_SECURE_SETTINGS"/>
        <permission name="android.permission.BIND_WALLPAPER"/>
        <permission name="android.permission.READ_WALLPAPER_INTERNAL"/>
    </privapp-permissions>
</permissions>

接着翻开 packages/apps/ThemePicker/Android.bp，找到 android_app ，在里面做如下改动：

android_app {
    name: "ThemePicker",
    defaults: ["ThemePicker_defaults"],
    platform_apis: true,
    manifest: "AndroidManifest.xml",
    additional_manifests: [":WallpaperPicker2_Manifest"],
    overrides: ["WallpaperPicker2"],
    required: ["privapp_whitelist_com.android.wallpaper"],
    privileged: true,
}
prebuilt_etc {
    name: "privapp_whitelist_com.android.wallpaper",
    system_ext_specific: true,
    src: "privapp_whitelist_com.android.wallpaper.xml",
    sub_dir: "permissions",
    filename_from_src: true,
}

增加 ThemePicker、ThemesStub 到 PRODUCT_PACKAGES

因为计划用 Cuttlefish 验证，因而翻开 device/google/cuttlefish/vsoc_x86_64/phone/aosp_cf.mk，在末尾增加：

PRODUCT_PACKAGES += \
    ThemePicker \
    ThemesStub \

ThemePicker、ThemesStub 是两个不同的 Apk，前者实现了原生 WallpaperPicker2 模块的部分接口，后者是 Material You design 在 aosp 的默许色彩方案，详细介绍能够在这里检查。

启用主题图标（Themed icon）功能

Google 并没有提供这一块的文档，可是咱们能够从 ThemePicker 的源码里寻觅蛛丝马迹。

检查 packages/apps/ThemePicker/src/com/android/customization/model/themedicon/ThemedIconSwitchProvider.java

/** Returns the {@link ThemedIconSwitchProvider} instance. */
public static ThemedIconSwitchProvider getInstance(Context context) {
    if (sThemedIconSwitchProvider == null) {
        Context appContext = context.getApplicationContext();
        sThemedIconSwitchProvider = new ThemedIconSwitchProvider(
                appContext.getContentResolver(),
                new ThemedIconUtils(appContext,
                        appContext.getString(R.string.themed_icon_metadata_key)),
                (CustomizationPreferences) InjectorProvider.getInjector()
                        .getPreferences(appContext));
    }
    return sThemedIconSwitchProvider;
}

<!--Name of metadata in the main launcher Activity which values contains the authority
corresponding to a ContentProvider in launcher to query or change themed icon option  -->
<string name="themed_icon_metadata_key" translatable="false">com.android.launcher3.themedicon.option</string>

一下子就理解了，原来是经过读取 Launcher 有没有对应的 meta-data 来判别的，如此一来就好办了，咱们需求修正 packages/apps/Launcher3/AndroidManifest.xml 和packages/apps/Launcher3/quickstep/AndroidManifest-launcher.xml 这两个文件，补上对应的 meta-data:

            <!-- 原生 -->
            <meta-data
                android:name="com.android.launcher3.grid.control"
                android:value="${packageName}.grid_control" />
            <!-- 弥补 -->
            <meta-data
                android:name="com.android.launcher3.themedicon.option"
                android:value="${packageName}.grid_control" />

Material You design 作用验证

发动 Cuttlefish，依次进入Settings ->Wallpaper，能够看到多出来一个 Wallpaper & style 使用，这个就是咱们上面集成的 ThemePicker。

翻开之后，能够在下面看到主题色选项：

切换一个色彩，然后拉下通知中心检查，能够看到整个体系的控件都变成了对应的色彩：

再换一套其它的色彩看看：

最后，检查一下主题图标（Themed icon）功能 是否正常：

厂商定制 FAQ

Q：我必定要用 aosp 的这个 ThemePicker 吗？

A：不必定，aosp 的 ThemePicker 也仅仅 Pixel 里“抠”出来的，目的是告诉你对应的色彩值需求怎么设置，实质其实是向 Settings.Secure.THEME_CUSTOMIZATION_OVERLAY_PACKAGES写入了一些装备，详细能够参阅 ColorCustomizationManager，把里面的逻辑抽到厂商自己的主题美化 App 或其他功能模块去。

cs.android.com/android/pla…

Q：ThemesStub 是必定需求的吗？

A：取决于你是否用原生的 ThemePicker，假如决议用原生的 ThemePicker，就必须要。ThemesStub 包含了一套预先定义好的主题色方案，厂商能够经过 RRO 的方式来修正这些色值，或许也能够参阅 Stub APK format 来开发自己的 ThemesStub。留意，假如挑选原生 ThemePicker + 自己开发 ThemesStub，需求修正 /packages/apps/ThemePicker/res_override/values/override.xml，告诉 ThemePicker 你的 ThemesStub 包名是什么。

    <!-- Package of the stub apk containing the themes descriptions -->
    <!-- 下面包名是原生 ThemesStub 的包名 -->
    <string name="themes_stub_package" translatable="false">
        com.android.customization.themes
    </string>

Q：为什么第三方 App 装到我的手机上，仍是没办法跟从主题色？

A：可能是你的厂商不在 Google 的 Material Design 库白名单，你需求提单请他们加上。（搞不理解为啥要这么麻烦）

参阅资料

source.android.com/docs/core/d…

gist.github.com/zhaofengli/…