SimpleRatingBar 开源项目使用教程

1. 项目介绍

SimpleRatingBar 是一个简单易用的 RatingBar 库，旨在帮助开发者快速创建自定义的评分条。该项目提供了三种不同类型的 RatingBar：

• BaseRatingBar: 无动画效果的 RatingBar。
• ScaleRatingBar: 带有渐进和缩放动画效果的 RatingBar。
• RotationRatingBar: 带有渐进和旋转动画效果的 RatingBar。

该项目支持多种自定义选项，包括图像和动画的定制，适用于 Android 开发。

2. 项目快速启动

2.1 安装依赖

首先，在你的 build.gradle 文件中添加 JitPack 仓库：

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

然后，添加依赖：

dependencies {
    implementation 'com.github.ome450901:SimpleRatingBar:LATEST_VERSION'
}

2.2 在布局文件中使用

在 XML 布局文件中添加 ScaleRatingBar：

<com.willy.ratingbar.ScaleRatingBar
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/simpleRatingBar"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    app:srb_numStars="3"
    app:srb_minimumStars="1"
    app:srb_rating="2"
    app:srb_starWidth="30dp"
    app:srb_starHeight="30dp"
    app:srb_starPadding="15dp"
    app:srb_stepSize="0.5"
    app:srb_isIndicator="false"
    app:srb_clickable="true"
    app:srb_scrollable="true"
    app:srb_clearRatingEnabled="true"
    app:srb_drawableEmpty="@drawable/start_empty"
    app:srb_drawableFilled="@drawable/star_filled" />

2.3 在代码中使用

在 Java 或 Kotlin 代码中初始化和配置 ScaleRatingBar：

ScaleRatingBar ratingBar = new ScaleRatingBar(this);
ratingBar.setNumStars(5);
ratingBar.setMinimumStars(1);
ratingBar.setRating(3);
ratingBar.setStarPadding(10);
ratingBar.setStepSize(0.5f);
ratingBar.setWidth(105);
ratingBar.setHeight(105);
ratingBar.setIsIndicator(false);
ratingBar.setClickable(true);
ratingBar.setScrollable(true);
ratingBar.setClearRatingEnabled(true);
ratingBar.setEmptyDrawableRes(R.drawable.start_empty);
ratingBar.setFilledDrawableRes(R.drawable.start_empty);
ratingBar.setOnRatingChangeListener(new BaseRatingBar.OnRatingChangeListener() {
    @Override
    public void onRatingChange(BaseRatingBar ratingBar, int rating, boolean fromUser) {
        Log.e(TAG, "onRatingChange: " + rating);
    }
});

3. 应用案例和最佳实践

3.1 应用案例

• 电影评分应用: 在电影详情页面中使用 ScaleRatingBar 展示用户评分，并允许用户进行评分。
• 电商应用: 在商品详情页面中使用 RotationRatingBar 展示商品评分，并允许用户进行评分。

3.2 最佳实践

• 自定义图像: 通过设置 app:srb_drawableEmpty 和 app:srb_drawableFilled 属性，自定义评分条的图像。
• 动画效果: 使用 ScaleRatingBar 或 RotationRatingBar 来增加用户体验的动态效果。
• 事件监听: 通过设置 setOnRatingChangeListener 监听评分变化，实现业务逻辑。

4. 典型生态项目

• Android 动画库: 与 Android 动画库结合使用，增强评分条的动画效果。
• 数据存储库: 与数据存储库结合使用，将用户评分数据存储到本地或云端。
• UI 组件库: 作为 UI 组件库的一部分，提供丰富的 UI 组件选择。

通过以上步骤，你可以快速上手并使用 SimpleRatingBar 库，为你的 Android 应用添加自定义评分功能。