# app_EasyRandom **Repository Path**: Yan_m233/app_EasyRandom ## Basic Information - **Project Name**: app_EasyRandom - **Description**: 随易app - **Primary Language**: TypeScript - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 3 - **Forks**: 3 - **Created**: 2024-08-12 - **Last Updated**: 2026-06-20 ## Categories & Tags **Categories**: Uncategorized **Tags**: ArkTS, HarmonyOS, next ## README # 🎲 随易 EasyRandom

随易应用图标      随易元服务图标

面向生活的随机工具箱 · 纯血鸿蒙原生应用

HarmonyOS API 18+ Version License

--- ## 📖 项目简介 > 随易是一款基于 **HarmonyOS NEXT（纯血鸿蒙）** 原生开发的日常生活随机工具箱应用。 > > 集成各个功能的工具箱，例如：抽签、掷骰子、丢硬币、随机数等。 > > 同时提供一些有趣的功能，例如：幸运转盘、真心话大冒险、答案之书、祝福木鱼等。 > > **目标**：打造一个覆盖手机、平板、折叠屏、车机、手表等多形态设备的全场景鸿蒙工具箱，充分利用 HarmonyOS 新特性（服务卡片、元服务、多设备协同等）。 --- ## ✨ 核心特性 | 特性 | 说明 | |------|------| | 🧩 **多设备适配** | 支持手机、平板、2in1、车机、手表（V0.0.1 已上线） | | 📱 **服务卡片** | 8 种桌面服务卡片，无需打开应用即可使用 | | 🔗 **元服务** | 提供轻量级元服务版本，即点即用 | | 🌐 **多语言** | 支持中文简体、English、部分支持 Japanese，其他语言适配中 | | 🌙 **暗夜模式** | 完整适配深色主题，支持手动切换暗色/亮色/跟随系统 | | 📐 **响应式布局** | 基于断点系统的自适应栅格布局 | | 🔒 **隐私合规** | 内置隐私政策弹窗，符合应用市场审核要求 | | 📊 **VitalUI 图表库** | 自研图表组件库（饼图、玫瑰图、雷达图等） | | 📳 **震动反馈** | 应用级震动管理开关，支持多种触觉反馈 | | 🔗 **应用分享** | 支持系统分享能力，快速分享应用 | --- ## 📸 特性预览 ### 多设备适配

主界面展示

### 暗夜模式 & 多语言

暗夜模式 多语言

### 服务卡片

硬币卡片

