Cocos2d-x 安装

准备工具

• 操作系统：Windows10
• Python
• 安卓三大件
• IDE：WebStorm

环境监测

$ python -V
Python 2.7.17

$ java -version
java version "1.8.0_231"
Java(TM) SE Runtime Environment (build 1.8.0_231-b11)
Java HotSpot(TM) Client VM (build 25.231-b11, mixed mode)

$ ant -version
Apache Ant(TM) version 1.9.15 compiled on May 10 2020

$ gcc --version
gcc (i686-posix-dwarf-rev0, Built by MinGW-W64 project) 8.1.0
Copyright (C) 2018 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

Apache Ant

http://ant.apache.org/bindownload.cgi

Apache Ant是将Java软件编译、测试、部署等步骤联系在一起的自动化工具，Ant实现的功能类似于Linux中的make编译Linux内核及命令的项目管理工具。

Ant是Apache软件基金会Jakarta目录的一个子项目，优点是

• 跨平台
  Ant使用Java编写因此具有很好的跨平台性
• 操作简单
  Ant由内置任务和可选任务组成，使用Ant任务类似在dos中编写命令行一样。
  Ant运行时需XML构建文件，Ant通过调用target树执行各种task任务，每个task任务是实现特定接口的对象。
• 维护简单
  Ant构建文件使用XML格式，容易维护。

下载解压后，将Ant根路径作为环境变量配置系统变量。

ANT_HOME=D:\android\apache-ant

新建系统变量

将Ant目录下的bin目录添加到系统环境变量path中

D:\android\apache-ant\bin

Ant源文件结构

文件夹	描述
bin	程序运行入口
etc	存放xsl输出模板
lib	存放Ant程序所以来的JAR包
manual	Ant程序的帮助文档

Android NDK

https://developer.android.google.cn/ndk/downloads/

Android NDK全称Native Development Kit是Android的原生开发套件，又被称为Google的NDK。NDK能够在Android应用中使用C和C++代码，并提供众多平台库，可使用平台库管理原生Activity和访问实体设备组件，如传感器和轻触输入等。

NDK用于开发C或C++动态库.so文件，自动将so和应用一起打包称为APK，即通过NDK在Android中使用JNI与本地代码（C或C++）交互。JNI即Java Native Interface，作用是通过Java本地接口能使Java程序调用C++代码。

Android开发中不再是纯粹的Java层开发，更多地会于C++结合，将一些重要的方法和行为以及私密性的东西放到C++中，当多人开发时，通常的做法是在Android项目中放入C++的动态库.so文件。

NDK进一步提升了设备性能以降低延迟，或运行计算密集型应用，比如游戏或物理模拟。另外，NDK可重复使用自己或其它开发者的C或C++库。

由于NDK编译代码时必须使用到make和gcc命令，所以首先需要搭建Linux环境，Cygwin是一个在Windows平台上运行UNIX模拟环境。

将NDK根目录添加到系统环境变量中

NDK_ROOT=D:\android\android-ndk

Cygwin

http://www.cygwin.com/

Cygwin是在Windows平台上运行类UNIX模拟环境，Cygwin是在Windows中添加了一个中间层 - 兼容POSIX的模拟层，并在此基础上构建了大量Linux-like的软件工具。

镜像地址

http://mirrors.aliyun.com/cygwin/

GCC官网并未提供Windows平台的二进制文件只提供了源代码，因此在Windows上安装GCC需使用Cygwin。Cygwin使用setup-x86_64.exe安装器，镜像选择阿里云的http://mirrors.aliyun.com/cygwin/。Cygwin默认最小化安装不包括GCC，如果需要使用gcc、g++、make、gdb工具，安装时需选择gcc-core、gcc-g++、make、gdb、binutils这五个包，这五个包都在Category下的Devel下。

安装包

安装完成后将setup-x86_64.exe保留下来，以后可用来它来继续添加包。

打开Cygwin64 Terminal客户端程序，输入gcc和make命令，查看是否已经安装成功。

$ cygcheck -c cygwin
Cygwin Package Information
Package              Version        Status
cygwin               3.1.5-1        OK


$ gcc -v
gcc version 8.1.0 (i686-posix-dwarf-rev0, Built by MinGW-W64 project)

$ make -v
GNU Make 4.3

Cygwin配置NDK，打开Cygwin家目录中的.bash_profile文件，追加ANDROID_NDK_ROOT环境变量。

目录NDK安装路径为 D:\android\android-ndk，Crgwin安装路径为D:\android\cygwin64，在Cygwin中配置NDK路径。

$ vim D:\android\cygwin64\home\Administrator\.bash_profile
ANDROID_NDK_ROOT=/cygdrive/d/android/android-ndk
export ANDROID_NDK_ROOT

Android SDK

https://www.androiddevtools.cn/

下载解压重命名为android-sdk后将其添加到系统环境变量中

ANDROID_SDK_ROOT=D:\android\android-sdk

Cocos2dx

https://cocos2d-x.org/download

cocos-2d-js使用JS语言可发布到Web平台，IDE可选用WebStorm。

安装配置好安卓三大件后，进入Cocos2dx根目录运行setup.py安装脚本。

$ python .\setup.py

安装成功后查询是否已经安装成功

$ cocos --version
cocos2d-x-4.0
Cocos Console 2.3

配置Cocos命令行工具到系统环境变量

COCOS_CONSOLE_ROOT=D:\cocos\cocos2d-x-4.0\tools\cocos2d-console\bin

编译运行

$ cocos compile -p web|ios|android|mac
$ cocos run -p web|ios|android|mac

Cocos2d-x

https://www.cocos.com/cocos2dx

Cocos2d-x 是一套成熟的开源跨平台游戏开发框架。引擎提供了图形渲染、GUI、音频、网络、物理、用户输入等丰富的功能，被广泛应用于游戏开发及交互式应用的构建。其核心采用 C++ 编写，支持使用 C++、Lua 进行开发。Cocos2d-x 适配 iOS、Android、Windows 和 Mac 系统，功能侧重于原生移动平台，并向 3D 领域延伸扩展。

下载最新cocos-2dx引擎，为什么不使用creator，由于cocos-2dx采用c++开发，可控性和性能更好，可以做比较大型的游戏。creator使用js作为开发语言，性能相比较差，但操作简单，适合做小型游戏。

Cocos2d-x 允许开发人员使用 C++、Javascript 及 Lua 三种语言来进行游戏开发。无论您用 C++、JavaScript 还是 Lua 语言进行游戏开发，只需要下载这一个引擎。支持所有常见平台，包括 iOS、Android、Windows、macOS、Linux。

创建工程

$ cocos new --help
$ cocos new project_name

命令参数	描述
-p	设置工程包名
-d	设置工程存放路径
-t	设置模板名称
-e	设置引擎路径
-l	设置编程语言，可选cpp、lua、js。
--portrait	设置工程为竖屏
--ios-bundleid	设置工程的iOS Bundle ID
--mac-bundleid	设置工程的MAC Bundle ID

注意Cocos2dx-4.0已经去除JS绑定，也就无法使用JS模板创建项目。