Class UpdateContext

harmony/pushy/src/main/ets/UpdateContext.ts:23–523

};

export class UpdateContext {
  private context: common.UIAbilityContext;
  private rootDir: string;
  private preferences!: preferences.Preferences;
  private static DEBUG: boolean = false;
  private static isUsingBundleUrl: boolean = false;
  private static ignoreRollback: boolean = false;
  private static cachedPackageVersion: string = '';
  private static cachedBuildTime: string = '';
  // 单例：确保 bundle provider 与 TurboModule 共用同一份 preferences 内存状态，
  // 避免 RNOH RN 实例重建后两处 UpdateContext 各自持有 preferences 缓存导致读写分裂。
  private static instance: UpdateContext | null = null;
  private static instanceCounter: number = 0;
  private readonly instanceId: string;

  public static getInstance(context: common.UIAbilityContext): UpdateContext {
    if (!UpdateContext.instance) {
      UpdateContext.instance = new UpdateContext(context);
    }
    return UpdateContext.instance;
  }

  private constructor(context: common.UIAbilityContext) {
    this.context = context;
    this.rootDir = context.filesDir + '/_update';
    this.instanceId = `uc#${++UpdateContext.instanceCounter}`;

    try {
      if (!fileIo.accessSync(this.rootDir)) {
        fileIo.mkdirSync(this.rootDir);
      }
    } catch (e) {
      console.error('Failed to create root directory:', e);
    }
    this.initPreferences();
    this.trace('ctor');
    this.syncStateWithBinaryVersion(
      this.getPackageVersion(),
      this.getBuildTime(),
    );
  }

  /**
   * 诊断日志：打印本实例 id 与关键状态，用于定位 preferences 多实例 / 状态分裂问题。
   * 通过 hilog 输出，prefix=pushy，可在 hilog 中按 "UpdateContext" 过滤。
   */
  private trace(point: string): void {
    const snap = this.getStateSnapshot();
    logger.info(
      'UpdateContext',
      `trace id=${this.instanceId} ${point}` +
        ` pkg=${snap.packageVersion} bt=${snap.buildTime}` +
        ` cv=${snap.currentVersion} lv=${snap.lastVersion}` +
        ` ft=${snap.firstTime} fto=${snap.firstTimeOk}` +
        ` rb=${snap.rolledBackVersion}` +
        ` flm=${this.readString('firstLoadMarked')}` +
        ` uuidSet=${!!this.readString('uuid')}`,
    );