# 实现收发消息 (/zh-CN/realtime-media/rtm/get-started/quick-start/android) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 本文将指导你如何利用 RTM Java SDK 构建简单的应用程序,内容涵盖了集成和开发的基础知识:开通声网账号、获取 SDK、发送消息、接收消息等。 同时,我们也提供了开源的示例项目供你参考,你可以前往下载或查看其中的源代码。 ## 准备工作 [#准备工作] 开始构建项目前,你需要完成[开通 RTM 服务](/zh-CN/realtime-media/rtm/build/rtm-initialization/enable-service),并检查你的开发环境是否满足[平台支持](/zh-CN/realtime-media/rtm/reference/capabilities-and-compatibility/platform-support)中的最低版本要求。 ## 构建项目 [#构建项目] ### 1. 项目配置 [#1-项目配置] 根据以下步骤配置你的项目: 1. 在 Android Studio 里,创建一个 **Empty Activity** 类型的项目并打开。 2. 通过以下任意一种方式获取最新的 RTM Java SDK 并导入你的项目。 使用 CDN 使用 Maven 1. [点击此处](https://download.shengwang.cn/rtm2/release/RTM_JAVA_SDK_for_Android_v2.3.1.zip)下载最新版本的 Java SDK。 2. 将 SDK 包内 `sdk` 文件夹中的所有文件拷贝到项目的 `/app/libs` 路径下。 3. 添加 SDK 引用。在 **Project** 窗口找到 `/Gradle Scripts/build.gradle(Module: .app)` 文件并添加如下代码: 1. 在 `defaultConfig` 节点添加 `ndk` 节点,指定支持的架构。 ```groovy Config { // ... ndk{ abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64' } } ``` :::info[信息] 支持的架构越多,App 的体积会越大,声网建议你根据实际情况添加需要支持的架构。一般在发布 Android App 时只需保留 armeabi-v7a 和 arm64-v8a 架构。 ::: 2. 在 `android` 节点添加 `sourceSets` 节点,指定 `libs` 所在目录。 ```groovy android { // ... sourceSets { main { jniLibs.srcDirs = ['libs'] } } } ``` 3. 在 `dependencies` 节点引入 `libs` 路径下所有的 jar 库。 ```groovy dependencies { implementation fileTree(dir: 'libs', include: ['*.jar']) // ... } ``` 1. 自 v2.3.1 起,通过 Maven 集成 RTM SDK 时,需要添加声网 Maven 仓库。在项目根目录的 `settings.gradle` 文件中,向 `dependencyResolutionManagement.repositories` 添加如下配置,并保留项目已有的仓库: ```groovy dependencyResolutionManagement { repositories { maven { url = 'https://download.shengwang.cn/maven/' } google() mavenCentral() } } ``` 如果项目未使用 `dependencyResolutionManagement`,则在项目根目录的 `build.gradle` 文件中,向 `allprojects.repositories` 添加声网 Maven 仓库: ```groovy allprojects { repositories { maven { url = 'https://download.shengwang.cn/maven/' } google() mavenCentral() } } ``` 2. 在 `/Gradle Scripts/build.gradle(Module: .app)` 文件中添加如下代码,将 SDK 集成到你的 Android 项目中: ```groovy dependencies { // 将下方版本号替换为需要的 SDK 版本号,如 2.3.1 // 对于 2.2.7 及之后版本: implementation 'cn.shengwang.rtm:android-java:2.3.1' // 如需 Lite SDK,将上一行替换为(需确保已通过其他声网 SDK 引入对应的 aosl 依赖): // implementation 'cn.shengwang.rtm:android-java-lite:2.3.1' // 对于 2.2.6 及之前版本: // implementation 'io.agora:agora-rtm:x.y.z' } ``` :::info[信息] 如果你同时集成了 2.2.0 及以上版本的 RTM SDK 和 4.3.0 及以上版本的 RTC SDK,请参考 [FAQ](/zh-CN/reference/faq/integration/rtm2_rtc_integration_issue) 处理集成问题。 ::: 3. 添加网络权限。打开 `app/src/main/AndroidManifest.xml` 文件,在 `` 的下一行添加如下代码: ```xml ``` 4. 在 `/Gradle Scripts/proguard-rules.pro` 文件中添加如下代码,以防止声网 SDK 的代码被混淆: ```java -keep class io.agora.**{*;} ``` ### 2. 初始化 RTM [#2-初始化-rtm] 调用 RTM SDK 的任何 API 之前,需要先初始化一个 `RtmClient` 对象实例。参考如下步骤创建用户界面、初始化一个 `RtmClient` 对象实例。 1. 创建用户界面。实时消息 App 一般会有如下输入框和按钮: - 用户名、频道名、消息输入框 - 登录、登出按钮 - 订阅、取消订阅频道按钮 - 发送消息按钮 本节提供简易的 UI 界面设计以便于验证功能特性,你可以根据实际项目需求进行修改。 1. 打开 `/app/res/layout/activity_main.xml` 文件,将文件内容替换为如下代码: ```xml