--- ## 🏗️ 技术架构 ### 技术栈 - **语言**：ArkTS（TypeScript 超集） - **UI 框架**：ArkUI（声明式 UI） - **SDK 版本**：HarmonyOS NEXT (API 18 / SDK 5.1.0) - **构建工具**：hvigor - **模块化方案**：HAP + HAR 多模块架构 ### 模块架构 ``` app_EasyRandom ├── product/default # 主入口模块 (HAP) — 手机/平板/2in1/车机 ├── product/wearable # 手表模块 (HAP) — 已发布 V0.0.1 ├── common/BasicUtils # 基础工具包 (HAR) — 日志、常量、随机算法、颜色转换 ├── common/SystemUtils # 系统能力封装 (HAR) — 震动、断点、API版本、分享 └── common/VitalUI # 图表组件库 (HAR) — 饼图、玫瑰图、雷达图、颜色选择器 ``` ### 依赖关系 ``` product/default ──→ @ohos/basic-utils, @ohos/system-utils, @ohos/vital-ui product/wearable ──→ @ohos/basic-utils SystemUtils ──→ BasicUtils (VibratorManager 使用 Logger) VitalUI ──→ (暂无依赖) BasicUtils ──→ (无依赖，最底层) ``` --- ## 📁 项目结构 ``` app_EasyRandom/ ├── AppScope/ # 应用全局配置 & 多语言资源 (base/en/ja/dark) ├── build-profile.json5 # 顶层构建配置（签名、产品、模块注册） │ ├── common/ # 共享库 — 3 个 HAR 静态共享包 │ ├── BasicUtils/ # @ohos/basic-utils — 日志/常量/全局上下文/随机算法 │ ├── SystemUtils/ # @ohos/system-utils — 震动/断点系统/API版本/分享 │ └── VitalUI/ # @ohos/vital-ui — 饼图/玫瑰图/雷达图/颜色选择器 │ ├── product/ # 产品层 — 2 个 HAP 入口模块 │ ├── default/ # 手机/平板/2in1/车机主入口 │ │ └── src/main/ │ │ ├── ets/ │ │ │ ├── entryability/ # 主 Ability（应用生命周期） │ │ │ ├── entrybackupability/ # 备份恢复 Ability │ │ │ ├── defaultformability/ # 服务卡片 Ability（数据同步枢纽） │ │ │ ├── pages/ # 主页面（Tab 根页面） │ │ │ │ ├── IndexPage/ # 首页 Tab 容器（HdsMainPage + LegacyMainPage） │ │ │ │ ├── RollPage/ # 转盘页面 + 编辑器/数据管理 │ │ │ │ ├── SettingPage/ # 设置页组（Navigation 导航，含 8 个子页） │ │ │ │ ├── AnswerPage.ets # 答案之书 │ │ │ │ ├── CardsPage.ets # 服务卡片展示 │ │ │ │ ├── MorePage.ets # 更多功能 │ │ │ │ ├── RandomPage.ets # 随机工具 │ │ │ │ └── ToolsPage.ets # 工具箱入口 │ │ │ ├── sub_pages/ # 15 个子功能页面（router 跳转） │ │ │ │ 含: 抛硬币/掷骰子/随机数/抽签/吃什么/颜色搭配/随机旅行/ │ │ │ │ ABCD选择器/答案之书/真心话大冒险/祝福木鱼/八卦占卜(含64卦)/ │ │ │ │ 手持弹幕/二维码转换/A标测试 │ │ │ ├── form_cards/ # 8 种服务卡片组件 │ │ │ ├── form_display/ # 卡片应用内预览展示（与 form_cards 一一对应） │ │ │ ├── static_datas/ # 5 个静态题库文件（答案/挑战/食物/名单/景点） │ │ │ ├── design_privew/ # UI 设计预览/测试页 │ │ │ └── utils/ # API 版本兼容工具 │ │ └── resources/ # 模块资源 + 路由/卡片配置 │ │ │ └── wearable/ # 手表模块 (HAP) — V0.0.1 已发布 │ └── src/main/ets/ │ ├── wearableability/ # 手表 Ability │ ├── wearablebackupability/ # 备份 Ability │ ├── pages/ # 手表首页 │ ├── sub_pages/ # 11 个手表功能子页面 + 圆/方屏导航面板 │ └── utils/ # 穿戴专用工具（转盘/屏幕/真心话数据） │ ├── docs/ # 项目文档 │ ├── INDEX.md # 项目索引（推荐从这里开始） │ ├── architecture.md # 工程架构文档 │ ├── 开发手册.md # 开发手册（命名/组件/路由/状态管理/代码审查） │ ├── tutorial_build_version.md # 构建版本号教程 │ ├── wearable-plan.md # 手表端实现方案 │ ├── wearable-page-impl.md # 穿戴页面实现 │ ├── wearable-sync-plan.md # 穿戴同步方案 │ ├── EasyRandom 分包分类管理规划.md # 分包重构规划 │ ├── api-update/ # API 12→13 / 12→18 升级追踪 │ └── feature-design/ # 功能设计文档（振动/转盘等） │ ├── preview/ # 应用预览截图 ├── build/ # 构建产物 (.hap / .app) └── hvigor/ # hvigor 构建脚本配置 ``` --- ## 🎯 功能模块 ### 🏠 首页 Tab | Tab | 名称 | 说明 | |-----|------|------| | 1 | 幸运转盘 | 自定义转盘抽奖，支持编辑轮盘项 | | 2 | 功能卡片 | 预览服务卡片效果，支持一键添加到桌面 | | 3 | 答案之书 | 默念问题，翻开属于你的答案 | | 4 | 工具箱 | 全部功能入口列表 | ### 🧰 工具箱功能 | 功能 | 状态 | 页面路径 | 说明 | |------|:----:|----------|------| | 🎡 幸运转盘 | ✅ | RollPage/RollWheelPage | 自定义轮盘抽奖，可视化编辑 | | 📖 答案之书 | ✅ | AnswerPage | 经典翻书式随机答案 | | 🎲 掷骰子 | ✅ | flip_dices/RollDices | 多骰子组合投掷 | | 🪙 丢硬币 | ✅ | flip_coin/FlipCoin | 硬币翻转动画 | | 🔢 随机数 | ✅ | random_numbers/RandomNumbers | 自定义范围随机数生成 | | 🍜 吃什么 | ✅ | random_foods/RandomFoods | 随机推荐美食 | | 🎨 颜色搭配 | ✅ | random_colors/RandomColors | 随机色彩搭配灵感 | | ✍️ 抽签 | ✅ | random_names/RandomNames | 自定义名单抽取 | | 🎯 真心话大冒险 | ✅ | honest_or_challenge/HonestOrChallenge | 双模式挑战 | | ☯️ 八卦占卜 | ✅ | devine_bagua/DevineBaGua | 传统八卦占卜 | | 🐟 祝福木鱼 | ✅ | blessing_muyu/BlessingMuyu_V2 | 敲击木鱼积累功德 | | 🌍 人生必去的100个地方 | ✅ | random_places/RandomPlaces | 旅行灵感随机推荐 | | 🔤 ABCD 选择器 | ✅ | random_abcd/RandomABCD | 快速四选一决策 | | 📱 手持弹幕 | ✅ | text_marquee/TextMarquee | LED 滚动字幕 | | 🔄 二维码转换 | ✅ | trans_qr/TransQR | 文字/链接转二维码 | | 🃏 抽卡 | 🚧 | — | 模拟抽卡体验 | | 🥢 圣杯 | 🚧 | — | 传统掷筊占卜 | | ☯️ 64卦 | 🚧 | — | 完整易经六十四卦 | | 📐 单位转换 | 🚧 | — | 多类型单位换算 | | 🧮 计算器 | 🚧 | — | 基础 / 科学计算器 | | 🔮 塔罗牌 | 🚧 | — | 塔罗牌占卜 | | 💱 进制转换 | 🚧 | — | 二/八/十/十六进制互转 | | 🐾 电子宠物 | 🚧 | — | 桌面电子宠物 | ### 🧩 服务卡片（桌面小组件） | 卡片 | 状态 | 尺寸 | 说明 | |------|:----:|:----:|------| | 🎲 骰子卡片 | ✅ | 2×2 | 点击投掷骰子 | | 🪙 硬币卡片 | ✅ | 2×2 | 点击抛硬币 | | 🎡 转盘卡片 | ✅ | 2×2 / 4×4 | 迷你幸运转盘 | | ☯️ 八卦卡片 | ✅ | 2×2 / 4×4 | 八卦占卜结果 | | 🎨 颜色卡片 | ✅ | 2×2 | 随机颜色展示 | | 🔤 ABCD 卡片 | ✅ | 2×2 | 四选一抽选 | | 🐟 木鱼卡片 | ✅ | 2×2 | 敲木鱼快捷入口 | | 🎯 真心话大冒险卡片 | ✅ | 2×2 | 桌面真心话大冒险 | | 🐾 电子宠物卡片 | 🚧 | 2×2 / 4×4 | 桌面养成互动 | --- ## 🗺️ 未来计划 - [x] 主页面 UI 重构 - [x] 液态玻璃效果适配 - [x] 震动反馈 - [x] 手表端 (wearable) V0.0.1 已发布 - [ ] 手表端更多功能完善 - [ ] 折叠屏深度适配 - [ ] PC 端 (2in1) 大屏适配 --- ## 🚀 快速开始 ### 环境要求 - **DevEco Studio**：5.0.0 及以上版本 - **HarmonyOS SDK**：API 18 (HarmonyOS NEXT 5.1.0) - **设备系统**：HarmonyOS NEXT 5.0.0+ ### 项目配置 - **应用包名**：`ydy.App.EasyRandom` - **元服务包名**：`com.atomicservice.5765880207854873613` ### 构建运行 ```bash # 1. 克隆项目 git clone https://gitee.com/Yan_m233/app_EasyRandom # 2. 使用 DevEco Studio 打开项目 # 3. 配置签名 # 4. 点击运行或使用命令行构建 hvigorw assembleHap ``` --- ## 📦 开源依赖备忘录 本项目参考到以下开源内容，特此致谢。 | 项目 | 版本 | 协议 | 用途 | |-----------------------------------------------------------------------------------------------|:------:|------------|--------------| | [@ohos/hypium](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/hypium-overview) | 1.0.18 | Apache 2.0 | 鸿蒙官方单元测试框架 | | [@ohos/hamock](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/hamock-overview) | 1.0.0 | Apache 2.0 | 鸿蒙官方 Mock 框架 | | BrakePoint 断点系统 | --- | --- | 华为开发者官网示例代码 | | Logger 日志系统 | --- | --- | 华为开发者官网示例代码 | --- ## 👥 开发团队 ### 软件开发 | 角色 | 成员 | |------|------| | 主程 / 架构 | 闫东阳 | ### 美术设计 | 角色 | 成员 | |------|------| | UI / UX 设计 | 岑纯阳、宋婷婷、王浩铭、王璞 | ### 测试 | 角色 | 成员 | |------|------| | 质量保证 | Sallauknoe、金浩翔、阿拉灯神丁 | --- ## 📬 联系我们 | 渠道 | 地址 | |------|------| | 📧 邮箱 | [3014551329@qq.com](mailto:3014551329@qq.com) | | 📺 B站 | [随易 EasyRandom 创作页](https://www.bilibili.com/opus/971320804050468900?spm_id_from=333.1387.0.0) | --- ## 📄 开源协议 本项目基于 [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0) 开源。 --- ## 🔗 相关链接 - **随易元服务**：应用内可跳转元服务版本（`com.atomicservice.5765880207854873613`） - **隐私政策**：应用内设置页可查看 ---

Built with ❤️ using HarmonyOS ArkTS | © 2024-2026 闫东阳