https://github.com/jenly1314/circleprogressview
🎡 CircleProgressView是一个圆形渐变的进度动画控件（支持外环显示刻度，内环随之变化，配置参数完全可配），动画效果纵享丝滑。
https://github.com/jenly1314/circleprogressview
android animator circle circleprogressbar circleprogressview loading progress progressbar progressview
Last synced: 9 months ago
JSON representation
🎡 CircleProgressView是一个圆形渐变的进度动画控件（支持外环显示刻度，内环随之变化，配置参数完全可配），动画效果纵享丝滑。
- Host: GitHub
- URL: https://github.com/jenly1314/circleprogressview
- Owner: jenly1314
- License: mit
- Created: 2019-02-17T12:14:04.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2024-06-20T10:53:09.000Z (over 1 year ago)
- Last Synced: 2025-03-29T00:04:28.195Z (9 months ago)
- Topics: android, animator, circle, circleprogressbar, circleprogressview, loading, progress, progressbar, progressview
- Language: Java
- Homepage:
- Size: 5.81 MB
- Stars: 455
- Watchers: 10
- Forks: 63
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# CircleProgressView
[](https://raw.githubusercontent.com/jenly1314/CircleProgressView/master/app/release/app-release.apk)
[](https://bintray.com/beta/#/jenly/maven/circleprogressview)
[](https://repo1.maven.org/maven2/com/github/jenly1314/circleprogressview)
[](https://jitpack.io/#jenly1314/CircleProgressView)
[](https://travis-ci.org/jenly1314/CircleProgressView)
[](https://circleci.com/gh/jenly1314/CircleProgressView)
[](https://android-arsenal.com/api?level=16)
[](https://opensource.org/licenses/mit-license.php)
CircleProgressView for Android 是一个圆形的进度动画控件，动画效果纵享丝滑。
## Gif 展示
> 你也可以直接下载 [演示App](https://raw.githubusercontent.com/jenly1314/CircleProgressView/master/app/release/app-release.apk) 体验效果
## 引入
### Gradle:
1. 在Project的 **build.gradle** 或 **setting.gradle** 中添加远程仓库
```gradle
repositories {
//...
mavenCentral()
}
```
2. 在Module的 **build.gradle** 里面添加引入依赖项
```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| 文本居底边内间距 |
### 示例
布局示例
```Xml
```
代码示例
```Java
//显示进度动画，进度，动画时长
circleProgressView.showAnimation(80,3000);
//设置当前进度
circleProgressView.setProgress(80);
//设置进度改变监听
circleProgressView.setOnChangeListener(onChangeListener);
```
更多使用详情，请查看[app](app)中的源码使用示例或直接查看 [API帮助文档](https://jitpack.io/com/github/jenly1314/CircleProgressView/latest/javadoc/)
## 相关推荐
#### [ArcSeekBar](https://github.com/jenly1314/ArcSeekBar) 一个弧形的拖动条进度控件，配置参数完全可定制化。
## 版本记录
#### v1.1.3：2021-9-2 (从v1.1.3开始发布至 MavenCentral)
* 对外暴露更多getter和setter方法
* 新增cpvTickOffsetAngle属性
#### v1.1.2：2020-12-2
* 优化设置渐变色过程处理
#### v1.1.1：2020-4-2
* 新增cpvLabelPadding..相关属性
#### v1.1.0：2019-8-19
* 移除appcompat依赖
#### v1.0.1：2019-5-23
* 新增cpvTurn属性（是否旋转）
#### v1.0.0：2019-2-17
* CircleProgressView初始版本
## 赞赏
如果您喜欢CircleProgressView，或感觉CircleProgressView帮助到了您，可以点右上角“Star”支持一下，您的支持就是我的动力，谢谢 :smiley:
您也可以扫描下面的二维码，请作者喝杯咖啡 :coffee:
## 关于我
| 我的博客 | GitHub | Gitee | CSDN | 博客园 |
|:------------------------------------------------------------------------------------|:----------------------------------------------------------------------------------------|:---------------------------------------------------------------------------------------|:-------------------------------------------------------------------------------------|:-------------------------------------------------------------------------------|
| Jenly's Blog | jenly1314 | jenly1314 | jenly121 | jenly |
## 联系我
| 微信公众号 | Gmail邮箱 | QQ邮箱 | QQ群 | QQ群 |
|:-------------|:---------------------------------------------------------------------------------|:----------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------------------------------------------|
| [Jenly666](http://weixin.qq.com/r/wzpWTuPEQL4-ract92-R) | jenly1314 | jenly1314 | 20867961 | 64020761 |
