React Native壁纸应用修改WallpaperManager遇FLAG_LOCK找不到错误求助

问题背景 #

开发React Native壁纸应用时，基于liuhong1happy/react-native-wallpaper-manager库扩展锁屏壁纸设置功能，修改WallpaperManager.java后编译报错。

编译错误信息 #

E:\Wallpaper\node_modules\react-native-wallpaper-manager\android\src\main\java\com\cunyutech\hollyliu\reactnative\wallpaper\WallPaperManager.java:149: error: cannot find symbol
wallpaperManager.setBitmap(mBitmap, null, true, WallpaperManager.FLAG_LOCK);
^
symbol:   variable FLAG_LOCK
location: class WallpaperManager

修改后的相关代码 #

WallpaperManager.java核心修改片段 #

// 本地资源处理逻辑
if (screen.equals("lock")) {
    wallpaperManager.setBitmap(mBitmap, null, true, WallpaperManager.FLAG_LOCK);
} else if (screen.equals("home")) {
    wallpaperManager.setBitmap(mBitmap, null, true, WallpaperManager.FLAG_SYSTEM);
} else if (screen.equals("both")) {
    wallpaperManager.setBitmap(mBitmap);
}

// getSimpleTarget方法内逻辑
if(screen.equals("lock")){
    wallpaperManager.setBitmap(bitmap, null, true, WallpaperManager.FLAG_LOCK);
} else if(screen.equals("home")){
    wallpaperManager.setBitmap(bitmap, null, true, WallpaperManager.FLAG_SYSTEM);
} else if(screen.equals("both")){
    wallpaperManager.setBitmap(bitmap);
}

index.js代码 #

import { 
    NativeModules,
    Image
} from 'react-native';

module.exports = {
    setWallpaper: (source,callback = (res)=>{}) =>{
        NativeModules.WallPaperManager.setWallpaper(Image.resolveAssetSource(source),callback);
    }
} ;

解决方案 #

1. 适配Android API版本 #

WallpaperManager.FLAG_LOCK是Android API 24（7.0）才新增的常量，若项目minSdkVersion低于24，编译器会找不到该符号。

修改android/build.gradle中的版本配置：

android {
    defaultConfig {
        minSdkVersion 24
        // 其他配置项...
    }
}

2. 兼容低版本API的处理逻辑 #

如果需要支持API 24以下设备，需添加版本判断，避免直接调用高版本API：

// 先导入Build类
import android.os.Build;

// 修改锁屏设置逻辑
if (screen.equals("lock")) {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
        wallpaperManager.setBitmap(mBitmap, null, true, WallpaperManager.FLAG_LOCK);
    } else {
        sendMessage("error", "设置锁屏壁纸需要Android 7.0及以上版本", source);
        return;
    }
} else if (screen.equals("home")) {
    wallpaperManager.setBitmap(mBitmap, null, true, WallpaperManager.FLAG_SYSTEM);
} else if (screen.equals("both")) {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) {
        wallpaperManager.setBitmap(mBitmap, null, true, WallpaperManager.FLAG_SYSTEM | WallpaperManager.FLAG_LOCK);
    } else {
        wallpaperManager.setBitmap(mBitmap);
    }
}

3. 补充权限声明 #

在AndroidManifest.xml中添加壁纸相关权限：

<uses-permission android:name="android.permission.SET_WALLPAPER" />
<uses-permission android:name="android.permission.SET_WALLPAPER_HINTS" />
<!-- Android 8.0+ 需额外权限 -->
<uses-permission android:name="android.permission.SET_WALLPAPER_COMPONENT" />

4. 更新JS层传参逻辑 #

当前index.js未传递screen参数，修改为支持指定设置目标屏幕：

import { 
    NativeModules,
    Image
} from 'react-native';

module.exports = {
    setWallpaper: (options, callback = (res)=>{}) =>{
        const { source, screen = 'home' } = options;
        const assetSource = Image.resolveAssetSource(source);
        NativeModules.WallPaperManager.setWallpaper({...assetSource, screen}, callback);
    }
} ;

调用示例：

// 设置锁屏壁纸
WallpaperManager.setWallpaper({
    source: require('./wallpaper.jpg'),
    screen: 'lock'
}, (res) => {
    console.log(res);
});

内容的提问来源于stack exchange，提问作者PRATIK SHARMA