UserVoice Android SDK 使用指南

1. 项目目录结构及介绍

UserVoice Android SDK 的仓库结构简洁明了，旨在快速集成到您的Android应用中。以下是关键的目录及其功能概述：

• UVDemo: 示例应用程序，演示如何在实际应用中使用UserVoice SDK。
• UserVoiceSDK: SDK的核心代码库，包含了所有用于与UserVoice服务交互的功能实现。
• CHANGELOG.md: 版本更新日志，记录了各个版本的更改详情。
• LICENSE: 开源许可证文件，说明了软件使用的MIT协议。
• README.md: 项目的主要读我文件，提供了快速入门指导和重要的集成信息。
• build.gradle: Gradle构建脚本，定义了项目依赖和构建配置。
• proguard-rules.pro: ProGuard规则文件，防止编译时优化移除必要的类或方法。

2. 项目的启动文件介绍

在Android应用中集成UserVoice SDK的首要步骤是初始化。这通常发生在应用的入口点，如主Activity的onCreate()方法内。以下是一段示例代码，展示了如何进行初始化：

Config config = new Config("yoursite.uservoice.com");
UserVoice.init(config, this);

这里的this代表当前上下文，yoursite.uservoice.com应替换为您在UserVoice上的站点地址。确保在尝试访问任何UserVoice界面之前完成此初始化过程。

3. 项目的配置文件介绍

尽管具体的配置信息主要通过编码方式（例如使用Config对象）来设定，但项目的配置可以视为广义上包括AndroidManifest.xml中的权限设置以及Gradle配置文件中的依赖声明。

AndroidManifest.xml

虽然这个指引没有直接提及修改AndroidManifest.xml的具体需求，但在实际集成过程中，如果SDK有特别的权限需求（比如网络访问），您可能需要在这里添加相应的权限标签。

Gradle 配置

在您的app级别的build.gradle文件中，需要添加UserVoice SDK作为依赖项，并且可能需要对jcenter()的引用（虽然当前jcenter已不建议使用，实际操作中推荐迁移到其他仓库如Maven Central）。此外，由于旧版指导提到使用jcenter(), 新的项目应当考虑使用mavenCentral()替代，并指定SDK的确切版本号，示例如下:

dependencies {
    implementation 'com.uservoice:uservoice-android-sdk:<latest_version>'
}

将<latest_version>替换为实际的最新版本号，您可以从GitHub Release页面找到最新的版本。

此外，考虑到ProGuard规则的配置，还需在proguard-rules.pro文件中加入特定的保持规则，避免编译优化引起的问题。

请注意，上述 Gradle 部分假设了一个标准的现代Android开发环境配置。UserVoice SDK的具体版本兼容性和依赖管理，务必参考最新版本的官方文档或Release Notes。