实战多屏Wallpaper壁纸显示及出现黑屏问题bug分析-学员作业

背景：

在大家看了上一篇google官方对于多屏壁纸这块的介绍后

安卓Wallpaper壁纸部分对多屏的支持-Google官方文档介绍

可能还是对于壁纸支持多屏这块没有相关的实战性的认知，所以本文就开始带大家来进行部分解读和实战。

壁纸多屏显示原理文档解读：

原文：
开发者可以通过在 WallpaperInfo XML 定义中提供 android:supportsMultipleDisplays=“true” 来声明对壁纸功能的支持。壁纸开发者还可以使用 WallpaperService.Engine#getDisplayContext() 中的显示上下文来加载素材资源。
框架会为每个屏幕创建一个 WallpaperService.Engine 实例，因此每个引擎都有自己的 surface 和显示上下文。开发者需要确保每个引擎都能够根据 VSYNC 以不同的帧频独立绘制。

上面这段说明可以得出以下几点：
1、在自定义动态壁纸时候，是有单独的xml可以来配置壁纸相关属性，可以通过
android:supportsMultipleDisplays=“true” 这个属性来告诉系统当前壁纸是支持多屏显示的

那么自定义壁纸又是如何识别当前运行于哪个屏幕？然后针对不同的屏幕绘制不同的资源和内容呢？

2、因为自定义壁纸本身就是继承WallpaperService重写一个壁纸服务，每个服务可以通过WallpaperService.Engine#getDisplayContext() 方法获取到自己在不同的屏幕，简单说就是WallpaperService有自己context，可以通过context获取到自己的Display，也就是多个屏幕会有多个WallpaperService而且Service中可以识别自己对应的display，这样就可以差异识别。

比如看看自定义壁纸中绘制可以绘制自己的DisplayID来作为区分

那么真的就像官方文档中说的那么顺利么？

作业准备：

源码环境：aosp15测试，预计aosp14,aosp13应该也一样可以

第一步

首先得准备一个自定义的动态壁纸，具体大家可以直接源码中寻找demo拿来用也可以，源码位置：

动态壁纸参考案例1

aosp源码路径

development/samples/CubeLiveWallpaper

动态壁纸参考案例2

aosp源码路径

development/samples/MultiDisplay

第二步

拿到demo后大家记得要按照官方要求进行配置：
按照上面google官方文档说的
壁纸支持多屏显示最核心的步骤就是在如下xml中加上android:supportsMultipleDisplays="true"的属性

<?xml version="1.0" encoding="UTF-8"?>

<wallpaper
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:description="@string/wallpaper_description"
    android:supportsMultipleDisplays="true"
    />

ps：如果不设置android:supportsMultipleDisplays=“true”，那么在多屏情况下设置壁纸会如何呢？
主屏幕 显示正常自定义壁纸，副屏慕显示原生静态壁纸

发现结果就是主屏幕显示动态壁纸，但是副屏幕显示静态壁纸。

AndroidManifest.xml中声明这个Service是属于WallpaperService的

<service
    android:name=".wallpaper.SampleWallpaper"
    android:permission="android.permission.BIND_WALLPAPER"
    android:exported="true">
    <intent-filter>
        <action android:name="android.service.wallpaper.WallpaperService">
        </action>
    </intent-filter>
    <meta-data
        android:name="android.service.wallpaper"
        android:resource="@xml/wallpaper">
    </meta-data>
</service>

上面代码准备好以后既可以开始编译，安装运行验证效果了。

第三步

编译好自定义壁纸apk，然后进行adb install这个apk

mmm development/samples/MultiDisplay/

adb install -r out/target/product/emu64x/system/app/MultiDisplay/MultiDisplay.apk

第四步
桌面设置自定义壁纸操作部分：
桌面长按点击出现壁纸相关设置按钮

点击后进行选着壁纸画面，这里最好建立多安几个自定义壁纸

选择我们自己写壁纸服务进行设置成壁纸

第四步

查看设置的壁纸运行现象，运行设置动态壁纸后出现如下现象：

明显发现主屏幕正常显示自定义壁纸，但是副屏显示为黑屏。那么到底为啥黑屏呢？这部分就是留给各位学员朋友的课程作业啦。

作业要求：

1、剖析出android:supportsMultipleDisplays="true"的原理

2、根据上面作业步骤，复现出设置自定义壁纸后，主屏正常副屏黑屏现象

3、分析黑屏现象的初步原因

4、深入追踪分析出黑屏的根本原因，并考虑相关的修复方案

5、尽量修复方案不要考虑修改系统framework框架代码，可以自己自定义壁纸的app来解决

更多framework实战开发干货，请关注下面“千里马学框架”