Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

7.4 KB
Raw Blame
// 整包更新发现 —— 纯逻辑(无 IO / 无 React,便于单测)。
//
// 背景:
// - expo-updates 只感知"我这个 runtimeVersion 有没有新 JS OTA",不会告知"有更高 runtimeVersion 的整包"。
// - 所以整包发现靠独立的 `/latest` 通道,先确认服务端 version 高于当前原生版本:
//     · 服务端版本不高于当前版本 → 不提示整包,不影响独立的 JS OTA 通道;
//     · 版本更高时比对 runtimeVersion:相同交给 JS OTA,不同则引导打开正常安装入口。
// - minVersion(可选)用于强制更新:当前 version 低于它则阻断使用、只留"去更新"。
//   强更判定**不经过 runtimeVersion 门闸**:门槛由服务端按 version 下发,同 runtimeVersion
//   的旧构建也必须能被强更(否则"发布链写了 minVersion 却对同指纹装机无效")。

/** mobile-update-server `/latest` 返回的整包版本记录(release.json 透传)。 */
export interface LatestReleaseRecord {
  version: string;
  buildNumber: string | number;
  runtimeVersion: string;
  installUrl: string;
  itmsUrl: string;
  releaseNotes?: string;
  /** 可选:低于此 version 强制更新。首期默认不下发。 */
  minVersion?: string;
}

export interface BundleUpdateEvaluation {
  /** 是否有整包更新(服务端版本更高,且 runtimeVersion 不同或命中强更)。 */
  needsUpdate: boolean;
  /** 是否强制(needsUpdate 且当前 version < minVersion)。 */
  forced: boolean;
  /** 供 UI 使用的目标信息;needsUpdate=false 时为 null。 */
  target: {
    version: string;
    runtimeVersion: string;
    installUrl: string;
    itmsUrl: string;
    releaseNotes?: string;
  } | null;
}

export interface EvaluateBundleUpdateInput {
  /** 当前运行包的 runtimeVersion(取自 expo-updates Updates.runtimeVersion)。 */
  currentRuntimeVersion: string | null | undefined;
  /** 当前包的应用版本(原生真值 APP_BINARY_VERSION;不要传会被 OTA 覆盖的 expoConfig.version)。 */
  currentVersion: string | null | undefined;
  /** `/latest` 返回体(已解析)。无效/缺字段视为无更新。 */
  latest: unknown;
}

const NO_UPDATE: BundleUpdateEvaluation = { needsUpdate: false, forced: false, target: null };

/**
 * 官网整包记录只属于自建安装渠道。Google Play 安装由 Play 管理原生包更新;
 * 两种 Android 产物共用自建 OTA 配置,不能只用 isSelfHosted 区分。
 * Review 构建与 TestFlight 构建都不能展示外部安装入口;
 * TestFlight 的 JS OTA 由独立通道继续处理。
 */
export function shouldCheckBundleUpdate({
  isSelfHosted,
  isReviewMode,
  isTestFlightBuild,
  isGooglePlayInstallation,
}: {
  isSelfHosted: boolean;
  isReviewMode: boolean;
  isTestFlightBuild: boolean;
  isGooglePlayInstallation: boolean;
}): boolean {
  return isSelfHosted && !isReviewMode && !isTestFlightBuild && !isGooglePlayInstallation;
}

export function isSupportedBundleVersion(version: string): boolean {
  return /^\d+(?:\.\d+)*$/.test(version)
    && version.split('.').every((part) => Number.isSafeInteger(Number(part)));
}

