返回

Android 线性进度等待动画 JMWorkProgress:一键添加,随用随取!

Android

使用 JMWorkProgress 库轻松实现 Android 应用程序中的自定义等待动画

在 Android 应用程序开发中,等待动画扮演着至关重要的角色。它们可以提示用户应用程序正在处理请求,避免因长时间等待造成的挫败感。虽然 Android 系统提供默认的等待动画,但在某些情况下,我们可能需要自定义等待动画以契合我们的应用程序设计或品牌形象。

因此,我创建了 JMWorkProgress ,一个轻量级的库,旨在为 Android 应用程序添加自定义线性进度等待动画。它利用属性动画来创造平滑流畅的动画效果,并且可以轻松集成到任何布局中。

如何使用 JMWorkProgress

使用 JMWorkProgress 非常简单。首先,在你的项目中添加依赖关系:

implementation 'com.github.jmontiel.jmworkprogress:jmworkprogress:1.0.2'

接下来,在布局文件中,添加一个 JMProgressView 控件:

<com.jmontiel.jmworkprogress.JMProgressView
    android:layout_width="match_parent"
    android:layout_height="5dp" />

最后,在你的活动或片段中,调用 show() 方法显示等待动画,调用 hide() 方法隐藏动画:

progressView.show()

// ...

progressView.hide()

自定义 JMWorkProgress

JMWorkProgress 支持对动画的各个方面进行自定义,包括颜色、大小和持续时间。可以通过调用 setTintColor()setStrokeWidth()setDuration() 方法实现这些自定义。

例如,以下代码将等待动画的颜色设置为红色,宽度设置为 10dp,持续时间设置为 2 秒:

progressView.setTintColor(Color.RED)
progressView.setStrokeWidth(10)
progressView.setDuration(2000)

示例代码

JMWorkProgress 库的示例代码已在 GitHub 存储库中提供。你可以克隆存储库并按照 README 文件中的说明进行操作。

代码示例

这是一个使用 JMWorkProgress 显示自定义等待动画的示例代码:

val progressView = findViewById<JMProgressView>(R.id.progress_view)

// 设置动画颜色、宽度和持续时间
progressView.setTintColor(Color.BLUE)
progressView.setStrokeWidth(8)
progressView.setDuration(1500)

// 显示等待动画
progressView.show()

// 隐藏等待动画
progressView.hide()

常见问题解答

1. 如何更改等待动画的形状?

目前,JMWorkProgress 仅支持线性进度等待动画。

2. 如何添加一个文本标签到等待动画?

JMWorkProgress 不支持添加文本标签,但你可以结合使用其他库或自定义视图来实现。

3. 如何让等待动画循环播放?

你可以通过反复调用 show() 方法让等待动画循环播放。

4. 如何控制等待动画的起点和终点?

JMWorkProgress 不支持控制等待动画的起点和终点。

5. 是否可以将等待动画与其他动画组合使用?

是的,你可以将 JMWorkProgress 与其他动画组合使用,例如 Alpha 动画或 Scale 动画。

总结

JMWorkProgress 是一个轻量级、易于使用的库,可以帮助你轻松地向你的 Android 应用程序添加自定义线性进度等待动画。它具有高度可定制性,并且可以与任何布局集成。

无论你是开发新应用程序还是正在更新现有应用程序,JMWorkProgress 都能帮助你提升用户体验,让等待时间变得更加赏心悦目。