PhoneTrack 项目启动与配置教程

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

PhoneTrack 是一个用于追踪和存储移动设备位置信息的 Nextcloud 应用程序。以下是项目的目录结构及各部分的简要介绍：

• /.github/：包含项目的 GitHub 工作流程文件，用于自动化测试和构建等。
• /appinfo/：包含应用的元数据文件，如 app.php 用于定义应用的入口点和基本信息。
• /css/：存放应用所需的样式表文件。
• /doc/：包含项目文档，如 README.md 和其他相关文档。
• /img/：存放应用所需的图片资源。
• /l10n/：包含应用的本地化文件，用于多语言支持。
• /lib/：包含项目核心库文件，实现应用的主要功能。
• /src/：存放应用的主要源代码文件。
• /templates/：包含应用的模板文件，用于生成前端页面。
• /tests/：包含测试脚本和测试用例，确保代码质量。
• /translationfiles/：存放应用的翻译文件。
• /AUTHORS.md：记录项目的所有贡献者。
• /CHANGELOG.md：记录项目的历史更新和变更。
• /CONTRIBUTING.md：提供贡献指南，帮助新贡献者了解如何参与项目。
• /COPYING：包含项目的 AGPL-3.0 许可证文本。
• /README.md：项目的主 README 文件，提供项目描述和安装指南。
• /composer.json 和 composer.lock：PHP 项目的依赖管理文件。
• /crowdin.yml：用于 Crowdin 翻译平台配置的文件。
• /makefile：Makefile 文件，用于自动化构建和部署任务。
• /package-lock.json 和 package.json：Node.js 项目的依赖管理文件。
• /phpunit.xml：PHPUnit 配置文件，用于设置 PHP 单元测试。
• /psalm.xml：Psalm 配置文件，用于静态代码分析。
• /stylelint.config.cjs：样式检查工具配置文件。
• /vite.config.ts：Vite 配置文件，用于配置前端构建工具。
• /webpack.js：Webpack 配置文件，用于前端打包。

2. 项目的启动文件介绍

PhoneTrack 应用的启动主要依赖于 Nextcloud 的框架。以下是几个关键的启动文件：

• appinfo/app.php：这是应用的入口点文件，定义了应用的名称、描述、版本和权限等信息。
• src/Controller/PageController.php：这是控制器文件，用于处理 HTTP 请求并返回相应的页面。

在 Nextcloud 环境中，当用户访问 PhoneTrack 应用的页面时，Nextcloud 会自动加载这些文件，并启动应用。

3. 项目的配置文件介绍

PhoneTrack 应用的配置主要通过以下几个文件进行：

• config/config.php：这是 PhoneTrack 应用的主要配置文件，用于定义应用级别的配置，如数据库连接信息、API 密钥等。
• .env：环境变量文件，用于设置环境特定的配置，如开发环境和生产环境的区分。
• psalm.xml：用于配置 Psalm 静态代码分析工具的规则和设置。
• stylelint.config.cjs：样式检查工具的配置文件，用于定义 CSS 样式的编码标准。

在配置应用时，开发者需要根据具体环境调整这些文件中的配置项，以确保应用能够正确运行。