变更概述

本 PR 对鸿蒙化三方库 react-native-switch-pro 质量加固问题修复与工程完善：

• 修复外部 value 属性变更时，鸿蒙版无动画直接切换到新值（瞬时跳变）
• 修复 onAsyncPress 失败时会先切换 UI 再回滚，产生"闪烁"效果
• 新增 Example demo 示例工程（含 HarmonyOS harmony 目录及 testerino 演示页面）
• 更新 README 文件为新模板，并新增英文版 README（README_en.md）

一、三方库源码修改点（重点）

1. 修复外部 value 属性变更时无动画直接切换

根因：componentWillReceiveProps 中检测到外部 value 变更时调用 syncSwitchToValue，该函数直接通过 switchAnimation.setValue() 将动画值瞬间设到目标位置（±offset），不经过 Animated.timing，因此开关状态被外部改变时 UI 无动画直接跳变到新值。

修改前——syncSwitchToValue 直接 setValue，无动画过渡：

if (typeof nextProps.value !== 'undefined' && nextProps.value !== this.props.value) {
  this.syncSwitchToValue(nextProps.value)
}

修改后——外部变更与用户点击收敛到同一条切换动画路径 toggleSwitchToValue，从当前位置 200ms 平滑动画到目标位：

if (typeof nextProps.value !== 'undefined' && nextProps.value !== this.props.value) {
  this.toggleSwitchToValue(true, nextProps.value)
}

toggleSwitchToValue 先复位圆点缩放（animateHandler），再由 animateSwitch 以 Animated.timing 从当前位置动画到目标位，动画真正完成后才 setState 更新内部 value，全程无 setValue 瞬移。配套调整：

• 删除 syncSwitchToValue（直接 setValue 瞬移）与中间实现 executeToggleToValue（先 setValue 瞬移到反侧起点再动画，自身会产生一次可见跳动），切换动画统一收敛到 animateSwitch / animateHandler，动画结构对齐上游 1.0.5
• switchAnimation 初始值由 value ? this.offset : -this.offset 调整为 value ? -1 : 1，对齐 render 插值区间端点，切换动画从边界起全程可见
• 调用处保留上游扩展注释：程序化改值前可先放大圆点（animateHandler(this.handlerSize * SCALE)）再延时切换，按需启用

example 验证：Example/src/switch-pro/index.tsx「外部修改value：通过按钮改变value prop，应有200ms动画过渡（非瞬时跳变）」用例。

2. 修复 onAsyncPress 失败时先切换 UI 再回滚产生的"闪烁"

根因：异步模式下点击开关时先乐观执行 executeToggleToValue(targetValue) 立即切换 UI；业务侧回调 result === false 时再执行 executeToggleToValue(value) 切回原状态。两次 200ms 动画来回切换，视觉上产生"闪烁"。且调用方无法实现"等待业务确认后再切换"的等待模式。

修改前——乐观切换 + 失败回滚，两次动画闪烁：

} else if (onAsyncPress) {
  this.executeToggleToValue(targetValue)
  onAsyncPress((result) => {
    if (!result) {
      this.executeToggleToValue(value)
    }
  })
}

修改后——将 toggleSwitch 传入回调，由调用方通过 callback(true/false) 决定是否切换：

} else if (onAsyncPress) {
          const targetValue = result ? !value : this.state.value
          if (targetValue === this.state.value){
            callback(targetValue)
            return
          }
          this.toggleSwitchToValue(result, !value, () => callback(targetValue))
}

• callback(true)：执行一次切换动画（executeToggleToValue）
• callback(false)：仅复位圆点缩放（animateHandler），开关保持原位，不产生回滚
• 默认 onAsyncPress = (callback) => {callback(true)}，未传回调时行为与同步切换一致，无兼容性影响

example 验证：Example/src/switch-pro/index.tsx「onAsyncPress成功：点击后开关不动，1s后callback(true)才动画切换（等待模式）」「onAsyncPress失败：callback(false)后开关保持不动，不出现回滚闪烁」两个用例。

二、example 测试用例

重构 Example 工程：删除旧版 android/ios 示例，新增基于 RNOH 的 harmony 工程与 testerino 演示页面（Example/src/switch-pro/index.tsx），共 10 个用例：

三、文档修改

• CHANGELOG.md：新增 v1.1.1-beta.1 版本记录
• README.md：更新为新版文档模板（含简介、下载安装、Link 说明、接口文档）
• 新增 README_en.md 英文版文档
• 版本号 1.1.0 -> 1.1.1-beta.1（涉及 package.json / CHANGELOG.md）

四、自测说明

• 基础切换：点击后 200ms 平滑动画，无回闪
• onSyncPress：回调参数为切换后的新值
• onAsyncPress 成功：点击后开关保持原位，1s 后 callback(true) 才动画切换
• onAsyncPress 失败：callback(false) 后开关保持原位，无回滚闪烁
• 外部修改 value：按钮改变 value prop，有 200ms 动画过渡（非瞬时跳变）
• width/height、圆点颜色、背景颜色、circleStyle、disabled 等样式属性均正常

资料修改

• 是否已在 README 说明该接口/功能的变化：是（README 更新为新模板，新增英文版 README_en.md）
• 是否已在 README 和 package.json 修改了版本信息：是（版本号 1.1.0 -> 1.1.1-beta.1）

Checklist

• Issue 包含：问题描述、复现步骤、预期结果、实际结果、环境信息
• 根因分析和方案说明已补全（见"一、三方库源码修改点"每项的根因 + 修改前/修改后对比及 example 验证）
• 修复代码与测试用例同步提交（lib/index.js + Example/src/switch-pro/index.tsx）
• 已列出触发的用例及运行结果（见"四、自测说明"）
• 已通过 AI 扫描评审
• 所有测试用例通过（人工验证：基础切换 / onSyncPress / onAsyncPress 成功与失败 / 外部修改 value / 样式属性均通过）
• 兼容性影响和依赖关系影响已完成分析（本次修改对外 API 无破坏性变更：onAsyncPress 回调签名与社区版 1.0.5 保持一致，默认行为不变；纯 JS 实现，不涉及依赖关系变化）