Maoni 开源项目教程

1、项目介绍

Maoni 是一个轻量级的开源库，用于从 Android 应用程序内部收集和处理用户反馈。该项目遵循 Material Design 原则，旨在为现有 Android 应用程序提供无缝且直观的用户反馈集成体验。Maoni 支持多种反馈处理方式，如电子邮件、Slack、GitHub、Jira 和 Doorbell 等。

2、项目快速启动

导入依赖

首先，在项目的 build.gradle 文件中声明 Maven Central 仓库，并导入 Maoni 库：

repositories {
    mavenCentral()
}

dependencies {
    implementation('org.rm3l:maoni:10.0.0@aar') {
        transitive = true
        exclude module: 'unspecified'
    }
}

集成 Maoni

在应用程序中启动 Maoni 实例，例如在按钮点击监听器中：

new Maoni.Builder(<myContextObject>, MY_FILE_PROVIDER_AUTHORITY)
    .withDefaultToEmailAddress("[e-mail]")
    .build()
    .start(MaoniSampleMainActivity.this);

3、应用案例和最佳实践

自定义反馈处理

Maoni 允许通过自定义处理程序来处理反馈，例如将反馈发送到 Slack：

final org.rm3l.maoni.slack.MaoniSlackListener slackListenerForMaoni = new org.rm3l.maoni.slack.MaoniSlackListener(SLACK_WEBHOOK_URL, CHANNEL);

new Maoni.Builder(MY_FILE_PROVIDER_AUTHORITY)
    .withListener(slackListenerForMaoni)
    .build()
    .start(MaoniSampleMainActivity.this);

捕获屏幕截图

Maoni 可以捕获当前活动的屏幕截图，并将其包含在反馈中：

new Maoni.Builder(<myContextObject>, MY_FILE_PROVIDER_AUTHORITY)
    .withDefaultToEmailAddress("[e-mail]")
    .build()
    .start(MaoniSampleMainActivity.this);

4、典型生态项目

maoni-email

用于将用户反馈通过电子邮件发送：

dependencies {
    implementation('org.rm3l:maoni-email:10.0.0@aar') {
        transitive = true
        exclude module: 'unspecified'
    }
}

maoni-slack

用于将用户反馈发送到 Slack 频道：

dependencies {
    implementation('org.rm3l:maoni-slack:10.0.0@aar') {
        transitive = true
        exclude module: 'unspecified'
    }
}

通过这些生态项目，Maoni 提供了丰富的反馈处理选项，满足不同应用场景的需求。