Merge pull request #1363 from xuchengpu/doc-v2

update after Developer experience review

Author: haoxiuwen

docs/document/android/easecallkit.md

@@ -9,20 +9,20 @@
 **利用 `EaseCallKit` 通话过程中，使用环信 ID 加入频道，方便音视频视图中显示用户名。如果用户不使用 `EaseCallKit` 而直接调用声网 API，也可以直接使用数字 UID 加入频道。**
 
 :::tip
-本 UI 库只和移动端 3.8.0 及以上版本 Demo 互通。3.8.1 的 UI 库使用声网数字 uid 加入频道，而 3.8.0 使用字符串加入频道，3.8.1 版本不与 3.8.0 互通，Demo 中 EaseCallKit 使用的 token 和 UID 均由你自己生成。若你需要使用声网对应的音视频服务，需单独在声网申请。
+Demo 中 EaseCallKit 使用的 token 和 UID 均由你自己生成。若你需要使用声网对应的音视频服务，需单独在声网申请。
 :::
 
 ## 跑通 Demo
 
-EaseCallKit 集成在环信开源 IM Demo 中，你可以通过进入 [环信 Demo 及源码](https://www.easemob.com/download/im) 下载页面，选择 Android 端进行下载，直接下载: [Android IM 源码](https://github.com/easemob/chat-android)。
+EaseCallKit 集成在环信开源 IM Demo 中，你可以通过进入 [环信 Demo](https://www.easemob.com/download/demo) 下载页面，选择 Android 端进行下载。或者直接下载: [Android IM 源码](https://github.com/easemob/easemob-demo-android)。
 
 环境准备：
 
-- Android Studio 3.5 及以上版本；
-- Gradle 4.6 及以上版本；
-- targetSdkVersion 29；
-- minSdkVersion 19；
-- Java JDK 1.8 及以上版本。
+- 推荐 Android Studio Meerkat | 2024.3.1 Patch 2及以上
+- 推荐 Gradle 8.0 及以上
+- targetVersion 33 及以上
+- Android SDK API 21 及以上
+- JDK 17 及以上
 
 运行 Demo：
 
@@ -53,10 +53,10 @@ EaseCallKit 集成在环信开源 IM Demo 中，你可以通过进入 [环信 De
 
 #### Gradle 方式集成
 
-- 在 `build.gradle` 中添加以下代码，重新 build 你的项目即可。
+- 在 `build.gradle` 中添加以下代码，重新 build 你的项目即可。[点击查看最新版本号](https://central.sonatype.com/artifact/io.hyphenate/ease-call-kit/versions)
 
 ```gradle
-implementation 'io.hyphenate:ease-call-kit:3.8.9'
+implementation 'io.hyphenate:ease-call-kit:4.15.1'
 ```
 
 :::tip
@@ -76,13 +76,11 @@ implementation project(':ease-call-kit')
 
 ```gradle
 //环信 SDK
-implementation 'io.hyphenate:hyphenate-chat:3.8.0' (`hyphenate-chat` 只支持 3.8.0 及以上版本)
+implementation 'io.hyphenate:hyphenate-chat:4.15.1'
 //声网 SDK
-implementation 'io.agora.rtc:full-sdk:3.8.0'
+implementation 'io.agora.rtc:full-rtc-basic:4.1.0'
 ```
 
-使用 easecallkit 4.0.1 或以上版本 时，请使用声网音视频库 `io.agora.rtc:full-sdk:4.1.0`。
-
 ### 添加权限
 
 根据场景需要，本库需要增加麦克风、相机和悬浮窗等权限:
@@ -109,7 +107,6 @@ implementation 'io.agora.rtc:full-sdk:3.8.0'
 在清单中增加 `EaseCallKit` 中的 `EaseVideoCallActivity` 和 `EaseMultipleVideoActivity`:
 
 ```xml
-//添加 Activity
 <activity
     android:name="com.hyphenate.easecallkit.ui.EaseVideoCallActivity"
     android:configChanges="orientation|keyboardHidden|screenSize"
@@ -140,7 +137,6 @@ callKitConfig.setRingFile(ringFile);
 //设置呼叫超时时间，单位为秒。
 callKitConfig.setCallTimeOut(30 * 1000);
 //设置声网的 appId。
-callKitConfig.setAgoraAppId("*****");
 Map<String, EaseCallUserInfo> userInfoMap = new HashMap<>();
 userInfoMap.put("***",new EaseCallUserInfo("****",null));
 callKitConfig.setUserInfoMap(userInfoMap);

docs/document/android/integration.md

@@ -4,9 +4,11 @@
 
 ## 开发环境要求
 
-- Android Studio 3.0 或以上版本；
-- Android SDK API 等级 21 或以上；
-- Android 5.0 或以上版本的设备。
+- 推荐 Android Studio Meerkat | 2024.3.1 Patch 2及以上
+- 推荐 Gradle 8.0 及以上
+- targetVersion 33 及以上
+- Android SDK API 21 及以上
+- JDK 17 及以上
 
 ## 集成 SDK
 
@@ -21,12 +23,6 @@
 
 ### 方法一：使用 mavenCentral 自动集成
 
-:::tip
-
-该方法仅适用于 v3.8.2 或以上版本。
-
-:::
-
 1. 在项目的 `build.gradle` 中添加 `mavenCentral()` 仓库。
 
 ```gradle
@@ -52,22 +48,12 @@ allprojects {
 ...
 dependencies {
     ...
-    // x.y.z 请填写具体版本号，必须为 3.8.2 或以上版本。
+    // x.y.z 请填写具体版本号
     // 可通过 SDK 发版说明获得最新版本号。
     implementation 'io.hyphenate:hyphenate-chat:x.x.x'
 }
 ```
 
-:::tip
-如果使用 3.8.0 之前的版本，gradle 依赖需要按照下面格式添加：
-:::
-
-```gradle
-implementation 'io.hyphenate:hyphenate-sdk:3.7.5' // 完整版本，包含音视频功能
-
-implementation 'io.hyphenate:hyphenate-sdk-lite:3.7.5' // 精简版，只包含IM功能
-```
-
 ### 方法二：手动复制 SDK 文件
 
 打开 [SDK 下载页面](https://www.easemob.com/download/im)，获取最新版的环信即时通讯 IM Android SDK，然后解压。
@@ -90,7 +76,7 @@ implementation 'io.hyphenate:hyphenate-sdk-lite:3.7.5' // 精简版，只包含I
 ...
 dependencies {
     ...
-    // x.y.z 请填写具体版本号，必须为 3.8.2 或以上版本。
+    // x.y.z 请填写具体版本号
     // 可通过 SDK 发版说明获得最新版本号。
     implementation(files("libs/hyphenatechat_x.y.z.jar"))
 }

docs/document/android/quickstart.md

@@ -12,10 +12,11 @@
 
 ## 前提条件
 
-- Android Studio 4.0 或以上版本；
-- Android SDK API 等级 21 或以上；
-- Android 5.0 或以上版本的设备；
-- JDK 11 或以上
+- 推荐 Android Studio Meerkat | 2024.3.1 Patch 2及以上
+- 推荐 Gradle 8.0 及以上
+- targetVersion 33 及以上
+- Android SDK API 21 及以上
+- JDK 17 及以上
 - 有效的环信即时通讯 IM 开发者账号和 App key，见 [环信即时通讯云控制台](https://console.easemob.com/user/login)。
 
 ## 准备开发环境