QMME 是一个非官方的 QQ 客户端项目：它内嵌 手表 QQ 9.0.7.2563 的框架 + NT 内核，并在其之上用一套自行构造的 UI 与包装重新驱动登录、会话与消息能力。
普通用户请加 QQ 群 601694292 下载。
- 本项目与腾讯公司无任何隶属或授权关系，"QQ" 商标归腾讯所有。
- 项目依赖腾讯 QQ 手表版的专有运行时（
qq-core-watch-runtime.jar及jniLibs/下的 native.so）。这些专有组件不可再分发，仅用于个人学习与技术研究，请于下载 24 小时后删除。 - 请在遵守相关法律法规及腾讯服务条款的前提下使用，风险自负。
最小可运行路径，细节见下文 构建与运行。
前置条件
- JDK 17+
- Android SDK（含
compileSdk 37对应 platform 与 build-tools，已接受 license） - 支持
armeabi-v7a的真机或模拟器
首次运行
# 1. 指向本地 Android SDK
echo "sdk.dir=/path/to/your/android-sdk" > local.properties
# 2. 编译并安装 Debug 包到已连接设备
./gradlew :app:installDebug
# 3. 启动应用
adb shell am start -n rj.qmme/.ui.MainActivity当前处于早期开发阶段，已实现：
- 登录 / 账号：基于 WtLogin 的手表版登录、账号持久化；被顶号 / 过期 / 强制下线（expired、kicked、forceLogout、suspend 等）时自动清理状态并回到登录页。
- 会话与联系人：最近会话列表、联系人列表。
- 单聊消息：加载最新消息、加载更早历史、实时收消息、发送文本、标记已读。
- 图片：系统图片选择器发送（
PicElement富媒体）、图片消息展示、全屏预览、保存到Pictures/QMME。 - 消息操作：长按菜单支持复制、撤回、删除、重发（危险操作二次确认）。
- 其它：表情资源桥接、APNG/Lottie 富图 native 初始化、崩溃捕获页、登录后进程重启以获得干净的内核初始化。
尚未完成：群聊 chatType/peerUid 映射的真机验证、语音、回复、转发、多选，以及富媒体收发的服务端联调。
| 类别 | 选型 |
|---|---|
| 语言 | Kotlin 2.4.0 + Java 17 |
| 构建 | Android Gradle Plugin 9.3.0，Gradle 9.5.0 |
| UI | Hikage 1.1.1（原生 View + Kotlin DSL）、BetterAndroid、Material Components、RecyclerView |
| 架构 | MVVM（AndroidX ViewModel + Lifecycle）、Kotlin Coroutines / StateFlow |
| 底层 | com.tencent.qqlite 9.0.7（MSF + NT Kernel，appId=537282233）、MMKV/QMMKV |
| ABI | 仅 armeabi-v7a；minSdk 23，targetSdk / compileSdk 37 |
应用把官方 MobileQQ 生命周期在 QmmeApp 中进行实现，再用协调器统一管理 runtime 身份。
QmmeApp (WatchApplicationDelegate)
├─ 初始化 QMMKV/MMKV、MultiDex、签名伪装、崩溃捕获
├─ 内嵌 MobileQQ 生命周期，绑定/解绑账号，处理官方下线回调
└─ 选择性把包名伪装成 com.tencent.qqlite（仅供 WtLogin/签名相关调用）
runtime/ RuntimeCoordinator · RuntimeSession · RuntimeLifecycleState
→ runtime 身份与 generation 的唯一事实来源，拒绝陈旧缓存写入
kernel/ KernelBridge + ProjectKernelBootstrap/Dependencies/DeviceInfo
→ 按序加载 NT native 库链、启动 KernelService、缓存各内核服务、
桥接 MSF 推送与前台状态
data/ ChatRepository（IKernelMsgService/kernelpublic.Contact 适配层）、
LoginPrefs、OnlineStatus、MediaStoreSaver、EmotionAssetBridge
viewmodel/ AuthViewModel · ChatListViewModel · ChatDetailViewModel · ContactsViewModel
ui/ MainActivity + ViewNavigator（基于 View 的导航栈，每页独立 LifecycleOwner）
各 *Hikagable 页面（Login/Main/ChatDetail/ImagePreview/Crash）与 Adapter
fix/ 兼容垫片：LegacyKiller（包名映射 PM 代理）、
PackageSignatureProvider/PkgSignFix/SignatureProbe（IPC 签名伪装）等
运行时生命周期：COLD → ATTACHING → APPLICATION_READY → RUNTIME_CREATED → ACCOUNT_BOUND → KERNEL_STARTING → ONLINE，由 RuntimeCoordinator 统一记录与保护。
qmme/
├─ app/
│ ├─ build.gradle.kts
│ ├─ libs/ # runtime jar
│ └─ src/main/
│ ├─ AndroidManifest.xml
│ ├─ java/rj/qmme/ # 应用代码（见上文架构）
│ ├─ jniLibs/armeabi-v7a/ # NT 内核 native .so
│ ├─ keepRules/ # ProGuard/R8 keep 规则
│ └─ res/
├─ gradle/libs.versions.toml
└─ settings.gradle.kts
- JDK 17+
- Android SDK（含
compileSdk 37对应的 platform 与 build-tools，并已接受相应 license）
在项目根目录创建 local.properties：
sdk.dir=/path/to/your/android-sdk或导出环境变量：
export ANDROID_HOME=/path/to/your/android-sdk
export ANDROID_SDK_ROOT=$ANDROID_HOME# 编译 Kotlin
./gradlew :app:compileDebugKotlin
# 单元测试
./gradlew :app:testDebugUnitTest
# 打 Debug
./gradlew :app:assembleDebug构建配置说明：
gradle.properties中已禁用 Gradle daemon、开启 parallel 与 configuration-cache；因 Hikage 1.1.1 约束，android.builtInKotlin=false且android.newDsl=false。
- 仅打包
armeabi-v7a，需在支持该 ABI 的设备 / 模拟器上运行。 - 富媒体（图片以外）、语音、回复、撤回时限、转发、多选等尚未完成。