Cocos2d-x 结合Box2D开发Android游戏配置方法

cocos2d 游戏引擎和 Box2D 物理引擎都是什么，干什么用的，这里我就不多废话了。这里主要讲的是基于 C++ 的 cocos2d-x 在 Android 系统上开发游戏时如何与 Box2D 物理引擎结合。
 

 
 
 

          首先简单介绍一下我这里所使用的环境，其他环境的配置方法也是大同小异的。

 
 
 
 

                  操作系统：Archlinux

 

                  cocos2d-x 版本：cocos2d-0.99.5-x-0.8.5

 
 
 
 

          先通过 create-android-project.sh 脚本创建一个新的 cocos2d-x for android 工程。注意，在执行该脚本前需要先对该脚本进行编辑，来设定 NDK_ROOT 和 ANDROID_SDK_ROOT 两个变量的值（在该脚本文件的最前面几行）。NDK_ROOT 变量用来指定你计算机上 android ndk 的安装位置；ANDROID_SDK_ROOT 变量用来指定你计算机上 android sdk 的安装位置。

 
 
 
 

          工程建立完毕后，会在和 create-android-project.sh 同目录下看到你刚刚新建的工程文件夹。这里我们假设我们刚刚建立了一个名为 Box2DTest 的工程。则工程目录机构如下：

 
 
 
 

                  Box2DTest

 

                          --android

 

                          --Classes

 

                          --Resource

 
 
 
 

          Classes 文件夹下主要是 C++ 源代码文件，该文件夹是你主要编写逻辑的地方。Resource 文件夹是资源文件，例如图片素材、音效文件等资源文件都必须放到这个文件夹下面。当然，这篇日志不是讲 cocos2d-x 入门。而是讲怎样在 cocos2d-x 中使用 Box2D，所以这里我们主要要看的是 android 文件夹。

 
 
 
 

          android 文件夹下面是个标准的 android 工程。通过 Eclipse 可以方便的将该工程导入并运行。当我们编写完毕我们的 C++ 代码后通过执行 android 文件夹下的 build_native.sh 脚本，可以将我们编写的 C++ 代码连同 cocos2d-x 引擎以及其他一些库编译成 so 文件，以供 android 程序通过 jni 调用它们。

 
 
 
 

          默认的 cocos2d-x for android 工程并没有将 Box2D 物理引擎库引入到工程中。如果我们想要在我们的程序中使用 Box2D 引擎，我们需要对编译脚本进行一些设置。首先我们看看一个默认的 cocos2d-x for android 工程都有哪些编译脚本。

 
 
 
 

                  Box2DTest

 

                          --android

 

                                  --jni

 

                                          --Android.mk

 

                                          --Application.mk

 

                                          --helloworld

 

                                                  --Android.mk

 
 
 
 

          mk 文件是 Android NDK 所使用的 make file 。一个标准的 cocos2d-x for android 工程默认有三个 mk 文件，这三个文件在编译 C++ 代码时起到重要的作用。而要在自己的工程中使用 Box2D 物理引擎，则需要对这三个 mk 文件进行编辑，否则无法编译通过。

 
 
 
 

          首先是 Box2DTest/android/jni/Application.mk 文件。这里我们需要关注的是 APP_MODULES 这个变量，这个变量后面的值是指定我们需要编译的模块的名称。默认是这样的：

 
 
 
 

                  APP_MODULES := cocos2d cocosdenshion game

 
 
 
 

          这里我们需要将 Box2D 模块加入，这样在编译 C++ 代码是，会将 Box2D 模块编译成为 so 库文件。加入后是这样的：

 
 
 
 

                  APP_MODULES := cocos2d box2d cocosdenshion game

 
 
 
 

         然后是 Box2DTest/android/jni/Android.mk 文件。这个文件我们需要检查 subdirs 这个变量。这个变量的值是指定一些公共库的头文件的目录位置。在这个变量中我们需要确保将 Box2D 的库目录放入了其中。加入后完整的 subdirs 变量的赋值语句是这样的：

 
 
 
 

                  subdirs := $(addprefix $(LOCAL_PATH)/../../../,$(addsuffix /Android.mk, \

 

                                Box2D \

 

                                cocos2dx \

 

                                CocosDenshion/android \

 

 
 
 
 

          接下来是 Box2DTest/android/jni/helloworld/Android.mk 文件。在这个文件中我们主要编辑 LOCAL_C_INCLUDES 变量。该变量指定我们 C++ 源代码中 include 的头文件的查找位置。默认的 LOCAL_C_INCLUDES 赋值是这样的：

 
 
 
 

                  LOCAL_C_INCLUDES := $(LOCAL_PATH)/../../../../cocos2dx \

 

                      $(LOCAL_PATH)/../../../../cocos2dx/platform \

 

                      $(LOCAL_PATH)/../../../../cocos2dx/include \

 

                      $(LOCAL_PATH)/../../../../CocosDenshion/include \

 

                      $(LOCAL_PATH)/../../../Classes 

 
 
 
 

          默认的  LOCAL_C_INCLUDES 并没有将 Box2D 的头文件目录加入进去，在这种情况下我们在自己的 C++ 源代码中引入 Box2D 的话是无法编译通过的。简便的方法是加入下面两个路径：

 
 
 
 

                  LOCAL_C_INCLUDES := $(LOCAL_PATH)/../../../../cocos2dx \

 

                      $(LOCAL_PATH)/../../../../cocos2dx/platform \

 

                      $(LOCAL_PATH)/../../../../cocos2dx/include \

 

                      $(LOCAL_PATH)/../../../../CocosDenshion/include \

 
$(LOCAL_PATH)/../../../..  \
 
                     $(LOCAL_PATH)/../../..
 

                      $(LOCAL_PATH)/../../../Classes 

 
 
 
 

          最后还要在 Box2DTest/android/jni/helloworld/Android.mk 文件中的 LOCAL_LDLIBS 变量上加入下面这个值：

 
 
 
 

                  LOCAL_LDLIBS := -L$(call host-path, $(LOCAL_PATH)/../../libs/armeabi) \

 

                  -lcocos2d -llog -lcocosdenshion \

 
 -lbox2d \
 

                  -L$(call host-path, $(LOCAL_PATH)/../../../../cocos2dx/platform/third_party/android/libraries) -lcurl

 
 
 
 

          加入这两个路径之后，我们要想在我们的 C++ 源代码中引入 Box2D 库的话，只需要在 C++ 源代码中加入这样的语句就可以了。

 
 
 
 

                  #include  "Box2D/Box2D.h"

 
 
 
 

           这样我们就可以在享受 cocos2d 引擎给我们带来的开发便利的同时享受到 Box2D 物理引擎给我们带来的开发乐趣了。