CircleProgressView

May 14, 2025 · View on GitHub

CircleProgressView for Android 是一个圆形的进度动画控件，动画效果纵享丝滑。

效果展示

你也可以直接下载演示App 体验效果

引入

Gradle:

在Project的 build.gradle 或 setting.gradle 中添加远程仓库
```
repositories {
    //...
    mavenCentral()
}
```

在Module的 build.gradle 中添加依赖项

implementation 'com.github.jenly1314:circleprogressview:1.1.3'

使用

CircleProgressView自定义属性说明（进度默认渐变色）

属性	值类型	默认值	说明
cpvStrokeWidth	dimension	12dp	笔画描边的宽度
cpvNormalColor	color	#FFC8C8C8	圆正常颜色
cpvProgressColor	color	#FF4FEAAC	圆进度颜色
cpvStartAngle	integer	270	开始角度，默认十二点钟方向
cpvSweepAngle	integer	360	扫描角度范围
cpvMax	integer	100	进度最大值
cpvProgress	integer	0	当前进度
cpvDuration	integer	500	动画时长
cpvLabelText	string		中间的标签文本，默认自动显示百分比
cpvLabelTextColor	color	#FF333333	文本字体颜色
cpvLabelTextSize	dimension	30sp	文本字体大小
cpvShowLabel	boolean	true	是否显示文本
cpvShowTick	boolean	true	是否显示外环刻度
cpvCirclePadding	dimension	10dp	外圆环刻度与内圆环间距
cpvTickSplitAngle	integer	5	刻度间隔的角度大小
cpvBlockAngle	integer	1	刻度的角度大小
cpvTickOffsetAngle	integer	0	刻度偏移的角度大小
cpvTurn	boolean	false	是否旋转
cpvCapRound	boolean	true	是否是圆形线冒（圆角弧度）
cpvLabelPaddingLeft	dimension	0dp	文本居左边内间距
cpvLabelPaddingTop	dimension	0dp	文本居顶边内间距
cpvLabelPaddingRight	dimension	0dp	文本居右边内间距
cpvLabelPaddingBottom	dimension	0dp	文本居底边内间距

示例

布局示例

    <com.king.view.circleprogressview.CircleProgressView
        android:id="@+id/cpv"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"/>

代码示例

    //显示进度动画，进度，动画时长
    circleProgressView.showAnimation(80,3000);
    //设置当前进度
    circleProgressView.setProgress(80);
    //设置进度改变监听
    circleProgressView.setOnChangeListener(onChangeListener);

更多使用详情，请查看app中的源码使用示例或直接查看 API帮助文档