作为Android官方提供的评分控件，RatingBar对于大家来说是比较熟悉的，但大部分人在用过原生RatingBar后肯定对它不满意，因为实在是不好用。这里的不好用包括了：大小改起来不方便、星星间距不好改、使用自己的图片居然还要写xml……总之你很难说出它的优点来，缺点却是脱口而出。

有鉴于此，自己写一个自定义的RatingBar就有必要了，而且要保证实现一些常用的属性，如大小、间距、点击事件等。考虑到这个控件是要在实际项目中发挥作用，而实际工作里是有UI设计给切图的，所以就没有在控件里自己去画星星，而是直接用切图来展示。当然，以后我会考虑使用Canvas直接画星星，这样使用的时候只需要给出颜色值就能得到想要的星星了。

好吧，这个项目我把它命名为NiceRatingBar，你可以在Github找到它的源码： https://github.com/KaelLi1989/NiceRatingBar 。当然，这是一个新发布的项目，功能目前比较单一，只支持使用图片来展示星星，不能只输入颜色就自己画星星，并且最低支持到0.5的颗粒度，还无法做到0.1分的颗粒度（更低就没必要了）。当然，这些feature未来会支持的。

一般来说一个评分控件需要有2种基本功能：一种是仅仅展示评分，无法继续操作更改评分；另一种就是可以更改评分。这2种基本功能，NiceRatingBar当然都实现了，仅仅展示评分一般用在商品列表和当前用户已经评分过的、不能重复评分的商品详情页面，能更改评分的地方一般就是用户对某个商品进行评分了。本控件支持传统的点击星星评分，也支持随手势左右滑动进行线性评分。

通过点击星星来设置分数

NiceRatingBar的使用很简单，大概分下面这么几部：

allprojects {
    repositories {
        maven { url 'https://jitpack.io' }
在相应的module的gradle里添加NiceRatingBar的依赖：
implementation 'com.github.KaelLi1989:NiceRatingBar:1.0.0'
当然如果你把依赖放在了项目的公共基础模块里，那么就要这样：
api 'com.github.KaelLi1989:NiceRatingBar:1.0.0'
在布局文件里进行控件的声明，需要注意有几项属性是必须设置的：
<com.kaelli.niceratingbar.NiceRatingBar
    android:id="@+id/niceRatingBar"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    // int型，代表满分，默认是5
    app:nrb_starTotal="10"
    // 每个星星的宽度
    app:nrb_starImageWidth="16dp"
    // 每个星星的高度
    app:nrb_starImageHeight="16dp"
    // 一颗完整星星的图片资源，是必须设置的属性
    app:nrb_starFullResource="@drawable/ic_star_black_16dp"
    // 一颗空白星星的图片资源，是必须设置的属性
    app:nrb_starHalfResource="@drawable/ic_star_border_black_16dp"
    // 半颗星星的图片资源，非必须。若设置了，则支持半颗星的展示与评分，否则仅支持整颗星效果
    app:nrb_starEmptyResource="@drawable/ic_star_half_black_16dp"
    // float型，初始评分值，非必须
    app:nrb_rating="1.1"
    // 星星之间的间距
    app:nrb_starImagePadding="2dp"
    // Enable表示用户可以进行评分，Disable则表示不可评分，仅展示评分
    app:nrb_ratingStatus="Enable" />
然后在Java(Kotlin)代码里进行相应的设置，比如你希望监听到用户的评分：
niceRatingBar.setOnRatingChangedListener(new OnRatingChangedListener() {
    @Override
    public void onRatingChanged(float rating) {
        // 在这里得到的rating就是用户通过控件得到的评分，通常你应该用通过接口把这个评分传到服务端
当把评分传到服务端成功后，在接口成功的回调里，你可以使用
niceRatingBar. setRatingStatus(RatingStatus.Disable);
这样控件的状态就变成了不能操作评分，只能展示评分了。之所以这样操作，是因为通常一个对象（如一件商品）只允许同一个用户评分1次，如果你允许多次评分那就没必要关闭打分了。
如果服务端提前获取数据，某个商品的评分是4.5分，而且只是展示评分不能打分，那么就要使用下面的代码，来设置评分，同时关闭更改评分的能力：
niceRatingBar. setRating(4.7f);
niceRatingBar. setRatingStatus(RatingStatus.Disable);
是的，NiceRatingBar的使用就是这么简单，马上替换掉那个难用的原生RatingBar吧。
															
Android的TextView显示HTML格式富文本（字体大小颜色图片图文混排等）11/2343,770
详解compileSdkVersion、minSdkVersion、targetSdkVersion及buildToolsVersion，让选择不再迷茫12/2815,246
Android实现PDF文件预览阅读功能的方案12/2313,899
ViewPager与适配器PagerAdapter搭配使用详解与源码解析02/1512,842
TransactionTooLargeException: data parcel size  xxx bytes原因与解决方案08/0112,343