HarmonyOS鸿蒙Next中如何解决首选项数据持久化调用报错

【问题现象】

首选项数据持久化调用getPreferencesSync报错，报错信息为：code:15500000 message:Inner error. Error code 15500000。

问题代码如下：

import dataPreferences from '@ohos.data.preferences';

let preferences: dataPreferences.Preferences | null = null;
export default class EntryAbility extends UIAbility {
  onWindowStageCreate(windowStage: window.WindowStage) {
    try {
       let options: dataPreferences.Options = {
         name: 'myStore'
       };
       preferences = dataPreferences.getPreferencesSync(this.context, options);
     } catch (e) {
       Logger.info(e)
     }
  }
}

【定位思路】

错误码15500000，用户首选项内部发生错误，通常是getPreferences传入的context有问题。

• 排查传入的context是否为undefined；
• 排查是否为Stage模型；
• 排查this使用是否正确。

【解决方案】

如果是直接在调用首选项处调用getContext()获取context，建议修改成在entryability里获取全局的context，再在调用首选项处使用全局的context替代getContext()。

示例代码如下：

// 全局 GlobalContext
import type common from '@ohos.app.ability.common';

 export class GlobalContext {
   private static context: common.UIAbilityContext;

   public static initContext(context: common.UIAbilityContext): void {
     GlobalContext.context = context;
   }

   public static getContext(): common.UIAbilityContext {
     return GlobalContext.context;
   }
 }

 // EntryAbility.ets
 onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');
    //初始化全局Context
    GlobalContext.initContext(this.context);
  }

 onWindowStageCreate(windowStage: window.WindowStage): void {
     hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onWindowStageCreate');

     let options: preferences.Options = {
       name: 'myStore'
     };
     //在调用preferences处使用获取的全局Context替代getContext()
     //let p = preferences.getPreferencesSync(getContext(), options);
     let p = preferences.getPreferencesSync(this.context, options);
     p.putSync("name", "txy");
     let a = p.getSync("name", "txy1")
     console.info("xxx" + a.toString())
     windowStage.loadContent('pages/Index', (err) => {
       if (err.code) {
         hilog.error(0x0000, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err) ?? '');
         return;
       }
       hilog.info(0x0000, 'testTag', 'Succeeded in loading the content.');
     });
   }

参考Stage模型示例检查调用方法是否正确。

ArkUI语言特性要求ArkTS不支持在函数和类的静态方法中使用this，只能在类的实例方法中使用this，函数内使用this参考相关文档。

示例代码如下：

class Test {
   value: string = ''
   constructor (value: string) {
     this.value = value
   }

   foo() {
     console.log(this.value);
   }
 }

 let obj: Test = new Test('abc');
 obj.foo();

【总结】

在使用首选项时需要注意方法调用时传入的context是否一致，建议获取一个全局的context，在调用方法时使用。在关系型数据库RdbStore也需要注意此问题。