Android14 系统Wallpaper详解 壁纸显示说明

壁纸主要分为两类，锁屏壁纸和桌面壁纸

一、壁纸服务的启动

壁纸服务WallpaperManagerService中，有一个内部类LifeCycle继承自SystemService，SystemServer在启动系统服务的时候，会创建LifeCycle对象并进行创建的相关逻辑，LifeCycle在onStart方法中会发布Service（publishBinderService(Context.WALLPAPER_SERVICE, mService)），然后WallpaperManagerService就可以作为系统服务供其它模块调用了。

二、桌面壁纸

1、壁纸显示

在系统服务启动到一定阶段的时候，会进行壁纸的显示，WallpaperManagerService会在系统启动到SystemService.PHASE_THIRD_PARTY_APPS_CAN_START的时候去启动切换User的逻辑（switchUser），里面会进行壁纸的显示和用户的切换，开机时用户的默认值为UserHandle.Null，然后切换为UserHandle.USER_SYSTEM，并显示对应的壁纸，单用户的话默认显示的壁纸为/data/system/users/0/wallpaper。

桌面壁纸是在systemui进程中现实的，通过dumpsys window windows可以看出来：

2、壁纸切换

1. 壁纸的切换首先需要权限android.permission.SET_WALLPAPER并且是system用户。
2. 应用首先获取WallpaperManager（WMS的远程代理），然后进行设置（setBitmap，setStream）等，然后再调用远程接口的时候，会通过返回文件句柄（ParcelFileDescriptor），ParcelFileDescriptor是WMS通过userId获取的，一般的地址为/data/system/users/$user/wallpaper。然后应用通过句柄取写需要设置的壁纸的资源内容。

   WallpaperManager wallpaperManager = WallpaperManager.getInstance(this);  
   Resources res = getResources();  
   Bitmap bitmap=BitmapFactory.decodeResource(res, getResources().getIdentifier("wallpaper" + imagePosition, "drawable", "com.ch"));   
   wallpaperManager.setBitmap(bitmap);  
   Toast.makeText(this, "设置成功", Toast.LENGTH_SHORT).show();
   

3. WMS会在第一调用switchUser的时候，监听对应的壁纸文件的变化（WallpaperObserver），当用户进程写完之后，会毁掉CLOSE_WRITE,然后启动更换壁纸的逻辑。
4. 如果当前的壁纸是桌面壁纸，WMS会去绑定桌面壁纸服务（通过配置文件配置）ImageWallpaper（继承自WallpaperService），然后调用切换壁纸的逻辑。
5. ImageWallpaper在启动的过程中，会获取WindowManagerService的远程对象，在UpdateSurface中通过（addToDisplay，relayout来添加个更新）。WallpaperService会创建BaseSurfaceHolder（里面包含Surface对象），最终通过Surface去获取Canvas,然后把壁纸画到canvas，SurfaceFlinger就会把壁纸更新到界面上。
6. 壁纸的显示位置是通过壁纸添加的view的flag（WindowManager.LayoutParams.PRIVATE_FLAG_WANTS_OFFSET_NOTIFICATIONS）来确定是显示在launcher的背面（壁纸在所有逻辑图层的最下层）。

三、锁屏壁纸

1、壁纸显示

锁频壁纸是systemui进程显示的，通过dumpsys window windows可以看出：

2、启动并注册壁纸的监听

系统在启动SystemUI的时候，会创建StatusBar并显示，StatusBar在创建视图的方法makeStatusBarView中，会根据ENABLE_LOCKSCREEN_WALLPAPER状态判断是否支持锁屏壁纸而创建LockScreenWallpaper对象，LockScreenWallpaper的构造函数中获取Wallpaper的远程服务的代理对象WallpaperManager，然后调用service.setLockWallpaperCallback(this),设置壁纸变化的监听，如果WallpaperManagerService中有壁纸的变化，通过aidl通知LockScreenWallpaper，然后去LoadBitmap，然后通知StatusBar更新锁屏壁纸的图片。

四、静态壁纸

1、说明

静态壁纸设置的原理是在WallpaperManagerService里监听/data/system/users/0/wallpaper_orig相关文件的变化来触发设置，通过相应的组件程序去进行绘制。

相应的组件如：

mWallpaperComponent=ComponentInfo{com.android.systemui/com.android.systemui.wallpapers.ImageWallpaper}

Wallpaper connection com.android.server.wallpaper.WallpaperManagerService$WallpaperConnection@739a4fa:

设置壁纸不需要动态申请权限，但如果你从相册选择图片，则需要处理运行时权限（如 READ_EXTERNAL_STORAGE）。

2、壁纸设置

设置壁纸方法：

private void setWallpaper() {
        // 获取 WallpaperManager 实例
        WallpaperManager wallpaperManager = WallpaperManager.getInstance(getApplicationContext());

        try {
            // 加载图片资源
            Bitmap wallpaperBitmap = BitmapFactory.decodeResource(getResources(), R.drawable.wallpaper_image);

            // 设置壁纸
            wallpaperManager.setBitmap(wallpaperBitmap);

            // 提示用户成功设置壁纸
            Toast.makeText(MainActivity.this, "壁纸设置成功！", Toast.LENGTH_SHORT).show();
        } catch (IOException e) {
            // 捕获异常并提示用户失败
            Toast.makeText(MainActivity.this, "壁纸设置失败！", Toast.LENGTH_SHORT).show();
            e.printStackTrace();
        }
    }
}

同时设置主屏幕和锁屏壁纸，可以使用以下代码：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
    // 设置主屏幕壁纸
    wallpaperManager.setBitmap(wallpaperBitmap, null, true, WallpaperManager.FLAG_SYSTEM);