Cocos2d-x Android 开发完整入门教程

第一部分：简介与环境准备

什么是 Cocos2d-x？

Cocos2d-x 是一个用 C++ 编写的开源、跨平台的 2D 游戏引擎，它支持 Windows, macOS, Linux, iOS, Android, Web 等多个平台，开发者使用 C++ 编写一次代码，就可以轻松地部署到多个平台上。

对于 Android Cocos2d-x 允许你使用 C++ 来开发游戏，这通常比纯 Java 或 Kotlin 开发游戏性能更高，尤其是在处理大量图形和物理计算时。

环境准备

在开始之前,你需要安装以下软件和工具：

• JDK (Java Development Kit): Cocos2d-x 的构建工具需要 Java 环境，推荐安装 JDK 8 或更高版本。
• Android Studio: Google 官方的 Android 开发 IDE，用于管理和构建 Android 项目。
• Android NDK (Native Development Kit): 这是 最关键 的一步，NDK 允许你使用 C/C++ 语言为 Android 平台开发原生代码，Cocos2d-x 就是通过 NDK 来编译 C++ 代码的。
  • 如何安装: 在 Android Studio 中，进入 Tools -> SDK Manager -> SDK Tools，勾选 NDK (Side by side) 和 CMake，然后点击 Apply 安装。
• Python 3: Cocos2d-x 的部分构建脚本需要 Python 3 的支持，推荐 Python 3.7 或更高版本。
• Cocos2d-x Creator: 这是一款图形化的 Cocos2d-x 开发工具，可以让你通过可视化界面创建场景、编写脚本（使用 TypeScript），并一键发布到包括 Android 在内的多个平台，对于新手来说，强烈推荐使用 Cocos Creator，因为它极大地简化了开发流程。

第二部分：使用 Cocos Creator 创建并发布 Android 项目 (推荐)

这是目前最主流、最简单的方式，我们将使用 Cocos Creator 创建一个项目，然后导出并构建为 Android APK。

步骤 1: 安装并启动 Cocos Creator

1. 从 Cocos 官网 下载并安装 Cocos Creator。
2. 启动 Cocos Creator。

步骤 2: 创建新项目

1. 在 Cocos Creator 的欢迎界面，点击 新建。
2. 选择一个模板（Hello World），输入项目名称（如 MyFirstGame），选择一个存放位置，然后点击 创建。

步骤 3: 熟悉编辑器界面

你会看到几个主要面板：

• 场景编辑器: 中间最大的区域，用于可视化地摆放你的游戏元素（节点）。
• 资源管理器: 左侧面板，显示你的项目文件，如脚本、图片、场景等。
• 属性检查器: 右侧面板，用于选中节点的属性（如位置、大小、颜色等）。
• 控制台: 底部面板，用于查看日志和错误信息。

步骤 4: 编写一个简单的脚本

1. 在 资源管理器 中，右键点击 assets 文件夹，选择 创建 -> TypeScript 脚本。

2. 将脚本命名为 GameLogic。

3. 双击 GameLogic.ts 文件，它会在代码编辑器中打开。

4. 修改代码,让屏幕上显示 "Hello, Cocos Creator on Android!"。

   
   （图片来源网络，侵删）

   // GameLogic.ts
   const { ccclass, property } = cc._decorator;
   @ccclass
   export class GameLogic extends cc.Component {
       // 在 onLoad 方法中编写初始化逻辑
       onLoad() {
           // 获取场景中的 Label 节点，假设你已经创建了一个并命名为 "myLabel"
           let label = this.node.getChildByName("myLabel");
           if (label) {
               let labelComponent = label.getComponent(cc.Label);
               if (labelComponent) {
                   labelComponent.string = "Hello, Cocos Creator on Android!";
               }
           }
       }
   }

注意: 你需要在场景中创建一个 Label 节点，并将其命名为 myLabel，否则上面的代码会找不到节点，或者，你也可以直接在代码中动态创建。

