# CircleProgress

**Repository Path**: chinasoft2_ohos/CircleProgress

## Basic Information

- **Project Name**: CircleProgress
- **Description**: 实现自定义弧形与圆形进度条，以及水波纹圆形进度
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2021-05-11
- **Last Updated**: 2022-06-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CircleProgress

## 项目介绍

 * 项目名称：CircleProgress
 * 所属系列：openharmony的第三方组件适配移植
 * 功能：实现自定义弧形与圆形进度条，以及水波纹圆形进度
 * 项目移植状态：已完成
 * 调用差异：无
 * 开发版本：sdk6，DevEco Studio2.2 Beta1
 * 基线版本：release 1.0.0

## 效果演示
<img src="gif/round.gif"></image>

<img src="gif/speedwave.gif"></image>


## 安装教程
在项目根目录下的build.gradle文件中
```
allprojects {
    repositories {
        maven {
            url 'https://s01.oss.sonatype.org/content/repositories/releases/'
        }
    }
```
在entry模块中的build.gradle文件中
```

dependencies {
    implementation ('com.gitee.chinasoft_ohos:CircleProgress:1.0.0')
    ····
}
```
在sdk6，DevEco Studio2.2 Beta1下项目可直接运行 如无法运行，删除项目.gradle,.idea,build,gradle,build.gradle文件， 并依据自己的版本创建新项目，将新项目的对应文件复制到根目录下

## 使用说明
环形与圆形进度条使用此组件
```
            <com.littlejie.circleprogress.RoundProgressView
                ohos:id="$+id:foot_progress_bar"
                ohos:height="150vp"
                ohos:width="150vp"
                ohos:center_in_parent="true"
                ohos:layout_alignment="horizontal_center"
                app:bgArcColor="$color:progressBgColor"
                app:hint="走了"
                app:maxValue="10000"
                app:unit="步"
                app:value="3444"
                />
```
您可以选择在布局xml文件中设置以下属性，
```
1.hint  进度条中心文字
2.maxValue  进度条最大值
3.unit  进度条中心第二行文字
4.value  默认当前值
```


时速表使用此组件
```
            <com.littlejie.circleprogress.DialProgress
                ohos:id="$+id:speedProgress"
                ohos:height="200vp"
                ohos:width="200vp"
                ohos:center_in_parent="true"
                ohos:layout_alignment="horizontal_center"
                app:arcWidth="50"
                app:dialIntervalDegree="3"
                app:dialWidth="6"
                app:hint="时速"
                app:maxValue="300"
                app:unit="km/h"
                app:value="110"
                />
```
您可以选择在布局xml文件中设置以下属性，
```
1.hint  进度条中心文字
2.maxValue  进度条最大值
3.unit  进度条中心第二行文字
4.value  默认当前值
5.dialWidth 分隔条宽度
6.dialIntervalDegree 前景圆弧刻度数量
7.arcWidth 圆弧宽度
```

水波纹使用此组件
```
            <com.littlejie.circleprogress.WaveProgress
                ohos:id="$+id:waveProgress"
                ohos:height="200vp"
                ohos:width="200vp"
                ohos:layout_alignment="horizontal_center"
                app:darkWaveAnimTime="1000"
                app:darkWaveColor="$color:darkWave"
                app:lightWaveAnimTime="2000"
                app:lightWaveColor="$color:lightWave"
                app:lightWaveDirect="R2L"
                app:lockWave="false"
                app:value="70"
                app:valueSize="70"
                app:waveHeight="30dp"
                app:waveNum="1"
                />
```
您可以选择在布局xml文件中设置以下属性，
```
1.value  默认值
2.valueSize  默认值字体大小
3.waveHeight  水波纹高度
4.waveNum  水波数量
5.darkWaveAnimTime  水波速度
6.darkWaveColor  暗色水波颜色
7.lightWaveColor  亮色水波颜色
8.lightWaveDirect  亮色水波方向
```

## 测试信息
```
CodeCheck代码测试无异常

CloudTest代码测试无异常

病毒安全检测通过

当前版本demo功能与原组件基本无差异
```
## 版本迭代
> * 1.0.0