Android-RateThisApp 使用教程

项目介绍

Android-RateThisApp 是一个用于 Android 应用的开源库，旨在帮助开发者轻松实现应用内评分功能。该库允许开发者根据应用的启动次数和安装后的时间间隔，自动显示一个提示用户在 Google Play 上评价应用的对话框。

项目快速启动

依赖添加

首先，在项目的 build.gradle 文件中添加依赖：

dependencies {
    implementation 'io.github.kobakei:ratethisapp:x.y.z'
}

请将 x.y.z 替换为最新的版本号。

初始化

在应用的主活动（通常是 MainActivity）的 onCreate 方法中进行初始化和显示评分对话框：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    // 监控启动次数和安装后的时间间隔
    RateThisApp.onCreate(this);

    // 如果条件满足，显示“Rate this app”对话框
    RateThisApp.showRateDialogIfNeeded(this);
}

应用案例和最佳实践

自定义条件

默认情况下，对话框会在以下任一条件满足时显示：

• 应用启动超过 10 次
• 应用安装后超过 7 天

如果需要自定义条件，可以在 Application 或主活动的 onCreate 方法中调用 RateThisApp.init(Configuration)：

// 自定义条件：3 天和 5 次启动
RateThisApp.Config config = new RateThisApp.Config(3, 5);
RateThisApp.init(config);

自定义字符串

可以自定义对话框的标题、消息和按钮标签：

RateThisApp.Config config = new RateThisApp.Config();
config.setTitle(R.string.my_own_title);
config.setMessage(R.string.my_own_message);
config.setYesButtonText(R.string.my_own_rate);
config.setNoButtonText(R.string.my_own_thanks);
config.setCancelButtonText(R.string.my_own_cancel);
RateThisApp.init(config);

自定义 URL

默认情况下，评分按钮会导航到 Google Play 上的应用页面。可以自定义这个 URL：

RateThisApp.Config config = new RateThisApp.Config();
config.setUrl("http://www.example.com");
RateThisApp.init(config);

停止显示评分对话框

如果需要停止显示评分对话框，可以使用以下方法：

RateThisApp.stopRateDialog(this);

回调

可以接收评分对话框中按钮点击事件的回调：

RateThisApp.setCallback(new RateThisApp.Callback() {
    @Override
    public void onYesClicked() {
        Toast.makeText(MainActivity.this, "Yes event", Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onNoClicked() {
        Toast.makeText(MainActivity.this, "No event", Toast.LENGTH_SHORT).show();
    }

    @Override
    public void onCancelClicked() {
        Toast.makeText(MainActivity.this, "Cancel event", Toast.LENGTH_SHORT).show();
    }
});

典型生态项目

Android-RateThisApp 作为一个专注于应用内评分功能的库，可以与其他 Android 开发库和工具结合使用，例如：

• Retrofit：用于网络请求
• Glide：用于图片加载
• Room：用于数据库操作

这些库可以共同提升应用的用户体验和功能性。