Nextcloud Contacts 项目教程

1. 项目的目录结构及介绍

Nextcloud Contacts 项目的目录结构如下：

nextcloud/
├── apps/
│   └── contacts/
│       ├── appinfo/
│       ├── css/
│       ├── img/
│       ├── js/
│       ├── l10n/
│       ├── lib/
│       ├── templates/
│       ├── tests/
│       └── vendor/
├── autoload.php
├── CHANGELOG.md
├── CODE_OF_CONDUCT.md
├── composer.json
├── CONTRIBUTING.md
├── LICENSE
├── README.md
└── webpack.config.js

目录结构介绍

• apps/contacts/: 这是 Nextcloud Contacts 应用的主要目录，包含了应用的所有代码和资源文件。
  • appinfo/: 包含应用的元数据文件，如 app.php 和 info.xml。
  • css/: 包含应用的样式表文件。
  • img/: 包含应用的图像资源。
  • js/: 包含应用的 JavaScript 文件。
  • l10n/: 包含应用的本地化文件。
  • lib/: 包含应用的核心逻辑和库文件。
  • templates/: 包含应用的模板文件。
  • tests/: 包含应用的测试文件。
  • vendor/: 包含应用的依赖库。
• autoload.php: 自动加载文件，用于加载应用的类和库。
• CHANGELOG.md: 项目变更日志。
• CODE_OF_CONDUCT.md: 项目的行为准则。
• composer.json: Composer 配置文件，定义了项目的依赖关系。
• CONTRIBUTING.md: 贡献指南。
• LICENSE: 项目许可证。
• README.md: 项目介绍和使用说明。
• webpack.config.js: Webpack 配置文件，用于前端资源打包。

2. 项目的启动文件介绍

Nextcloud Contacts 应用的启动文件主要位于 apps/contacts/appinfo/ 目录下。

主要启动文件

• app.php: 这是应用的主入口文件，负责初始化应用并加载必要的依赖。
• info.xml: 包含应用的基本信息，如名称、版本、作者等。

启动流程

1. app.php: 当 Nextcloud 启动时，会加载 app.php 文件，初始化应用并注册必要的路由和事件监听器。
2. info.xml: Nextcloud 会读取 info.xml 文件，获取应用的基本信息并进行验证。

3. 项目的配置文件介绍

Nextcloud Contacts 应用的配置文件主要位于 apps/contacts/ 目录下。

主要配置文件

• composer.json: 定义了应用的依赖关系和自动加载规则。
• webpack.config.js: 配置前端资源的打包规则。

配置文件介绍

• composer.json:

  • require: 定义了应用所需的 PHP 依赖库。
  • autoload: 定义了自动加载规则，包括 PSR-4 命名空间映射。

• webpack.config.js:

  • entry: 定义了前端资源打包的入口文件。
  • output: 定义了打包后的输出路径和文件名。
  • module: 定义了不同类型文件的加载器规则。

通过这些配置文件，Nextcloud Contacts 应用能够正确地加载依赖、打包前端资源，并提供必要的功能。