【亲测免费】 开源项目 `awesome-CocosCreator` 使用教程

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

awesome-CocosCreator/
├── assets/
│   ├── animations/
│   ├── materials/
│   ├── prefabs/
│   ├── scenes/
│   ├── scripts/
│   ├── sounds/
│   ├── textures/
│   └── ...
├── build/
├── library/
├── local/
├── settings/
├── temp/
├── packages/
├── docs/
├── README.md
├── project.json
└── tsconfig.json

• assets/: 存放游戏资源，包括动画、材质、预制体、场景、脚本、声音和纹理等。
• build/: 构建生成的文件存放目录。
• library/: 项目库文件，包含导入的资源和元数据。
• local/: 本地配置文件。
• settings/: 项目设置文件。
• temp/: 临时文件目录。
• packages/: 扩展包存放目录。
• docs/: 项目文档存放目录。
• README.md: 项目说明文件。
• project.json: 项目配置文件。
• tsconfig.json: TypeScript 配置文件。

2. 项目的启动文件介绍

项目的启动文件通常是 project.json 中指定的主场景文件。例如：

{
  "engineVersion": "2.4.3",
  "initScene": "assets/scenes/MainScene.fire",
  "name": "awesome-CocosCreator",
  "id": "com.example.awesome-CocosCreator",
  "version": "1.0.0",
  "orientation": "landscape",
  "packageName": "com.example.awesome-CocosCreator"
}

• initScene: 指定项目启动时加载的主场景文件路径。

3. 项目的配置文件介绍

project.json

project.json 是项目的主要配置文件，包含项目的基本信息和启动设置：

{
  "engineVersion": "2.4.3",
  "initScene": "assets/scenes/MainScene.fire",
  "name": "awesome-CocosCreator",
  "id": "com.example.awesome-CocosCreator",
  "version": "1.0.0",
  "orientation": "landscape",
  "packageName": "com.example.awesome-CocosCreator"
}

• engineVersion: 指定使用的 Cocos Creator 引擎版本。
• initScene: 指定项目启动时加载的主场景文件路径。
• name: 项目名称。
• id: 项目唯一标识符。
• version: 项目版本号。
• orientation: 项目运行时的屏幕方向。
• packageName: 项目的包名。

tsconfig.json

tsconfig.json 是 TypeScript 的配置文件，用于编译 TypeScript 代码：

{
  "compilerOptions": {
    "module": "commonjs",
    "target": "es5",
    "outDir": "./built",
    "strict": true,
    "esModuleInterop": true
  },
  "include": [
    "assets/scripts/**/*"
  ]
}

• compilerOptions: 编译选项，包括模块系统、目标 ECMAScript 版本、输出目录等。
• include: 指定需要编译的 TypeScript 文件路径。

以上是 awesome-CocosCreator 项目的基本使用教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望对您有所帮助！