记忆卡片游戏:翻的是牌,练的是状态管理
记忆卡片游戏:翻的是牌,练的是状态管理
今天看的是记忆卡片游戏,也就是记忆翻牌。之前写的几篇里,天气模板的数据是假的,菜谱模板把数据分了三层,计算器模板教的是组件怎么拆,语音助手干的活其实是朗读。这个记忆卡片游戏跟它们又不一样——它教的不是某个功能,是状态管理:三档难度下的牌面状态、翻牌动画、按难度记的最佳纪录,全摊在一个小游戏里。规则简单到三句话能说完,但状态一点不少。
先看它是什么
记忆翻牌是个老游戏:桌上扣着一堆牌,每次翻两张,图案一样就配对消除,不一样就翻回去,全部配完算赢。练的是记忆力,教的是状态。
这个案例挂在鸿蒙开发实践中心。仓库是公开仓,不用账号就能 clone。根目录有 README.md,真正的工程在 harmony_app/,不是仓库根;文档在 docs/ 里,编译参数、环境变量这些写在 docs/BUILD.md 里。案例文档写的是 compile API 24(6.1.1),目标与兼容 API 23(6.1.0)。Star 185(11 月 16 日晚上核对时)。仓库是 MIT 开源,当前版本 v1.0.0,最后验证于 2026-08-25,测试设备是 HarmonyOS 模拟器 6.1.0(23)。
牌面不依赖任何图片素材:6 种几何形状 × 8 种高对比颜色,由 Canvas 向量路径实时生成。难度分三档:简单 4×4=16 张,中等 4 列 × 5 行=20 张,困难 6×6=36 张,牌数随难度递增。
玩法三句话,状态全在里面
第一句,翻两张:点一张翻开,再点一张翻开。
第二句,配对消除,不配对翻回去:两张牌面一样就配对消除,消除是淡出缩放(matchOpacity 1→0 + animScale 1→0.8);不一样就停留 900 毫秒后翻回去。这个“等一下”是 900 毫秒——时间太短玩家记不住,太长又拖节奏。
第三句,配完算赢:所有对子都配完,这一局结束。
状态怎么拆,是这个案例最值得看的地方。牌面用 Grid + ForEach 渲染,逻辑集中在 model/GameLogic.ets(洗牌、发牌、计时格式化)。README 的状态表里列的是游戏状态(牌面 / 锁定 / 计时),排障表里还提到一把叫 isLocked 的动画锁——锁没释放,卡片就点不动。翻牌动画是 .rotate() 绕 Y 轴旋转 + .animation() 隐式驱动,不是旧的 TransitionEffect 写法。
难度也能切,纪录按难度独立记:只记最佳用时和最少步数,用 Preferences 持久化。页面编排、状态管理、持久化,这条链路是完整的,但每个环节只留最必要的代码。
先把工程跑起来
看案例之前,先把工程跑起来。按 README 和 docs/BUILD.md 的步骤:
公开仓直接 clone,不用账号。注意真正的工程在 harmony_app/,不是仓库根,别在根目录里找编译入口。
harmony_app/local.properties 里的 sdk.dir 要指向真实 SDK 目录。这个文件已入 .gitignore,DevEco Studio 每次打开工程都可能改写它,编译前先确认一遍。
进到 harmony_app/,设置好环境变量再跑:
hvigorw assembleHap --no-daemon --mode module -p product=default -p module=entry@default --console=plain
出来的是 harmony_app/entry/build/default/outputs/default/entry-default-unsigned.hap(约 380KB)。装到设备上:
hdc install -r harmony_app/entry/build/default/outputs/default/entry-default-unsigned.hap
README 的启动方式是点模拟器里的「记忆翻牌」App 图标;如果装完桌面没刷新图标,docs/BUILD.md 里给了备用命令:
hdc shell aa start -b com.harmonypractice.memorycardgame -a EntryAbility
看日志用 hdc hilog | grep CardGame。
版本对不上会报错,先分清是哪个错:00303217 是环境变量没设对(DEVECO_SDK_HOME/NODE_HOME/JAVA_HOME/PATH);sdk.dir 被改写对应的是另一个错 00308018。
README 没说的,别替它说
有几件事 README 没写清楚,我也不替它编。
第一,.ets 文件到底多少个:步骤里说包含 17 个 ArkTS 源文件,目录树具名列出的却是 16 个,entryability/ 目录下没列文件名,两处数字在 README 里对不上。工程只有一个 entry 模块,这点是明确的。
第二,DevEco Studio 具体版本号:README 没给,只写了 DevEco Studio + command-line-tools(hvigor 6.x)。
第三,语言占比:README 正文没写。仓库页侧边栏显示 ArkTS 88.01%,那不是 README 的内容。
第四,牌面状态在代码里到底怎么存:README 只写了渲染用 Grid + ForEach、逻辑在 model/GameLogic.ets,没写数组结构;isLocked 也只在排障表里出现一次,没展开讲它什么时候锁、什么时候放。
我没有自己跑过这个 App,以上都是按 README 和 docs/BUILD.md 写的。
小结
- 这是记忆翻牌模板:翻两张,配对消除,不配对 900 毫秒后翻回去,配完算赢;翻的是牌,练的是状态管理。
- 牌面是 6 种几何形状 × 8 种高对比颜色,Canvas 实时生成,不用图片;难度三档,16 / 20 / 36 张牌;纪录只记最佳用时和最少步数,按难度独立存。
- 最值得学的是状态的拆法:Grid + ForEach 渲染,翻牌动画
.rotate()+.animation(),配对淡出缩放,isLocked这把锁没放开就点不动卡片。 - 跑起来之前先对版本:compile API 24(6.1.1),目标与兼容 API 23(6.1.0);
local.properties里sdk.dir指对;报错先分清是00303217还是00308018。 .ets文件数 README 自己都没对上(17 个还是 16 个),DevEco 具体版本和语言占比也没写。我没有自己跑过这个 App,以上都是按 README 和docs/BUILD.md写的。
案例仓库:https://gitcode.com/harmony-practice-center/HarmonyOS-APP-memory-card-game
- 点赞
- 收藏
- 关注作者
评论(0)