快应用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

  • 这是项目说明文档,主要介绍目录结构、命令和模板用途。
相关推荐
用户83352502537852 小时前
ViewModel详细解析
android
问心无愧05132 小时前
ctf show web入门91
android·前端·笔记
YF02112 小时前
Android App 高效升级指南:OkDownload 多线程断点续传与全版本安装适配
android·okhttp·app
huangliang07032 小时前
MySQL 中的 distinct 和 group by 哪个效率更高?
android·数据库·mysql
程思扬2 小时前
Android 悬浮窗状态错乱终极解决方案:告别 onResume
android·网络
逸Y 仙X3 小时前
文章二十九:ElasticSearch分桶聚合
android·大数据·elasticsearch·搜索引擎·全文检索
陆业聪3 小时前
网络监控与容灾:让网络问题无处遁形
android·性能优化·启动优化
问心无愧05133 小时前
ctf show web入门 89
android·前端·笔记
高旭的旭3 小时前
Android Perfetto Profilers Skills 简明使用指南
android