步骤 5: 将脚本挂载到节点上

1. 回到 场景编辑器。
2. 在 层级管理器 中，选中 Canvas 节点。
3. 在 属性检查器 中，点击 添加组件 -> 用户脚本 -> GameLogic。
4. GameLogic 脚本就和 Canvas 节点关联起来了。

步骤 6: 构建发布到 Android

1. 点击 Cocos Creator 编辑器右上角的 项目 -> 构建发布。
2. 在弹出的窗口中：
   • 选择平台: 勾选 Android。
   • 构建发布路径: 选择一个空文件夹，用于存放构建出来的 Android 项目。
   • 产品标识: 可以使用默认的 com.cocos.game，或者修改成你自己的包名。
   • 其他选项: 保持默认即可。
3. 点击 构建，Cocos Creator 会将你的项目代码和资源打包成一个标准的 Android 项目结构。

步骤 7: 在 Android Studio 中编译和运行

1. 打开 Android Studio。
2. 选择 Open an existing Android Studio project。
3. 找到上一步你设置的 构建发布路径，进入 build -> android 目录，然后选择并打开这个目录。
4. Android Studio 会开始同步和构建项目，首次打开可能需要下载一些 Gradle 依赖，会比较慢，请耐心等待。
5. 构建完成后,点击 Android Studio 顶部工具栏的绿色 Run 'app' 按钮（或按 Shift + F10）。
6. 在设备选择器中,选择一个已连接的 Android 设备或启动一个模拟器。
7. 几秒钟后,你的游戏就会在设备上运行起来，你应该能看到屏幕上显示 "Hello, Cocos Creator on Android!"。

第三部分：纯 Cocos2d-x C++ Android 项目 (进阶)

如果你需要直接使用 C++ 进行开发，或者想了解其底层原理，可以尝试这种方式，这种方式更复杂，需要手动配置。

步骤 1: 下载 Cocos2d-x 源码

从 Cocos2d-x 官网 下载最新的 Cocos2d-x 源码包（cocos2d-x-x.x.x.zip）。

步骤 2: 设置环境变量

将 Cocos2d-x 的路径添加到系统的 PATH 环境变量中，这样你就可以在命令行中直接使用 Cocos2d-x 的工具（如 cocos 命令）。

步骤 3: 使用命令行创建项目

打开命令行终端（Windows 下用 CMD 或 PowerShell，macOS/Linux 下用 Terminal），进入你想要创建项目的目录，然后运行：

# cocos new 命令用于创建新项目
# MyCppGame 是项目名
# -p com.mycompany.game 是包名
# -l cpp 指定使用 C++ 语言
# -d . 指定当前目录为项目根目录
cocos new MyCppGame -p com.mycompany.game -l cpp -d .

这会创建一个名为 MyCppGame 的文件夹，里面包含了完整的项目结构。

步骤 4: 导入项目到 Android Studio

1. 进入 MyCppGame 目录，然后进入 proj.android 目录。
2. 在这个目录下,你会发现有一个 build.gradle 文件，直接使用 Android Studio 打开这个 proj.android 目录。
3. 同样,Android Studio 会开始同步项目，这个过程可能很慢，因为它需要下载和配置大量的 NDK 和 CMake 依赖。
4. 同步完成后,你就可以在 Android Studio 中看到项目结构。

步骤 5: 编译和运行

1. 确保你已经连接了 Android 设备或启动了模拟器。
2. 在 Android Studio 顶部工具栏的设备选择器中选择目标设备。
3. 点击绿色的 Run 按钮。
4. 如果一切顺利,一个简单的 "Hello World" 场景就会运行在你的 Android 设备上。

步骤 6: 编写 C++ 代码

项目的核心代码在 MyCppGame Classes 目录下。

• HelloWorldScene.h: 场景的头文件，定义了类和成员。
• HelloWorldScene.cpp: �