安卓客户端
安卓客户端使用 Kotlin 构建，最低支持 Android 7.0（minSdk 24），目标 Android 14（targetSdk 34）。工程开箱即编译，服务器地址在应用内填写，不改一行代码即可接入你自己的私有阁服务端；要打造自有品牌，也只需替换图标、名称与包名。
环境准备
| 依赖 | 版本 | 说明 |
|---|---|---|
| Android Studio | Hedgehog 2023.1.1+ | 内置 SDK Manager 与模拟器 |
| JDK | 17 | AGP 8.x 必需 |
| Android Gradle Plugin | 8.3.2 | 工程已固定版本 |
| Kotlin | 1.9.22 | 工程已固定版本 |
| compileSdk / targetSdk | 34 | Android 14 |
| minSdk | 24 | Android 7.0，覆盖 98%+ 在网设备 |
安装与配置
解压源码包中的 android/ 目录，Android Studio → Open 打开工程根目录，等待首次 Gradle Sync 完成（视网络 5-10 分钟，建议配置国内镜像）。
打造自有品牌只需三处：
1. 应用名称：app/src/main/res/values/strings.xml 中的 app_name；
2. 图标与启动图：替换 res/mipmap-* 与 res/drawable 下对应资源；
3. 包名：app/build.gradle.kts 中的 namespace 与 applicationId（全局重构后同步移动目录）。
开发运行
连接真机（开启 USB 调试）或启动模拟器，点击 Run。安装后进入登录页，在服务器地址栏填入你的私有阁服务端地址（如 http://192.168.1.10:3000 或 https://im.example.com），注册账号即可使用。
常用检查
- 登录 / 注册 / 多账号切换正常；
- 单聊、群聊消息实时送达，断网重连后消息补齐；
- 图片、文件、语音发送成功；
- 音视频通话双方可见可闻（真机测试，模拟器不支持部分编解码）；
- 朋友圈、通讯录数据正常加载。
构建与打包
菜单 Build → Generate Signed Bundle / APK → 创建新的 keystore（妥善保管签名与密码，版本升级必须使用同一签名）→ 选择 release → 得到 app-release.apk 或 app-release.aab。
上架国内应用商店用 APK，上架 Google Play 用 AAB。每次发版递增 versionCode 并更新 versionName。
常见问题
- Gradle Sync 超时：配置国内镜像或代理，重试 Sync；
- 登录无响应：确认手机能访问服务器地址（浏览器打开
http://地址/api/health验证），云服务器检查安全组是否放行端口； - 音视频不通：服务端未配置 TURN 时，跨运营商网络可能失败，参见「进阶：基础服务部署」；
- 安装失败提示签名冲突：设备上已装过不同签名的版本，先卸载。