# hr-contribution

**Repository Path**: Hancher/hr-contribution

## Basic Information

- **Project Name**: hr-contribution
- **Description**: No description available
- **Primary Language**: Android
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-08-13
- **Last Updated**: 2025-10-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ContributionView

一个 Android 上显示类似于 GitHub 和 gitee 上贡献度的图表，用于笔记、活动状态等统计显示

## 地址

[![](https://jitpack.io/v/com.gitee.Hancher/hr-contribution.svg)](https://jitpack.io/#com.gitee.Hancher/hr-contribution)

## 运行效果

![运行效果图](https://img-blog.csdnimg.cn/20210325113542246.gif#pic_center)

## 添加依赖

### 在project的build.gradle添加如下代码

```
	allprojects {
		repositories {
			...
			maven { url 'https://jitpack.io' }
		}
	}
```

### 在app的build.gradle中添加如下代码

```
	dependencies {
	        implementation 'com.gitee.Hancher:hr-contribution:1.0.0'
	}
```

## 默认方案

### xml文件

```xml
<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent"
    android:layout_height="match_parent" tools:context=".activity.AccountActivity">

    <com.hancher.plugins.hrcontribution.HrContributionView android:id="@+id/contribution_view"
        android:layout_width="match_parent" android:layout_height="wrap_content"
        android:layout_marginTop="8dp" app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent" app:layout_constraintTop_toTopOf="parent" />
</androidx.constraintlayout.widget.ConstraintLayout>
```

只需要固定宽度，高度会自动调整，因此高度使用包裹即可。

因此可以根据个人需要，将其用横向滚动布局包裹，扩大横向固定宽度，实现左右滑动，在此不再一一实验。

### java调用

```java

Calendar calendar = Calendar.getInstance();
        calendar.

add(Calendar.DAY_OF_MONTH, -182);

List<HrContributionItem> data = new ArrayList<>();
for(
int i = 0;
i< 182;i++){
        data.

add(new HrContributionItem(calendar.getTime(),i %2));
        calendar.

add(Calendar.DAY_OF_MONTH, 1);
}

HrContributionConfig config = new HrContributionConfig()
        .setBorderWidth(2)
        .setBorderColor(-6381922)
        .setItemRound(5)
        .setMonths(new String[]{"1月", "2月", "3月", "4月", "5月", "6月", "7月", "8月", "9月", "10月", "11月", "12月"})
        .setPadding(4)
        .setRank(new int[]{0, 1})
        .setRankColor(new int[]{-1315344, -12490271})
        .setWeeks(new String[]{"周一", "", "周三", "", "周五", "", "周天"})
        .setStartOfWeek(Calendar.MONDAY)
        .setTxtColor(-6381922);

HrContributionView contributionView = findViewById(R.id.contribution_view);
        contributionView.

setData(data.get(0).

getTime(),data,config);
```

## 其他接口

通过配置实体类，修改样式

```
setData(Date startDate, List<ContributionItem> data, ContributionConfig config)
```

配置接口

```java
HrContributionConfig config = new HrContributionConfig()
        .setBorderWidth(2)//边框宽度
        .setBorderColor(0xFF9E9E9E)//边框颜色
        .setItemRound(5)//圆角矩形圆半径
        .setMonths(new String[]{"1月", "2月", "3月", "4月", "5月", "6月", "7月", "8月", "9月", "10月", "11月", "12月"})//月份字符串
        .setPadding(4)//单个框宽度
        .setRank(new int[]{0, 2, 5, 8, 10})//颜色等级范围，大于等于2小于5则为第二个颜色范围
        .setRankColor(new int[]{0xFFEBEDF0, 0xFF9BE9A8, 0xFF40C463, 0xFF30A14E, 0xFF216E39})//填充的等级颜色
        .setWeeks(new String[]{"", "周一", "", "周三", "", "周五", ""})//周名称
        .setStartOfWeek(Calendar.SUNDAY)//配合setWeeks一起使用，可以实现第一行为周日，默认第一行周一
        .setTxtColor(0xFF9E9E9E);//设置文字颜色
```

配置点击监听

```java
contributionView.setOnItemClick(new ContributionView.OnItemClickListener() {
    @Override
    public void onClick ( int position, ContributionItem item){
        StringBuffer stringBuffer = new StringBuffer();
        stringBuffer.append("当前位置:").append(position)
                .append("\n图表中位置:[").append(item.getRow()).append(",")
                .append(item.getCol()).append("]\n")
                .append("时间:").append(item.getTime());
        Toast.makeText(MainActivity.this, stringBuffer, Toast.LENGTH_SHORT).show();
    }
});
```

## 备注

如果你觉得这个库还不错,请赏我一颗star吧

如果star超过1k，或者有打赏（下图），那我再回头看看增加一些其他功能

1. 纵向贡献图表

2. 动画