快应用day2项目架构


这个目录是一个典型的快应用示例工程,可以分成三类看:源码、构建产物、工具配置。

1. src/:真正的源码,平时主要改这里

  • src/assets: 静态资源。
    • images/: 图片资源。
    • styles/: 样式资源。
      • variables.less: 变量,比如颜色、尺寸。
      • mixins.less: 混入方法,复用样式片段。
      • style.less: 全局样式入口,页面里经常 @import 它。
  • src/CardDemo/index.ux: 快应用卡片示例,属于可单独发布/展示的组件式页面。
  • src/helper: 工具封装区。
    • src/helper/apis: 业务接口定义层,把具体 API 地址集中管理。
    • src/helper/utils.js: 通用工具,比如 showToast、拼接 query 参数。
    • src/helper/ajax.js: 网络请求封装,把底层 @system.fetch 包成 Promise 风格。
  • src/pages: 页面目录。你看到的每个页面一般都有自己的 index.ux。
  • src/pages/Demo/index.ux: 入口示例页。
  • src/pages/DemoDetail/index.ux: 详情页。
  • src/app.ux: 应用入口文件。这里会做全局初始化,比如把工具方法挂到全局对象上,方便各页面直接用。
  • src/manifest.json: 应用配置文件。里面定义包名、版本、图标、权限、路由、页面标题等。
  • src/sitemap.json: 页面规则配置。主要用于页面可访问性、搜索/收录相关规则。

2. build/:编译后的输出,不是你主要编辑的地方

  • build/assets: 编译/拷贝后的静态资源。
  • build/pages: 页面编译后的 JS。
  • build/app.js: 编译后的应用脚本。
  • build/manifest.json: 构建后生成的配置结果。

一般来说,build/ 是 hap build 或 IDE 自动生成的结果,不建议手改,因为下次构建会覆盖。

3. dist/:最终产物,通常用于发布/安装

  • dist/com.example.demo.debug.1.0.0.rpk
  • dist/com.example.demo.debug.1.0.0.rpks

这是打包后的快应用安装包。发布、安装、调试时会用到。

4. scripts/:辅助脚本

  • scripts/gen/index.js: 生成新页面的脚本。
  • scripts/gen/template.ux: 新页面模板。
  • scripts/selfCloseInputTag.js: 格式化辅助脚本,处理标签闭合之类的细节。

5. 配置和依赖

  • .gitignore: Git 忽略规则。
  • .prettierignore: Prettier 忽略规则
  • .quickapp.preview.json: 预览相关配置。
  • package-lock.json: 依赖锁定文件,保证安装版本一致。
  • package.json: 项目脚本、依赖、格式化规则、husky/lint-staged 配置都在这里。
  • .ide/settings.json: IDE 的项目设置。
  • node_modules: 第三方依赖安装目录,通常不手动改。

6. README.md

  • 这是项目说明文档,主要介绍目录结构、命令和模板用途。
相关推荐
海水冷却35 分钟前
Android 群组聊天怎么实现:基于 ZIM 的完整落地指南(附可运行 Demo)
android
三少爷的鞋3 小时前
现代 Android 架构指南:不要再主动设计 Callback 接口
android
TimeFine9 小时前
AI 编码工作流的设计
android·ai编程
骑着蜗牛撵大象32710 小时前
C++20 协程 × 屏障:手写一个 co_await 版 Barrier,让等待不再钉死线程
android·c++20·协程·并发编程·co_await·屏障同步
山东孙燕姿11 小时前
设备台账重构:从一张表到三层模型
android·java·网络·低代码·重构·rxjava
蒸鱼Yuzheng12 小时前
移动端 CPU 调度分析:线程亲和性、大小核迁移与卡顿
android·perfetto·性能分析·线程优化·cpu调度
booboosui12 小时前
安卓唤醒词:12 维 MFCC 加 DTW,阈值 1.8
android
传奇开心果12 小时前
Compose Multiplatform 共享边界实战:架构契约、互操作同步与可回退设计
android·kotlin
事圆则缓13 小时前
从开机到首帧:Android 系统与应用启动流程源码分析
android
AI吃大瓜13 小时前
指针压力表读数4:Android实现指针压力表读数(可实时检测)
android·指针读数·指针压力表·压力表·压力表读数