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

  • 这是项目说明文档,主要介绍目录结构、命令和模板用途。
相关推荐
Zhu7582 小时前
在k8s集群部署MySQL单实例,支持多个主流发行版
android·mysql·kubernetes
AFinalStone6 小时前
Android 7系统异常问题排查(四)Framework层(上)—System Server Watchdog
android·系统异常
宝杰X77 小时前
Android Room3 多平台数据库
android·数据库
huibin14785236910 小时前
热缓解学习记录
android·学习
小田的博客13 小时前
SAP MM 供应商银行主数据更新报错!message R1228!
android·java·服务器
一笑的小酒馆14 小时前
Android智能猫砂盆视频加载慢卡顿问题分析
android
只会cv的小前端16 小时前
七巧低代码服务端脚本使用方法
android·低代码·rxjava
16 小时前
Android 自定义 View 实战:从零打造工业级全向摇杆控件(OmniJoystickView)
android·kotlin·自定义view·摇杆控件
雨白16 小时前
深入理解 Kotlin 协程 (十一):以逸待劳,探秘 select 多路复用与并发安全策略
android·kotlin
hunterandroid18 小时前
[Android 从零到一] Android 深度链接与 App Links:从 URI Scheme 到可验证的应用跳转
android