在 aosp 中启用 Material You design

由于项目原因,近期研究了一下如何在 aosp 中启用 Material You design,在把踩过的坑记录一下,方便后续有厂商可以快速集成。

作者:Mr_万能胶 

链接:https://juejin.cn/post/7262982452767457337

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

Material You design 是什么

Material You design 是 Google 2021年5月18日宣布的最新视觉设计风格,我经常把它简单描述成“你一眼看上去那种扁扁的,彩色的,都是矢量图形的风格”,下面这张图大家看一眼就明白了。

0871246ca13b20922d5aeb4dd37fd310.jpeg

Google 对自己的这套视觉风格一直很自信。这套主题最大的特点就是,它有一个“主题色”的概念。用户选择了一个主题色之后,系统里的大部分控件,只要应用了这套主题,颜色都会跟着变成这个主题色。而除了应用,框架里比如 SystemUI 这样的模块,由于也应用了这套主题,因此也会跟着主题色走。

aosp 在 2021年8月也导入了这套主题,但不知道为什么一直没有默认启用,这篇文章就教大家如何启用。

在框架中启用 Material You design

配置 SystemUI

打开 frameworks/base/packages/SystemUI/res/values/flags.xml,确保 flag_monet值为 true。这一点 aosp 最新版本现在默认值已经为 true 了,作为厂商可以二次确认一下,防止编译时被 overlay 了。

ThemePicker 配置权限

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。

72a69eb68ced571de79d84db0379da0e.jpeg

打开之后,可以在下面看到主题色选项:

143b188990ad1ec8656e29c19925172e.jpeg

切换一个颜色,然后拉下通知中心查看,可以看到整个系统的控件都变成了对应的颜色:

464bb0140894f3f414ca6cf2a06c584a.jpeg

再换一套其它的颜色看看:

2d9e85dbc8ea1b9071b7ca5866c035ce.jpeg

最后,检查一下主题图标(Themed icon)功能 是否正常:

3784abf2e3a08847cad7494108dcae9e.jpeg

厂商定制 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 库白名单,你需要提单请他们加上。(搞不明白为啥要这么麻烦)

关注我获取更多知识或者投稿

e2ee685c408e77069410f2417c3621be.jpeg

d310c5101f074de3aa534edf09cbecb4.jpeg

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
AOSP 工程使用 Gradle 有两种方式: 1. 使用 Android Studio 进行开发,Android Studio 默认使用 Gradle 进行编译构建。你可以在 Android Studio 导入 AOSP 工程,然后进行开发。 2. 在命令行使用 Gradle 进行编译构建。在 AOSP 工程,Gradle 通常用于构建一些独立的模块,例如一些应用程序、库等。你可以在模块的 build.gradle 文件配置 Gradle 构建任务。 举例来说,如果你要在 AOSP 工程使用 Gradle 编译一个应用程序,可以按照以下步骤进行: 1. 在应用程序的目录创建一个 build.gradle 文件,然后配置应用程序的编译选项,例如: ``` apply plugin: 'com.android.application' android { compileSdkVersion 30 buildToolsVersion "30.0.2" defaultConfig { applicationId "com.example.myapp" minSdkVersion 21 targetSdkVersion 30 versionCode 1 versionName "1.0" } buildTypes { debug { debuggable true } release { debuggable false minifyEnabled true proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro' } } } dependencies { implementation 'com.android.support:appcompat-v7:30.0.0' } ``` 2. 在命令行进入应用程序目录,然后执行以下命令: ``` gradle assembleDebug ``` 该命令将编译应用程序并生成一个 APK 文件。你可以使用 adb 命令将 APK 文件安装到设备上进行测试。 需要注意的是,Gradle 在 AOSP 工程的使用比较复杂,需要掌握一定的 Gradle 知识和 AOSP 架构知识。如果你是初学者,建议先学习 Android 开发和 Gradle 相关知识,然后再尝试在 AOSP 工程使用 Gradle。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值