企业官网建设流程全解析

真正连在一起、做互动、做协同的基线工程。你能在它里边看到：

扫描发现 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