如何解决新API在旧版本系统中导致的崩溃问题？

Question

系统API版本兼容问题
现象：新API在旧版本系统崩溃

在代码中做版本检测，配置兼容处理：

// 使用API能力检测
if(canIUse(APIAbility.WINDOW_MANAGER)) {
  useNewFeature();
} else {
  fallbackToLegacy();
}

// 配置兼容模式
"compatibleVersion": 5,
"targetVersion": 9

还是会出现偶发性系统崩溃，应该怎么更好的处理

Answer 1

// 配置对象（通常从外部配置文件加载）
const compatibilityConfig = {
  compatibleVersion: 5,        // 最低支持版本
  targetVersion: 9,            // 目标版本
  blacklistVersions: [6.1],    // 已知问题版本
  featureFlags: {              // 特性开关，便于上线后动态调整
    enableNewWindowManager: true
  }
};

// 日志工具（模拟大公司中的日志系统）
const logger = {
  info: (msg) => console.log(`[INFO] ${msg}`),
  error: (msg, error) => console.error(`[ERROR] ${msg}`, error),
};

// 系统信息获取（抽象为独立模块）
class SystemInfo {
  static getVersion() {
    // 实际环境中从平台API获取，例如：return platform.getSystemVersion();
    return 7.0; // 占位实现
  }
}

// API兼容性检查工具
class CompatibilityChecker {
  constructor(config) {
    this.config = config;
    this.currentVersion = SystemInfo.getVersion();
    this.isNewFeatureDisabled = localStorage.getItem('disableNewWindowManager') === 'true';
  }

  // 检查版本是否支持
  isVersionSupported() {
    const { compatibleVersion, targetVersion, blacklistVersions } = this.config;
    return this.currentVersion >= compatibleVersion &&
           this.currentVersion <= targetVersion &&
           !blacklistVersions.includes(this.currentVersion);
  }

  // 检查新API是否可用
  isNewFeatureSafe() {
    if (!this.config.featureFlags.enableNewWindowManager || this.isNewFeatureDisabled) {
      return false;
    }
    if (!this.isVersionSupported()) {
      logger.info(`System version ${this.currentVersion} not supported`);
      return false;
    }
    if (!canIUse(APIAbility.WINDOW_MANAGER)) {
      logger.info('WINDOW_MANAGER API not available');
      return false;
    }
    return true;
  }

  // 禁用新特性（动态降级）
  disableNewFeature() {
    this.isNewFeatureDisabled = true;
    localStorage.setItem('disableNewWindowManager', 'true');
    logger.info('New Window Manager feature disabled due to failure');
  }
}

// Window Manager 服务层
class WindowManagerService {
  constructor(compatibilityChecker) {
    this.compatibilityChecker = compatibilityChecker;
  }

  // 使用新API
  useNewFeature() {
    try {
      windowManager.newMethod(); // 新API调用
      logger.info('New Window Manager executed successfully');
    } catch (error) {
      logger.error('New Window Manager failed', error);
      this.compatibilityChecker.disableNewFeature();
      this.fallbackToLegacy();
    }
  }

  // 回退到旧逻辑
  fallbackToLegacy() {
    try {
      legacyWindowManager.oldMethod(); // 旧API调用
      logger.info('Fallback to legacy Window Manager succeeded');
    } catch (error) {
      logger.error('Legacy Window Manager failed', error);
      // 可选：抛出异常或进入错误处理流程
    }
  }

  // 主执行逻辑
  execute() {
    if (this.compatibilityChecker.isNewFeatureSafe()) {
      this.useNewFeature();
    } else {
      this.fallbackToLegacy();
    }
  }
}

// 初始化并运行
const checker = new CompatibilityChecker(compatibilityConfig);
const windowManagerService = new WindowManagerService(checker);
windowManagerService.execute();

// 模拟API能力检测（需替换为真实实现）
function canIUse(api) {
  // 示例实现，实际应调用平台API
  return typeof windowManager !== 'undefined' && SystemInfo.getVersion() >= 7;
}

// 模拟API（仅用于验证）
const windowManager = {
  newMethod: () => {
    if (Math.random() < 0.2) throw new Error('Random API crash');
    return 'New API success';
  }
};
const legacyWindowManager = {
  oldMethod: () => 'Legacy API success'
};