# dongyun_studio **Repository Path**: hndg/dongyun_studio ## Basic Information - **Project Name**: dongyun_studio - **Description**: dongyun_studio - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-01-15 - **Last Updated**: 2026-01-15 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 冬云工作室 - 鸿蒙APP ## 项目简介 冬云工作室是一款专注于"关爱未成年人成长"的鸿蒙原生应用，基于鸿蒙SDK 5.0.5开发。应用提供法治教育、心理辅导、案例分析、法律法规查询等全方位服务，为青少年、教师、家长和检察官提供专业的未成年人保护平台。 ## 功能特性 ### 核心功能模块 1. **首页** - 功能入口聚合 - 工作室品牌展示 - 活动轮播图 - 8大核心功能入口 - 活动公告推送 2. **关于我们** - 工作室介绍 - 工作室简介 - 团队荣誉展示 - 发展历程时间轴 - 联系方式 3. **案例报告** - 典型案例库 - 多分类案例浏览（民事/刑事/校园纠纷） - 关键词搜索功能 - 案例详情展示 4. **教育视频** - 视频资源 - 分类视频库（预防教育/未检宣传/法治教育等） - 视频播放功能 - 收藏功能 5. **法律法规** - 法律库 - 8类法律分类展示 - 法条关键词搜索 - 法条详情页 - 相关案例关联 6. **帮教平台** - 在线服务 - 心理咨询预约 - 帮扶需求提交 - 在线答疑 - 常见问题FAQ 7. **活动募集** - 活动管理 - 线下活动报名 - 线上征集（作品/志愿者） - 活动状态跟踪 8. **心理测试平台** - 专业测评 - 抑郁/焦虑量表 - 成长潜能测试 - 个性化测试报告 9. **校园链接** - 校园合作 - 校园动态展示 - 法治课程安排 - 校际活动信息 10. **用户体系** - 账户管理 - 登录/注册（支持手机号、第三方登录） - 角色分类（青少年/教师家长/检察官） - 个人中心 - 活动记录/测试报告/收藏/咨询历史 ## 技术栈 - **开发语言**: ArkTS - **API版本**: API 9 (兼容API 9及以上) - **开发工具**: DevEco Studio 5.0.5+ - **最低系统版本**: HarmonyOS 3.0 - **目标系统版本**: HarmonyOS 4.0+ ## 项目结构 ``` dongyun_studio/ ├── entry/ # 主模块 │ ├── src/ │ │ └── main/ │ │ ├── ets/ │ │ │ ├── entryability/ # 应用入口 │ │ │ │ └── EntryAbility.ts │ │ │ └── pages/ # 页面文件 │ │ │ ├── Index.ets # 首页 │ │ │ ├── AboutUs.ets # 关于我们 │ │ │ ├── CaseReport.ets # 案例报告 │ │ │ ├── EducationVideo.ets # 教育视频 │ │ │ ├── LawRegulations.ets # 法律法规 │ │ │ ├── HelpPlatform.ets # 帮教平台 │ │ │ ├── ActivityCollection.ets # 活动募集 │ │ │ ├── PsychologyTest.ets # 心理测试 │ │ │ ├── SchoolLink.ets # 校园链接 │ │ │ ├── LoginPage.ets # 登录页面 │ │ │ ├── PersonalCenter.ets # 个人中心 │ │ │ ├── LawDetail.ets # 法律详情 │ │ │ └── VideoPlayer.ets # 视频播放 │ │ └── resources/ │ │ └── base/ │ │ ├── element/ # 资源定义 │ │ │ ├── string.json │ │ │ └── color.json │ │ ├── media/ # 媒体资源 │ │ ├── profile/ # 配置文件 │ │ │ └── main_pages.json │ │ └── common/ # 公共资源 │ │ ├── images/ │ │ └── icons/ │ ├── build-profile.json5 # 构建配置 │ └── module.json5 # 模块配置 ├── app.json5 # 应用配置 ├── build-profile.json5 # 构建配置 └── README.md # 说明文档 ``` ## 开发环境要求 ### 必需工具 1. **DevEco Studio 5.0.5+** - 下载地址：https://developer.harmonyos.com/cn/develop/deveco-studio - 请选择5.0.5或更高版本 2. **HarmonyOS SDK** - API Level 9 或更高版本 - 在DevEco Studio中通过SDK Manager安装 3. **Node.js** (用于某些构建工具) - 推荐版本：14.x 或更高 ### 系统要求 - **Windows**: Windows 10/11 (64位) - **macOS**: macOS 10.15+ - **Linux**: Ubuntu 18.04+ (官方支持) ## 快速开始 ### 1. 下载并安装DevEco Studio 访问[HarmonyOS开发者官网](https://developer.harmonyos.com/cn/develop/deveco-studio)下载并安装DevEco Studio 5.0.5。 ### 2. 配置HarmonyOS SDK 1. 启动DevEco Studio 2. 进入 `Tools` > `SDK Manager` 3. 安装以下组件： - HarmonyOS SDK (API Level 9+) - Node.js - Previewer ### 3. 打开项目 1. 启动DevEco Studio 2. 选择 `File` > `Open` 3. 选择项目根目录（包含app.json5的目录） 4. 等待项目索引和依赖下载完成 ### 4. 配置模拟器或连接真机 #### 方案A：使用本地模拟器 1. 进入 `Tools` > `Device Manager` 2. 点击 `New Emulator` 3. 选择设备类型（推荐：Phone） 4. 选择系统镜像（HarmonyOS 4.0+） 5. 启动模拟器 #### 方案B：使用真机调试 1. 启用手机的**开发者选项** 2. 开启**USB调试** 3. 通过USB连接电脑 4. 在DevEco Studio中选择该设备 ### 5. 运行应用 1. 在DevEco Studio顶部工具栏，选择目标设备 2. 点击绿色运行按钮（▶️）或按 `Shift + F10` 3. 等待应用安装和启动 ### 6. 预览页面（可选） 1. 在页面文件上右键 2. 选择 `Preview` 3. 在右侧预览窗口中查看页面效果 ## 开发指南 ### 添加新页面 1. 在 `entry/src/main/ets/pages/` 目录下创建新的 `.ets` 文件 2. 在 `resources/base/profile/main_pages.json` 中注册页面路径 示例： ```json { "src": [ "pages/Index", "pages/YourNewPage" ] } ``` ### 添加资源文件 #### 图片资源 - 将图片放入 `resources/base/media/` 目录 - 在代码中使用 `$r('app.media.filename')` 引用 #### 颜色资源 - 在 `resources/base/element/color.json` 中定义颜色 - 在代码中使用 `$r('app.color.color_name')` 引用 #### 字符串资源 - 在 `resources/base/element/string.json` 中定义字符串 - 在代码中使用 `$r('app.string.string_name')` 引用 ### 页面导航 使用鸿蒙路由API进行页面跳转： ```typescript import router from '@ohos.router'; // 跳转到新页面 router.pushUrl({ url: 'pages/YourPage', params: { key: 'value' } }); // 返回上一页 router.back(); // 替换当前页面 router.replaceUrl({ url: 'pages/AnotherPage' }); ``` ### UI组件使用 项目使用了ArkTS声明式UI开发范式，主要组件包括： - `Column`: 垂直布局容器 - `Row`: 水平布局容器 - `Stack`: 层叠布局容器 - `Grid`: 网格布局 - `List`: 列表 - `Scroll`: 滚动容器 - `Tabs`: 标签页 - `Button`: 按钮 - `Text`: 文本 - `Image`: 图片 - `TextInput`: 文本输入框 更多组件请参考[官方文档](https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/arkts-ui-overview-0000001427744840-V3)。 ## 配置说明 ### app.json5 - 应用配置 应用的基本配置信息： - `bundleName`: 应用包名 - `version`: 版本号 - `apiVersion`: API版本要求 ### module.json5 - 模块配置 模块级配置： - `name`: 模块名称 - `abilities`: 能力配置（页面、服务等） - `requestPermissions`: 权限申请 - `pages`: 页面路径配置 ### build-profile.json5 - 构建配置 构建相关配置： - `apiType`: 编译模式（stageMode） - `targets`: 构建目标 ## 权限说明 当前应用申请的权限： ```json { "name": "ohos.permission.INTERNET" // 网络访问 } ``` ## 常见问题 ### Q: 编译时提示API版本不匹配？ A: 请确保 `app.json5` 中的 `apiVersion` 设置正确，并且DevEco Studio已安装对应的SDK版本。 ### Q: 模拟器无法启动？ A: 检查以下几点： 1. 确认系统虚拟化已启用（BIOS设置） 2. 检查是否安装了系统镜像 3. 尝试重启DevEco Studio ### Q: 页面预览不显示？ A: 1. 确保使用的是 `.ets` 文件（ArkTS） 2. 检查页面代码是否有语法错误 3. 尝试重启预览窗口 ### Q: 真机调试失败？ A: 1. 确认手机已开启USB调试 2. 检查USB连接是否稳定 3. 尝试更换USB线或USB接口 4. 在手机上确认授权USB调试 ## 后续优化建议 1. **功能完善** - 实现真实的网络请求 - 添加数据持久化存储 - 完善用户登录认证 - 添加推送通知功能 2. **性能优化** - 图片资源压缩和懒加载 - 列表虚拟化 - 减少页面渲染开销 3. **用户体验** - 添加更多动画效果 - 优化页面加载速度 - 完善错误提示 4. **测试** - 添加单元测试 - 进行UI自动化测试 - 兼容性测试 ## 技术支持 - **HarmonyOS开发者文档**: https://developer.harmonyos.com/cn/docs - **API参考**: https://developer.harmonyos.com/cn/docs/documentation/doc-references-V3/summary-0000001057365914-V3 - **DevEco Studio帮助**: https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/ide-overview-0000001051070714-V3 ## 许可证 本项目仅供学习和参考使用。 ## 联系方式 如有问题或建议，请联系项目维护者。 --- **冬云工作室 - 关注成长中的青少年**