# 跑通示例项目 (/zh-CN/realtime-media/rtc-server-sdk/get-started/run-example/java) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 本文介绍如何创建一个简单的 Maven 项目,集成 RTC 服务端 Java SDK,并运行应用。 ## 准备开发环境 [#准备开发环境-1] 确保你的服务器满足以下需求。 ### 硬件环境 [#硬件环境-1] **操作系统** - Ubuntu(18.04 版本及以上) - CentOS(7.0 版本及以上) **CPU 架构** - x86-64 如果你需要在其他架构上集成 SDK,请联系 sales@shengwang.cn。 **性能** - CPU:8 核 1.8 GHz 或更高配置 - 内存 2 GB。推荐 4 GB 或更高内存。 **网络** - 服务器接入公网,有公网 IP - 服务器允许访问 .agora.io 以及 .agoralab.co ### 软件环境 [#软件环境-1] - [Apache Maven](https://maven.apache.org/download.cgi) 或其他构建工具。本文使用 Apache Maven。 - JDK 8 ## 开通服务 [#开通服务-1] 参考[开通服务](/zh-CN/realtime-media/rtc-server-sdk/build/enable-service)获取声网 App ID 和 RTC 临时 Token。 ## 创建一个 Maven 项目 [#创建一个-maven-项目] 参考 [Maven in Five Minutes](https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html) 创建 Maven 项目 ```shell mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DinteractiveMode=false ``` ## 集成 SDK [#集成-sdk] 1. 导航至 `my-app` 目录。 ```shell cd my-app ``` 2. 打开 `pom.xml` 文件并将文件内容替换为以下文本: :::info[信息] `dependencies` 中的 `version` 字段为 SDK 版本号,需随你集成的 SDK 版本更换。最新的 SDK 版本号可参考[发版说明](/zh-CN/realtime-media/rtc-server-sdk/reference/release-notes)。 ::: ```xml 4.0.0 org.example agora-rtc-linux-java 1.0-SNAPSHOT io.agora.rtc linux-java-sdk 4.4.32 1.8 1.8 org.apache.maven.plugins maven-shade-plugin 2.3 true package shade App ``` :::info[信息] 如果你使用其他的集成方式,可以参考 [mvnrepository](https://mvnrepository.com/artifact/io.agora.rtc/linux-sdk)。 ::: ## 实现一个 HelloWorld 应用 [#实现一个-helloworld-应用] 1. 导航至 `my-app/src` 并删除 `test` 目录。 ```shell rm -r test ``` 2. 导航至 `my-app/src/main/java/com/mycompany/app/App.java` 并将内容替换为以下文本。 将 `Your Token` 和 `Your App ID` 替换为你的 RTC 临时 Token 和声网 App ID。 :::warning[注意] 连接 RTC 频道的用户 ID 必须和生成 RTC 临时 Token 的用户 ID 一致。在下面的示例代码中,频道名设为 "test_channel"。如果你使用其他频道名生成 Token,则需要将 "test_channel" 替换为你自己使用的频道名。 ::: ```java import io.agora.rtc.SDK; import io.agora.rtc.AgoraRtcConn; import io.agora.rtc.AgoraService; import io.agora.rtc.AgoraServiceConfig; import io.agora.rtc.DefaultRtcConnObserver; import io.agora.rtc.RtcConnInfo; public class App { public static class ConnObserver extends DefaultRtcConnObserver { @Override public void onConnected(AgoraRtcConn conn, RtcConnInfo rtcConnInfo, int reason) { System.out.println("join success"); } } public static void main(String[] args) throws Exception { String token = "Your Token"; AgoraService service = new AgoraService(); AgoraServiceConfig config = new AgoraServiceConfig(); config.setEnableAudioProcessor(0); config.setEnableAudioDevice(0); config.setEnableVideo(0); config.setContext(0); config.setAppId("Your App ID"); service.initialize(config); AgoraRtcConn conn = service.agoraRtcConnCreate(null); conn.registerObserver(new ConnObserver()); conn.connect(token, "test_channel", "1"); Thread.sleep(2000); conn.disconnect(); conn.destroy(); service.destroy(); } } ``` 3. 导航至 `my-app` 目录并创建一个 `lib` 目录,从 Maven 获取 `linux-java-sdk` jar 文件并提取文件。 :::info[信息] `dependencies` 中的 `version` 字段为 SDK 版本号,需随你集成的 SDK 版本更换。最新的 SDK 版本号可参考[发版说明](/zh-CN/realtime-media/rtc-server-sdk/reference/release-notes)。 ::: ```shell mkdir lib cd lib wget https://repo1.maven.org/maven2/io/agora/rtc/linux-java-sdk/4.4.32/linux-java-sdk-4.4.32.jar jar xvf linux-java-sdk-4.4.32.jar ``` 4. 导航至 `my-app` 目录。将 `lib/native/linux/x86_64` 目录加入 `LD_LIBRARY_PATH` 。 ```shell export LD_LIBRARY_PATH=lib/native/linux/x86_64/:$LD_LIBRARY_PATH ``` 5. 构建项目: ```shell mvn package ``` 6. 运行应用: ```shell java -cp target/agora-rtc-linux-java-1.0-SNAPSHOT.jar com.mycompany.app.App ``` 如果 App 运行成功,控制台会打印以下信息: ```shell $ java -cp target/agora-rtc-linux-java-1.0-SNAPSHOT.jar com.mycompany.app.App join success ```