LitMotion Unity 动画库安装教程:5 分钟从零到可用
【免费下载链接】LitMotionLightning-fast and Zero Allocation Tween Library for Unity.项目地址: https://gitcode.com/gh_mirrors/li/LitMotion
LitMotion(包名com.annulusgames.lit-motion)是一款面向 Unity 的高性能动画库,主打零 GC 分配与 Burst 加速,把 Tween 运算成本压到几乎为零。本文只讲一件事:怎么把它装进项目、跑起来,以及装不上时从哪里查起。
依赖版本速查
| 依赖 | 最低版本 | 说明 |
|---|---|---|
| Unity | 2021.3+ | 工程编辑器版本 |
com.unity.burst | 1.6.0+ | 编译加速,性能收益的主要来源 |
com.unity.collections | 1.5.1+ | 托管端动画曲线的原生容器 |
com.unity.mathematics | 1.0.0+ | 数学运算基础 |
📌 用包管理器导入时依赖会被自动补齐,无需逐一安装;手动编辑manifest.json时需要自己保证上述版本达标。
Git URL 导入 Package Manager
主路径只有一条:Package Manager 导入,unitypackage 是兜底方案,按条件走即可。
- 顶部菜单
Window→Package Manager。 - 点左上角
+→Add package from git URL。 - 粘贴包地址(注意末尾的
?path=参数,缺了它导入的是整个仓库而不是包目录):
https://gitcode.com/gh_mirrors/li/LitMotion.git?path=src/LitMotion/Assets/LitMotion
如果 Git 源不可用,两条退路:
- 直接编辑工程里的
Packages/manifest.json,在dependencies中加入"com.annulusgames.lit-motion": "https://gitcode.com/gh_mirrors/li/LitMotion.git?path=src/LitMotion/Assets/LitMotion",保存后等待 Unity 自动解析安装。 - 或从项目 Releases 页下载
.unitypackage文件,双击导入并在对话框中全选后确认。
想要可视化编辑动画,可在同方式再导入com.annulusgames.lit-motion.animation(LitMotion.Animation),它依赖核心包,必须放在核心包安装完成之后。
打开 Debugger 窗口验证安装
安装是否成功,看一个最小动作:菜单栏是否出现Window→LitMotion Debugger。打开它,能看到运行中 Motion 的实时状态面板,说明包已完整加载。
想看实际运行效果,打开示例工程samples/LitMotion.Samples,进入Assets/Samples/0. Basic/1. Create & Bind/场景,Sample_0_CreateAndBind里的Transform会立刻开始位移,即代表整条链路(调度器 → Motion → 绑定)工作正常。
编译报错三步排查
不用逐条对照 Q&A,按「症状 → 原因 → 解法」直接查:
| 症状 | 原因 | 解法 |
|---|---|---|
| 大量编译错误 | Burst / Collections / Mathematics 版本低于要求 | 在 Package Manager 里把三个依赖升到表格中的最低版本 |
| 包装上了,但菜单栏没有 LitMotion 菜单 | git URL 的path参数写错,包目录没解析到位 | 核对 URL 以?path=src/LitMotion/Assets/LitMotion结尾,重新添加 |
| 升级后行为异常 | 旧版本残留资产与新版冲突 | 删除旧包资产后重新导入;unitypackage 用户需先移除再导入新版本 |
装好之后的学习入口:docs/articles/en/下的官方文档,从 Quick Start(LMotion.Create()+ Bind)读起,再按需看 Sequence、绑定扩展等章节。
【免费下载链接】LitMotionLightning-fast and Zero Allocation Tween Library for Unity.项目地址: https://gitcode.com/gh_mirrors/li/LitMotion
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考