夜雨聆风学习资料网

ARTICLE · 1193025

Cubedesk智能魔方练习手机版顺利上线

Cubedesk智能魔方练习手机版顺利上线

下载地址(安卓 APK,直接安装):

https://github.com/Jay6668/CubeDesk-Releases/releases/tag/android-v0.1.13(无法访问可后台领取)

手机系统要 Android 8.0 以上;第一版只适配我测评用的魔域 V10 AI 普通版(就是不带陀螺仪那颗)。同一个签名的旧版可以直接覆盖安装,不用卸载。

一句话,它是干嘛的

CubeDesk 的手机版。

关注
重播 分享 赞

连上蓝牙智能魔方,你手上怎么转,手机屏幕里的 3D 魔方就跟着怎么转。

停手自动记成绩,想练有 CFOP 专项训练,想复盘有数据分析,破了纪录还能放段特效。

起因:电脑上那套,想带在身上

之前我给自己写了一套 Windows 版的 CubeDesk,一直在用。

但有个尴尬的地方:练魔方这件事,本来就不该被绑在电脑前。坐地铁、躺床上、随手拧两把,这些场景跟电脑没关系。

所以我想把它搬到手机上。

手机上长什么样

入口跟电脑版一样是四个:分析、训练、竞速、计时。

入口
管什么
竞速
连智能魔方,边拧边实时同步,自动计时记成绩
计时
普通计时,加五次一轮的比赛模拟
训练
CFOP 专项训练,分阶段训练和公式训练
分析
成绩趋势、稳定性、转动效率、练习记录

训练页进去是两张卡:阶段训练、公式训练。

数据分析在手机上是两列排布,八个指标一眼看完。

横屏的时候,左边指标、右边图表,一屏装得下。

一个特色功能:荣誉系统

这块电脑版就有,手机上原样搬了过来,也是我最舍不得砍的一块。

破个人最佳、破月纪录、破周纪录,或者连续拧够 N 次、累计拧够 N 次,都能绑一段特效。

破纪录那一下,视频铺满整屏,放完接一张专属成绩卡,再回到真实成绩。

竖屏看横版视频,上下留白,不裁不压。

横屏就居中铺满,比例不一样就把多出来的两边裁掉。

库里有 36 项素材。同一局只放一个主特效,副荣誉一起记账但不抢戏。

说白了,就是自己奖励自己。没人给你发奖牌,那怎么给自己发一块?自己做一个放映厅。

前面是功能。下面这些,才是这轮真正花时间的地方。

两天半,打了 14 个包

从第一个能跑的包,到别人手里这个 0.1.13,中间隔了大概两天半,一共 14 个版本。

不是因为加了 14 次功能,是因为手机上踩的坑,一个比一个具体。

你看到的怪现象
真正的原因
点进竞速,屏幕上却是公式训练
手机样式强制设了 display,把页面的 hidden 盖掉了。路由是对的,渲染是错的
页面下面明明有内容,就是划不动
HTML 和 BODY 同时成了滚动容器,BODY 又把滚动传递掐断了
视频四周一圈黑边
应用整体被刘海安全区挤小,视频又被弹窗的宽度和内边距夹住
特效在放,但没声音
音量滑块的初始化顺序错了:先填 0.45,再设范围和步长,浏览器按默认整数步长把值规整成了 0
成绩后面总跟着省略号
为了紧凑一行塞了四张统计卡,数字被截断。改成两列
手机已经锁了竖屏,应用还跟着转
配置里写的是 fullSensor,它会忽略系统的旋转锁定
点开应用,首页还没进去就闪退
全屏设得太早,Android 的窗口视图还没建好,读窗口控制器时空指针

七个里,最典型的是两个。

一个是「点竞速却进了公式训练」。

这类 bug 最难查的地方在于:逻辑全对,结果全错。

路由算出来该去哪一页,算得没错。真正的问题是手机那套样式强制写了 display,把「隐藏」那个状态盖住了。

所以后来往检查里加了一条:隐藏的页面,是不是真的隐藏了。

另一个是闪退。 一版打出来,点开就退,连首页都进不去。我把手机插上电脑,开 USB 调试,读崩溃日志,才定位到是初始化顺序的问题:先建内容视图,再做窗口操作就好了。

但比这个修复值钱的,是它换来的规矩。

打包成功,就算做完了吗?不算。打包成功之后,还得看它在真机上怎么启动、怎么显示、怎么响应。

怎么在电脑上检查手机里的应用

后来调试主要走两条路。

ADB 管手机原生层:装包、读日志、截真实屏幕、发点击和滑动、控制方向。

WebView 调试连接管界面内部:通过 Chrome DevTools Protocol 读真实手机页面的结构、样式、状态、滚动位置和视频进度。

所以你如果在检查记录里看到有些步骤「没有真的点屏幕」,那是在读运行时的真实状态;需要验手势的时候,再让手机实际接收触摸。

每次检查前还会先确认一件事:手机当前前台是哪个应用、是不是正在计时。别把正在进行的一局搅了。

更新的时候,成绩一条没丢

手机里已经存着训练记录,更新不能把它们冲掉。

流程是先备份应用数据,对已有的非日志文件算一遍 SHA256;然后用同样的包名和签名覆盖安装;第一次启动前再读一次,比对是否一致。

0.1.12 更新那次,11 个已有文件的哈希完全一致。全程没有卸载应用,没有清空成绩。

后来还把电脑里的 16 条成就规则迁进了手机,按素材资源 ID 一一对应,手机原有的成就历史保留。个人规则没有打进公开的 APK。

几句真话

这版验证过
这版没验证
vivo X100 / Android 16 上 8 个页面 × 横竖屏 = 16 个状态
其他机型兼容性
多个实际滚动区域、成就视频、旋转衔接
长时间运行
覆盖安装前后 11 个文件哈希一致
耗电
声音我本人听过,确认有声音
—

只保证测过的东西。 上面左边那栏是真跑过的,右边那栏我没测,就不吹。

源码没开源。 GitHub 上那个仓库是下载用的,只有说明和校验和。

第一版只适配一颗魔方。 就是我测评用的那颗魔域 V10 AI 普通版,不带陀螺仪,后续会持续更新。

数字精度跟电脑版一致。 成绩显示两位小数,内部还是原始毫秒,PB、平均和成就判断沿用同一套算法。

写在最后

回到标题:我把那套智能魔方软件搬到了手机上,装个 APK 就能用。

从「能装、能连」,到「入口清楚、内容看得清、手指够得着、数据不会丢」,第一版才算站住。

你平时练什么?有没有哪个工具,是那种「电脑上很好用、一到手机上就废」的? 评论区聊聊。

相关学习资料