真正连在一起、做互动、做协同的基线工程。你能在它里边看到：
扫描发现 Rokid 眼镜，并完成蓝牙连接与鉴权
拉取眼镜的状态（电量、音量、亮度、充电）并在手机端展示与调节
打开眼镜相机拍照并把图片回传到手机端保存与入库
下发自定义界面到眼镜端（比如弹出一个文字提示）
发送全局消息/TTS 反馈
模拟遥控器按键，通过 HID 报文控制眼镜（方向、返回、音量）
把这些交互过程写入数据库，能分页查看记录
一句话：它就是你要做“手机+眼镜”协同应用时的起跑线。项目代码地址已经在github上了，这里感谢作者的代码样例：https://github.com/StudiousXiaoYu/RokidDemo
安装环境（Windows）#
这个环节很关键，基本所有“构建失败”“设备不识别”的坑都和环境有关。
安装Kotlin#
由于整个项目代码环境是Kotlin环境，我们先本地IDE中安装好相关插件。
image
安装 Android Studio 和 OpenJDK 11#
查看是否有安装环境
winget search --source winget Android | Select-String -Pattern "Android Studio|SDK|Platform Tools|OpenJDK"
image
安装OpenJDK.11
winget install -e --id Microsoft.OpenJDK.11 --accept-source-agreements --accept-package-agreements
image
安装AndroidStudio
winget install -e --id Google.AndroidStudio --accept-source-agreements --accept-package-agreements
image
安装PlatformTools
winget install -e --id Google.PlatformTools --accept-source-agreements --accept-package-agreements
image
自此基本环境就安装完成了。
安装 Android SDK 组件#
确保安装这些：
Android SDK Platform 36（匹配项目 compileSdk 36）
Android SDK Build-Tools 35（或兼容版本）
Android SDK Platform-Tools（包含 adb）
Android SDK Command-line Tools (latest)（方便命令行管理）
启动Android SDK Studio后，我们进入设置页找到“SDK Tools”，找到相关的工具，点击下载即可，如图所示：
image
真机调试准备#
手机开启“开发者选项”和“USB 调试”。
image
第一次连接时，手机会弹窗问是否允许 USB 调试，请选择允许并勾选“始终允许”。
Windows 某些设备会缺驱动，装 Google USB Driver。确保终端输入 adb devices 能看到设备。
项目技术细节#
这一节把工程先跑起来，跟着做就能过构建。 先做三步：设置 local.properties → 添加 Rokid 仓库 → 引入 client-m 依赖。
项目根目录有 local.properties，需要把 sdk.dir 指向你机器的 Android SDK 路径（常见是 C:\Users\你的用户名\AppData\Local\Android\Sdk）。
image
sdk.dir=C:\Users\yu\AppData\Local\Android\Sdk
仓库与依赖（Gradle）
在顶层加仓库，在模块里加依赖，然后点 Gradle Sync。
// settings.gradle
pluginManagement {
repositories {
gradlePluginPortal()
google()
mavenCentral()
maven { url 'https://maven.rokid.com/repository/maven-public' }
}
}
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
google()
mavenCentral()
maven { url 'https://maven.rokid.com/repository/maven-public' }
}
}
// app/build.gradle
android {
defaultConfig {
minSdk = 28
}
}
dependencies {
implementation("com.rokid.cxr:client-m:1.0.1-20250812.080117-2")
}
检查：sdk.dir 路径有效，依赖能解析，Sync 无报错。
Manifest 权限与特性（Android 12+）#
先把这些权限加到 AndroidManifest.xml，Android 12+ 还需要在运行时申请。
<uses-feature android:name="android.hardware.bluetooth_le" android:required="true" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" android:maxSdkVersion="30" />
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
蓝牙相关权限在连接前先申请；前台服务能避免进程被系统回收。
构建与安装#
现在把包编译到真机上。 前置条件：adb devices 显示设备为 device。
windows的命令脚本已经在项目里了。
构建 Debug 包：
.\gradlew.bat assembleDebug -x lint
安装到设备：
.\gradlew.bat installDebug
启动入口 Activity：
adb shell am start -n com.blue.armobile/com.blue.glassesapp.feature.init.InitActivity
首次进入会弹权限提示，请授予存储与通知权限以免初始化阻塞。
image
添加相关的权限后，我们就可以正常进入手机端的应用界面了，如图所示：
image