/** 校验 `/latest` 响应;版本仅支持点分纯数字,字段缺失或格式非法返回 null(不误导)。 */
export function parseLatestRelease(value: unknown): LatestReleaseRecord | null {
  if (!value || typeof value !== 'object') return null;
  const v = value as Record<string, unknown>;
  const runtimeVersion = typeof v.runtimeVersion === 'string' ? v.runtimeVersion.trim() : '';
  const version = typeof v.version === 'string' ? v.version.trim() : '';
  const installUrl = typeof v.installUrl === 'string' ? v.installUrl.trim() : '';
  const itmsUrl = typeof v.itmsUrl === 'string' ? v.itmsUrl.trim() : '';
  // 必须有 runtimeVersion、支持的 version 和一个可跳转的安装地址。
  if (!runtimeVersion || !isSupportedBundleVersion(version) || (!installUrl && !itmsUrl)) return null;
  const record: LatestReleaseRecord = {
    version,
    buildNumber: (typeof v.buildNumber === 'string' || typeof v.buildNumber === 'number') ? v.buildNumber : '',
    runtimeVersion,
    installUrl,
    itmsUrl,
  };
  if (typeof v.releaseNotes === 'string') record.releaseNotes = v.releaseNotes;
  if (typeof v.minVersion === 'string' && v.minVersion.trim()) {
    const minVersion = v.minVersion.trim();
    if (!isSupportedBundleVersion(minVersion)) return null;
    record.minVersion = minVersion;
  }
  return record;
}

/** 比较已校验的点分纯数字版本:a<b → -1,a==b → 0,a>b → 1,缺失段按 0 处理。 */
export function compareVersions(a: string, b: string): number {
  const pa = String(a).split('.').map((x) => Number(x));
  const pb = String(b).split('.').map((x) => Number(x));
  const len = Math.max(pa.length, pb.length);
  for (let i = 0; i < len; i += 1) {
    const av = Number.isFinite(pa[i]) ? pa[i] : 0;
    const bv = Number.isFinite(pb[i]) ? pb[i] : 0;
    if (av !== bv) return av > bv ? 1 : -1;
  }
  return 0;
}

/**
 * 判定是否需要引导整包更新。服务端 version 必须高于当前原生 version,再检查两条信号:
 * - runtimeVersion 不一致 → 有整包更新(可跳过的普通提示);
 * - 当前 version < minVersion → 强更,**与 runtimeVersion 是否一致无关**。
 *   服务端可以对某个已发布版本事后下发门槛,把同指纹的问题构建也挡住;
 *   反过来说,同 runtimeVersion 命中强更时 target.runtimeVersion 就等于当前值,
 *   消费方不得把它当作"换了指纹"的证据。
 * 拿不到当前 runtimeVersion(dev / expo-updates 未启用)、版本字段缺失或不是点分纯数字、
 * 服务端版本不高于本机、`/latest` 无效 → 视为无整包更新,不影响独立的 JS OTA 通道。
 */
export function evaluateBundleUpdate({
  currentRuntimeVersion,
  currentVersion,
  latest,
}: EvaluateBundleUpdateInput): BundleUpdateEvaluation {
  const record = parseLatestRelease(latest);
  if (!record) return NO_UPDATE;

  const current = String(currentRuntimeVersion ?? '').trim();
  if (!current) return NO_UPDATE;

  const currentAppVersion = String(currentVersion ?? '').trim();
  if (!isSupportedBundleVersion(currentAppVersion)) return NO_UPDATE;
  if (compareVersions(record.version, currentAppVersion) <= 0) return NO_UPDATE;

  // 强更要求这条记录本身**能被满足**:
  // - minVersion ≤ version:否则唯一提供的安装目标仍低于门槛,用户装完照旧被强更,
  //   阻断屏成了没有出口的死屋,只能等运维改指针。
  // 发布链侧 assertMinVersionUsable 已经保证门槛可满足,这里是客户端兜底(手工改过的 / 历史
  // 遗留的指针也不能把人关死):记录不自洽时退化成可跳过的普通更新提示。
  const forced = Boolean(
    record.minVersion &&
    compareVersions(currentAppVersion, record.minVersion) < 0 &&
    compareVersions(record.version, record.minVersion) >= 0,
  );

  if (!forced && record.runtimeVersion === current) return NO_UPDATE;

  return {
    needsUpdate: true,
    forced,
    target: {
      version: record.version,
      runtimeVersion: record.runtimeVersion,
      installUrl: record.installUrl,
      itmsUrl: record.itmsUrl,
      releaseNotes: record.releaseNotes,
    },
  };
}

/** 引导安装时优先用 itms-apps/itms-services 直达入口,缺失回退网页安装页。 */
export function preferredInstallUrl(target: { itmsUrl?: string; installUrl?: string }): string | null {
  const itms = target.itmsUrl?.trim();
  if (itms) return itms;
  const web = target.installUrl?.trim();
  return web || null;
}