#AppGallery Connect #端云一体化实战项目

端云一体化开发工程由端开发工程（Application）和云开发工程（CloudProgram）两大核心模块构成。

1）端开发工程目录结构

端开发工程主要用于开发应用端侧的业务代码，通用云开发模板的端开发工程目录结构如下图所示：

• AppScope > app.json5：应用的全局配置信息。

• cloud_objects：用于存放云对象的端侧调用接口类，

• entry：应用/服务模块，编译构建生成一个HAP。

  • src > main > ets：用于存放ArkTS源码。

    • entryability：应用/服务的入口。

    • pages：包含了云存储、云数据库和云函数页面。

  • src > main > resources：用于存放应用/服务模块所用到的资源文件，如图形、多媒体、字符串、布局文件等。

  • src > main > module.json5：Stage模型模块配置文件，主要包含HAP的配置信息、应用在具体设备上的配置信息以及应用的全局配置信息。

  • build-porfile.json5：当前的模块信息、编译信息配置项，包括buildOption、targets配置等。

  • hvigorfile.ts：模块级编译构建任务脚本。

  • oh-package.json5：描述三方包的包名、版本、入口文件（类型声明文件）和依赖项等信息。

• oh_modules：用于存放三方库依赖信息，包含应用/服务所依赖的第三方库文件。

• build-profile.json5：应用级配置信息，包括签名、产品配置等。

• hvigorfile.ts：应用级编译构建任务脚本。

• oh-package.json5：描述全局配置，如：依赖覆盖（overrides）、依赖关系重写（overrideDependencyMap）和参数化配置（parameterFile）等。

2）云开发工程目录结构

在云开发工程中，开发者可以开发应用所需的云端业务逻辑代码，包括云函数和云数据库服务代码。

• clouddb：云数据库目录，包含数据条目目录（dataentry）和对象类型目录（objecttype）。

  • dataentry：用于存放数据条目文件。该目录下一般会根据开发者选择的云开发模板预置数据条目示例文件。通用云开发模板工程中，该目录下会预置名为d_Post.json的数据条目示例文件，内含两条示例数据。

  • objecttype：用于存放对象类型文件。该目录下一般会根据开发者选择的云开发模板预置对象类型示例文件。通用云开发模板工程中，该目录下会预置名为Post.json的对象类型示例文件，内含对象类型Post的权限、索引、字段名称和字段值等。

  • db-config.json：模块配置文件，主要包含云数据库工程的配置信息，如默认存储区名称、默认数据处理位置。

• cloudfunctions：云函数目录，包含各个云函数/云对象子目录。每个子目录下包含云函数/云对象的配置文件、入口文件、依赖文件等。该目录下一般会根据开发者选择的云开发模板预置示例函数。通用云开发模板工程下预置了一个用于生成UUID的示例云函数id-generator。

  • id-generator：云函数目录。

    • function-config.json：函数配置文件，可在triggers下配置触发器，通过触发器暴露的触发条件来实现函数调用。

    • idGenerator.ts：函数入口文件。

    • package.json：依赖配置文件。

• node_modules：工程同步时执行npm install生成，包含typescript和@types/node公共依赖。

• cloud-config.json：云开发工程配置文件，包含应用名称与ID、项目名称与ID、启用的数据处理位置、支持的设备类型等。

• package.json：定义了typescript和@type/node公共依赖。

• package-lock.json：工程同步时执行npm install生成，记录当前状态下实际安装的各个npm package的具体来源和版本号。