安卓开发API28及以下版本设置URL图片为锁屏壁纸不生效问题

修复方案 #

问题根因 #

• API 28及以下版本的WallpaperManager对FLAG_LOCK | FLAG_SYSTEM组合参数的兼容性不足，部分原生系统和厂商ROM不支持同时设置两类壁纸
• 输入流InputStream是一次性消耗资源，调用setStream时读取完全部内容后流位置会移动到末尾，系统处理锁屏壁纸设置时无法再读取到有效图片数据，导致设置失败
• 你当前使用StrictMode放行主线程网络操作属于不合规实现，虽然不是直接导致设置失败的原因，但存在ANR风险

修正实现 #

首先在AndroidManifest.xml中配置必要权限：

<!-- 网络请求权限 -->
<uses-permission android:name="android.permission.INTERNET" />
<!-- 壁纸设置权限 -->
<uses-permission android:name="android.permission.SET_WALLPAPER" />

业务代码调整如下：

// 放到子线程处理网络和壁纸设置逻辑，禁止在主线程做网络请求
thread {
    var inputStream: InputStream? = null
    var wallpaperBitmap: Bitmap? = null
    try {
        // 先把网络图片加载为Bitmap缓存，避免流消耗问题
        inputStream = URL(intent).openStream()
        wallpaperBitmap = BitmapFactory.decodeStream(inputStream)
        val wallpaperManager = WallpaperManager.getInstance(applicationContext)

        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
            // 分开设置桌面和锁屏壁纸，适配低版本兼容性
            wallpaperManager.setBitmap(
                wallpaperBitmap, null, true,
                WallpaperManager.FLAG_SYSTEM
            )
            wallpaperManager.setBitmap(
                wallpaperBitmap, null, true,
                WallpaperManager.FLAG_LOCK
            )
            // 切回主线程弹窗提示
            runOnUiThread {
                Toast.makeText(this, "壁纸设置成功！", Toast.LENGTH_SHORT).show()
            }
        }
    } catch (e: Exception) {
        e.printStackTrace()
        runOnUiThread {
            Toast.makeText(this, "设置失败：${e.localizedMessage}", Toast.LENGTH_SHORT).show()
        }
    } finally {
        // 回收资源
        inputStream?.close()
        wallpaperBitmap?.recycle()
    }
}

额外注意事项 #

• 建议用协程、OkHttp等成熟方案实现异步网络请求，不要用StrictMode放行主线程网络
• 超大体积图片建议先压缩再设置，避免系统壁纸服务处理异常
• 小米、华为等国产ROM对锁屏壁纸设置有额外权限限制，若仍设置失败可引导用户手动授予应用锁屏壁纸设置权限

内容的提问来源于stack exchange，提问作者Muaz Khan