📢 lottie_turbo v1.0.12 鸿蒙平台稳定性与质量提升

lottie_turbo v1.0.12 已发布。本次升级聚焦该库稳定性与质量提升，兼容升级，开发者无需修改现有代码即可享受本次改进。推荐所有该库用户升级至本版本。

版本概览

稳定性提升

修复 loop 值为 number 类型时取值导致的崩溃 [#116]

问题：当动画 JSON 中 loop 字段被设置为 number 类型（而非布尔值）时，lottie_config_data 在读取 loop 值时类型判断不当，导致取值异常并引发崩溃。此外，动画资源清理阶段（destroy）存在释放顺序不当的崩溃风险。

修复：修正 loop 值的类型判断逻辑，兼容 number 类型取值，避免崩溃；同时加强 lottie_render / lottie_xcomponent_node 资源清理流程的安全性，规避销毁阶段的崩溃风险。

质量提升

contentMode 支持 AdaptiveHeight / AdaptiveWidth 模式 [#99]

新增 AdaptiveHeight 与 AdaptiveWidth 两种 contentMode，前者根据动画缩放比与组件宽度自适应高度，后者根据动画缩放比与组件高度自适应宽度，提供更灵活的动画布局适配能力。

新增 Texture 渲染模式（仅 API >= 18 可用）[#122]

新增 Texture 渲染模式，利用 GPU 纹理渲染提升动画绘制性能。该模式仅适用于 API >= 18 的系统版本，低版本设备使用默认渲染路径不受影响。

兼容性说明

• 无 Breaking Changes，API 接口保持不变。
• 本次变更以缺陷修复与增量能力为主，均为非破坏性变更，现有代码无需修改。
• 从 v1.0.11 起升级至 v1.0.12 均为兼容性升级。

升级方式

• 鸿蒙原生：oh-package.json5 → "@ohos/lottie-turbo": "^1.0.12"，执行 ohpm install。

相关链接

• 文档：https://gitcode.com/CPF-ApplicationTPC/lottie_turbo/blob/master/README.md
• CHANGELOG：https://gitcode.com/CPF-ApplicationTPC/lottie_turbo/blob/master/CHANGELOG.md
• 反馈：https://gitcode.com/CPF-ApplicationTPC/lottie_turbo/issues