Android启动时使用SharedPreferences报错原因分析(转载请删除括号里的内容)

左手的ㄟ右手 2024-03-23 11:09 27阅读 0赞

## 现象描述 ##

最近做TV开发，Android 9.0，Launcher应用刚启动时调用SharedPreferences，会出现黑屏或闪屏现象。log报错如下：

> AndroidRuntime: java.lang.RuntimeException: Unable to create application cn.com.shine.homehptv.HomeHptvApplication: java.lang.IllegalStateException: SharedPreferences in credential encrypted storage are not available until after user is unlocked

原因：当设备已开机但用户尚未解锁设备时，Android 7.0 后将在安全的“直接启动”模式下运行，开机阶段读写设备将受影响。

“直接启动”相关内容详见官方文档：[支持“直接启动”模式][Link 1]

## 解决方案 ##

方案一：如果是系统应用（在/system/app或其他系统路径下的应用，不需要系统签名，本人亲测），在AndroidManifest.xml中加上以下代码即可：

<application
        android:directBootAware="true"
        android:defaultToDeviceProtectedStorage="true">
        ...

详见官方文档：[文件级加密][Link 2]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1d2Vpa2FpMDYxNw_size_16_color_FFFFFF_t_70][]

方案二：如果不是系统应用，上述的 android:defaultToDeviceProtectedStorage="true" 属性不会生效。此时除了加入 android:directBootAware="true" 之外，还需要修改SharedPreferences的调用环境，使其指向未解锁状态可以访问的设备区域。代码如下

Context directBootContext = appContext.createDeviceProtectedStorageContext();
            // Access appDataFilename that lives in device encrypted storage
            SharedPreferences pref = directBootContext.getSharedPreferences(appDataFilename);
            // Use inStream to read content...

详见官方文档：[支持“直接启动”模式][Link 3]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1d2Vpa2FpMDYxNw_size_16_color_FFFFFF_t_70 1][]

##  ##

[Link 1]: https://developer.android.com/training/articles/direct-boot
[Link 2]: https://source.android.google.cn/security/encryption/file-based#supporting-direct-boot-in-system-applications
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1d2Vpa2FpMDYxNw_size_16_color_FFFFFF_t_70]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/23/62504a4ae8a94733b48db41f5309c1a7.png
[Link 3]: https://developer.android.com/training/articles/direct-boot?hl=zh-cn
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d1d2Vpa2FpMDYxNw_size_16_color_FFFFFF_t_70 1]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/23/f4c54e88db264e7c8fbb78384eb9de67.png