Harmonyos Game Generator

HarmonyOS 游戏生成器

自动生成 MVVM 架构的鸿蒙元服务游戏，支持任意游戏主题。

工作流程

用户输入游戏主题
    ↓
1. 创建 MVVM 目录结构
    ↓
2. 生成基础代码框架 (5次迭代)
    ↓
3. 根据主题定制游戏逻辑
    ↓
4. 编译验证
    ↓
5. 部署到模拟器
    ↓
6. 初始化 Git 并推送到 GitHub

快速开始

# 用户请求示例
"帮我创建一个贪吃蛇鸿蒙游戏"
"创建一个俄罗斯方块元服务"

执行步骤:

1. 生成游戏框架

python3 $SKILL_DIR/scripts/generate_game.py <项目路径> --theme <游戏主题>

参数说明:

• 项目路径: HarmonyOS 元服务工程根目录
• --theme/-t: 游戏主题 (snake, tetris, breakout, flappy, runner, shooter 或任意主题)
• --name/-n: 游戏名称 (可选)

2. 完善游戏逻辑

根据游戏主题，完善以下内容:

• 游戏实体 (Model层)
• 游戏引擎逻辑 (ViewModel层)
• 渲染器绘制 (View层)

参考 references/game-patterns.md 了解不同游戏类型的核心机制。

3. 编译部署

python3 $SKILL_DIR/scripts/build_and_deploy.py <项目路径>

4. Git 和 GitHub

python3 $SKILL_DIR/scripts/git_setup.py <项目路径> --name <游戏名称>

MVVM 架构

详细架构说明见 references/mvvm-architecture.md

entry/src/main/ets/
├── common/
│   ├── constants/GameConstants.ets    # 游戏常量
│   └── utils/MathUtils.ets            # 工具函数
├── model/
│   ├── entities/                       # 游戏实体
│   └── repository/ScoreRepository.ets  # 分数持久化
├── viewmodel/
│   ├── GameEngine.ets                  # 游戏引擎
│   └── GameViewModel.ets               # 状态管理
├── view/
│   ├── pages/                          # 页面
│   └── components/GameRenderer.ets     # 渲染器
└── pages/Index.ets                     # 入口页

迭代开发

采用小步快跑，5次迭代:

游戏类型参考

见 references/game-patterns.md，包含:

• 飞行/跳跃类 (FlappyBird)
• 贪吃蛇类
• 俄罗斯方块类
• 打砖块类
• 射击类
• 跑酷类
• 卡片匹配类

脚本说明

依赖

• DevEco Studio (提供 hvigorw, hdc 工具)
• GitHub CLI (gh 命令)
• Python 3.7+