轻悦时光：Flutter 桥与纯 JS 加密实战

轻悦时光（LightTime）是 Flutter 宿主，桥接层和加密环境与 Legado/源阅完全不同。这篇讲清差异与纯 JS 加密要点。

桥接层本质

text
flutterBridge = window.flutter_inappwebview.callHandler

• HTTP 走 http.Get/Post，异步——几乎全部代码是 async/await 风格，和 Legado 的同步 java.ajax 写法互不兼容。
• 无 crypto API：没有 java.createSymmetricCrypto，没有 Packages.java。所有加密（MD5/SHA/AES/DES）必须纯 JS 实现。

异步三陷阱

1. 漏 await：拿到的是 Promise/Future 而不是结果——下游 .length、字段访问全部变成 undefined。症状是「数据看起来有但全是空」。
2. 并发不保序：多个 await 顺序发不等于顺序回；需要保序就显式收集结果再按索引取。
3. 异常吞没：async 函数里的异常不会自己冒到 UI，必须 try/catch 并把错误写进诊断输出，否则失败得无声无息。

纯 JS 加密要点

1. 选久经考验的纯 JS 实现（crypto-js 风格移植），别自己手写 AES。
2. JS 位运算 32 位截断：位移/与或非超过 32 位会出错；块处理用 TypedArray，别用 number 直接拼位。
3. 长数据性能：加密函数里不要做字符串增量拼接（O(n²)），用数组累积最后一次 join。
4. 输出编码先确认：目标接口要 hex 还是 base64，两者在纯 JS 实现里是最后一步的差异，搞反了排查很久。

存储与登录面板

• 登录数据走 HTML 面板 + 面板专用存储键（如密钥备份结构），不是 source 变量——从别的平台移植时这里必须重写。
• 面板字段与存储键的映射写进字段所有权表（见《跨平台三大踩坑》坑二）。

移植建议

从 Legado/源阅移植到轻悦：只带接口契约与状态机，网络层、存储、登录面板全部按轻悦惯用法重写。判据提醒：拿到源看见 flutter_inappwebview / http.Get / await 密集 → 轻悦。