# WuKongAnimation **Repository Path**: wu_fuqi/WuKongAnimation ## Basic Information - **Project Name**: WuKongAnimation - **Description**: 一个优雅的android属性动画库。An elegant android property animation library. - **Primary Language**: Kotlin - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 87 - **Forks**: 17 - **Created**: 2022-07-01 - **Last Updated**: 2025-09-01 ## Categories & Tags **Categories**: android-modules **Tags**: Android动画, 安卓动画, 属性动画 ## README ``` 一个优雅的代码动画库。支持直接函数调用和链式调用。内部封装Tween来作为动画内核。 ``` #### Demo展示 ##### [Demo apk下载](https://gitee.com/wu_fuqi/WuKongAnimation/raw/master/apk/app-release.apk) 1. 国内 Demo apk 二维码 ![下载二维码](https://gitee.com/wu_fuqi/WuKongAnimation/raw/master/assets/img/QRCode_258.png) #### 本项目在github的地址 ##### [github链接请进入](https://github.com/wufuqi123/WuKongAnimation) #### 当前介绍kotlin使用方式 ##### [kotlin使用方式请进入](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README.md) [java使用方式请进入](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README_JAVA.md) #### 基础功能 1. 添加依赖 请在 build.gradle 下添加依赖。 ``` implementation 'cn.wufuqi:WuKongAnimation:1.0.5' ``` 2. 设置jdk8或更高版本 因为本sdk使用了jdk8才能使用的 Lambda 表达式，所以要在 build.gradle 下面配置jdk8或以上版本。 ``` android { .... compileOptions { sourceCompatibility JavaVersion.VERSION_1_8 targetCompatibility JavaVersion.VERSION_1_8 } } ``` 3. 初始化SDK ``` java ActionManager.init(mApplication) // 尽可能早，推荐在Application中初始化 ``` 4. runAction方式使用动画 [java使用方式请进入](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README_JAVA.md) ``` java //当前为kotlin代码 view.runAction(Action.fadeIn(time))//执行渐入动画 ``` 5. 链式动画 [java使用方式请进入](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README_JAVA.md) ``` java //当前为kotlin代码 //执行渐入动画 view.createAction() .fadeIn(time) .start() ``` 6. Tween 动画 [Tween动画请进入](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README_TWEEN.md) ``` java //当前为kotlin代码 //执行渐入动画 //当前动画不会重复使用建议调用 setExpire(true) TweenManager.builder(runView) .to(mutableMapOf("alpha" to 1)) .time(time) .setExpire(true) .start() ``` #### 动画使用 接下来介绍 <链式动画> 和 的使用方式。 ##### [Tween动画](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README_TWEEN.md)不在当前文档讲述。 #### 透明度渐变动画 #### ![fade](https://gitee.com/wu_fuqi/WuKongAnimation/raw/master/assets/gif/fade.gif) 1. 链式使用方式 [java使用方式请进入](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README_JAVA.md) ``` java //当前为kotlin代码 //执行渐入动画 view.createAction() .fadeIn(time) .start() //执行渐入动画 view.createAction() .fadeOut(time) .start() //指定透明度 view.createAction() .fadeTo(time,0f) //透明度传入 0-1 .start() ``` 停止动画 ``` java //当前为kotlin代码 view.stopAction() ``` 2. runAction使用方式 [java使用方式请进入](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README_JAVA.md) ``` java //当前为kotlin代码 //执行渐入动画 view.runAction(Action.fadeIn(time)) //执行渐出动画 view.runAction(Action.fadeOut(time)) //指定透明度 view.runAction(Action.fadeTo(time,0f))//透明度传入 0-1 ``` 停止动画 ``` java //当前为kotlin代码 view.stopAction() ``` #### 位移动画 #### ![move](https://gitee.com/wu_fuqi/WuKongAnimation/raw/master/assets/gif/move.gif) 1. 链式使用方式 [java使用方式请进入](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README_JAVA.md) ``` java //当前为kotlin代码 //位移到指定位置 view.createAction() .moveTo(time,x,y) .start() //根据当前位置，位移偏移 view.createAction() .moveBy(time,x,y) .start() ``` 停止动画 ``` java //当前为kotlin代码 view.stopAction() ``` 2. runAction使用方式 [java使用方式请进入](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README_JAVA.md) ``` java //当前为kotlin代码 //位移到指定位置 view.runAction(Action.moveTo(time,x,y)) //根据当前位置，位移偏移 view.runAction(Action.moveBy(time,x,y)) ``` 停止动画 ``` java //当前为kotlin代码 view.stopAction() ``` #### 缩放动画 #### ![move](https://gitee.com/wu_fuqi/WuKongAnimation/raw/master/assets/gif/scale.gif) 1. 链式使用方式 [java使用方式请进入](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README_JAVA.md) ``` java //当前为kotlin代码 //缩放到指定大小 view.createAction() .scaleTo(time,x,y) .start() //根据当前大小，大小偏移 view.createAction() .scaleBy(time,x,y) .start() ``` 停止动画 ``` java //当前为kotlin代码 view.stopAction() ``` 2. runAction使用方式 [java使用方式请进入](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README_JAVA.md) ``` java //当前为kotlin代码 //缩放到指定大小 view.runAction(Action.scaleTo(time,x,y)) //根据当前大小，大小偏移 view.runAction(Action.scaleBy(time,x,y)) ``` 停止动画 ``` java //当前为kotlin代码 view.stopAction() ``` #### 旋转动画 #### ![move](https://gitee.com/wu_fuqi/WuKongAnimation/raw/master/assets/gif/rotate.gif) 1. 链式使用方式 [java使用方式请进入](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README_JAVA.md) ``` java //当前为kotlin代码 //旋转到指定角度 view.createAction() .rotateTo(time,rotation) .start() //根据当前角度，角度偏移 view.createAction() .rotateBy(time,rotation) .start() ``` 停止动画 ``` java //当前为kotlin代码 view.stopAction() ``` 2. runAction使用方式 [java使用方式请进入](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README_JAVA.md) ``` java //当前为kotlin代码 //旋转到指定角度 view.runAction(Action.rotateTo(time,rotation)) //根据当前角度，角度偏移 view.runAction(Action.rotateBy(time,rotation)) ``` 停止动画 ``` java //当前为kotlin代码 view.stopAction() ``` #### 旋转X坐标动画 #### ![move](https://gitee.com/wu_fuqi/WuKongAnimation/raw/master/assets/gif/rotateX.gif) 1. 链式使用方式 [java使用方式请进入](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README_JAVA.md) ``` java //当前为kotlin代码 //旋转到指定角度 view.createAction() .rotateXTo(time,rotateX) .start() //根据当前角度，角度偏移 view.createAction() .rotateXBy(time,rotateX) .start() ``` 停止动画 ``` java //当前为kotlin代码 view.stopAction() ``` 2. runAction使用方式 [java使用方式请进入](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README_JAVA.md) ``` java //当前为kotlin代码 //旋转到指定角度 view.runAction(Action.rotateXTo(time,rotateX)) //根据当前角度，角度偏移 view.runAction(Action.rotateXBy(time,rotateX)) ``` 停止动画 ``` java //当前为kotlin代码 view.stopAction() ``` #### 旋转Y坐标动画 #### ![move](https://gitee.com/wu_fuqi/WuKongAnimation/raw/master/assets/gif/rotateY.gif) 1. 链式使用方式 [java使用方式请进入](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README_JAVA.md) ``` java //当前为kotlin代码 //旋转到指定角度 view.createAction() .rotateYTo(time,rotateY) .start() //根据当前角度，角度偏移 view.createAction() .rotateYBy(time,rotateY) .start() ``` 停止动画 ``` java //当前为kotlin代码 view.stopAction() ``` 2. runAction使用方式 [java使用方式请进入](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README_JAVA.md) ``` java //当前为kotlin代码 //旋转到指定角度 view.runAction(Action.rotateYTo(time,rotateY)) //根据当前角度，角度偏移 view.runAction(Action.rotateYBy(time,rotateY)) ``` 停止动画 ``` java //当前为kotlin代码 view.stopAction() ``` #### 顺序动画 #### ![move](https://gitee.com/wu_fuqi/WuKongAnimation/raw/master/assets/gif/sequence.gif) 1. 链式使用方式 [java使用方式请进入](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README_JAVA.md) ``` java //当前为kotlin代码 //透明度渐入后渐出 view.createSequenceAction() .fadeIn(time) .fadeOut(time) .start() ``` 停止动画 ``` java //当前为kotlin代码 view.stopAction() ``` 2. runAction使用方式 [java使用方式请进入](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README_JAVA.md) ``` java //当前为kotlin代码 //透明度渐入后渐出 runView.runAction(Action.sequence(Action.fadeIn(time), Action.fadeOut(time))) ``` 停止动画 ``` java //当前为kotlin代码 view.stopAction() ``` #### 同步动画 #### ![move](https://gitee.com/wu_fuqi/WuKongAnimation/raw/master/assets/gif/spawn.gif) 1. 链式使用方式 [java使用方式请进入](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README_JAVA.md) ``` java //当前为kotlin代码 //同时执行位移和旋转动画 view.createSpawnAction() .moveBy(time, x, y) .rotateBy(time, rotation) .start() ``` 停止动画 ``` java //当前为kotlin代码 view.stopAction() ``` 2. runAction使用方式 [java使用方式请进入](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README_JAVA.md) ``` java //当前为kotlin代码 //同时执行位移和旋转动画 runView.runAction( Action.spawn( Action.moveBy(time, x, y), Action.rotateBy(time, rotation) ) ) ``` 停止动画 [java使用方式请进入](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README_JAVA.md) ``` java //当前为kotlin代码 view.stopAction() ``` #### 使用回调 1. 链式使用方式 [java使用方式请进入](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README_JAVA.md) ``` java //当前为kotlin代码 //渐入后 执行打印 view.createSequenceAction() .fadeIn(time) .callFunc { Log.i(this::class.java.name, "fadeIn 执行完成") } .start() ``` 停止动画 ``` java //当前为kotlin代码 view.stopAction() ``` 2. runAction使用方式 [java使用方式请进入](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README_JAVA.md) ``` java //当前为kotlin代码 //渐入后 执行打印 runView.runAction(Action.sequence(Action.fadeIn(time), Action.callFunc { Log.i(this::class.java.name, "fadeIn 执行完成") })) ``` 停止动画 ``` java //当前为kotlin代码 view.stopAction() ``` #### wait调用 1. 链式使用方式 [java使用方式请进入](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README_JAVA.md) ``` java //当前为kotlin代码 //等待1秒后执行渐入 view.createSequenceAction() .wait(1000) .fadeIn(time) .start() ``` 停止动画 ``` java //当前为kotlin代码 view.stopAction() ``` 2. runAction使用方式 [java使用方式请进入](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README_JAVA.md) ``` java //当前为kotlin代码 //等待1秒后执行渐入 runView.runAction(Action.sequence(Action.wait(1000),Action.fadeIn(time))) ``` 停止动画 ``` java //当前为kotlin代码 view.stopAction() ``` #### 使用缓动函数 缓动函数计算引用 [tween.js](http://tweenjs.github.io/tween.js/) 的缓动函数。 [缓动效果](http://tweenjs.github.io/tween.js/examples/03_graphs.html) 默认的缓动函数为 Easing.linear() 1. 链式使用方式 [java使用方式请进入](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README_JAVA.md) ``` java //当前为kotlin代码 view.createSequenceAction() .fadeIn(time,Easing.linear()) //使用线性缓动函数 .start() ``` 2. runAction使用方式 [java使用方式请进入](https://gitee.com/wu_fuqi/WuKongAnimation/blob/master/README_JAVA.md) ``` java //当前为kotlin代码 runView.runAction(Action.fadeIn(time,Easing.linear())) //使用线性缓动函数 ``` #### 设置全局速度 设置全部动画的速度为1倍 ``` java //设置全部动画的速度为1倍 TweenManager.speed = 1.0 ``` #### 设置全局暂停动画 设置动画全局暂停 ``` java //设置动画全局暂停 TweenManager.pause() ``` #### 设置全局恢复动画 设置动画全局恢复 ``` java //设置动画全局恢复 TweenManager.pause() ``` #### 检测动画是否正在运行 tween检测是否运行 ``` java //kotlin 写法 tween.isRunning //java写法 tween.isRunning() ``` action检测是否运行 ``` java //kotlin 写法 //只检测单个控件 view.isRunningAction() //检测整个界面 activity.isRunningAction() //java写法 //只检测单个控件 RunAction.isRunning(view) //检测整个界面 RunAction.isRunning(activity) ```