cocos2d-x 3.0rc开发指南：Windows下Android环境搭建

Google为Android开发人员提供了ADT(Android Developer Tools)。里面包括了SDK和Eclipse。

下载地址是：http://developer.android.com/sdk/index.html
能够选择32位或64位版本号。我选择的是32位版的，把它解压到一个文件夹，我这里是：d:\adt-bundle-windows-x86\。文件夹结构例如以下：

--<adt-bundle-windows-x86>
--<eclipse>
--<sdk>
--SDK Manager.exe

下载地址是：http://developer.android.com/tools/sdk/ndk/index.html
相同有32位和64位版可选，我选择的是32位版的，把它解压到adt同文件夹下。如今adt的文件夹结构例如以下：

--<adt-bundle-windows-x86>
--<eclipse>
--<sdk>
--<android-ndk-r8e>
--SDK Manager.exe

ANT是为了自己主动构建Android程序用。

下载地址是：http://ant.apache.org/bindownload.cgi
我选择的是：apache-ant-1.9.3-bin.zip，相同解压到adt文件夹下，如今adt的文件夹结构例如以下：

--<adt-bundle-windows-x86>
--<eclipse>
--<sdk>
--<android-ndk-r8e>
--<apache-ant-1.9.3>
--SDK Manager.exe

下载地址：https://www.python.org/ftp/python/2.7.3/python-2.7.3.msi

原来下载了最新的版本号。使用setup.py的时候发现有语法错误。所以最好使用2.7.3版本号，亲測过没有问题

把这个路径加到path环境变量中，当我们在cmd下输入python，出现以下字样。就说明设置环境变量正确了：

C:\Users\arlin>python
Python 2.7.3 (default, Apr 10 2012, 23:31:26) [MSC v.1500 32 bit (Intel)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>>

眼下最新版本号是3.0RC，下载地址是：http://cocostudio.download.appget.cn/Cocos2D-X/3.0RC0/cocos2d-x-3.0rc0.zip
下载完解压到一个地方。我这里：f:\cocos2dx\cocos2d-x-3.0rc0\

cc须要以下几个环境变量，用于后面的新建project，构建project等：

这几个环境变量是通过cocos2d-x根文件夹下的setup.py来配置的，我们启动cmd。执行setup.py：
F:\cocos2dx\cocos2d-x-3.0rc0>setup.py

此时脚本须要我们提供NDK。SDK，ANT的路径，我们依据之前放的路径输入就是了，整个命令步骤例如以下：

Setting up cocos2d-x...

-> Adding COCOS2D_CONSOLE_ROOT environment variable... OK
-> Added: COCOS_CONSOLE_ROOT = F:\cocos2dx\cocos2d-x-3.0rc0\tools/cocos2d-cons
ole/bin

-> Looking for NDK_ROOT envrironment variable... NOT FOUND
Please enter its path (or press Enter to skip): d:\adt-bundle-windows-x8
6\android-ndk-r8e
ADDED
-- Added: NDK_ROOT = d:\adt-bundle-windows-x86\android-ndk-r8e

-> Looking for ANDROID_SDK_ROOT envrironment variable... NOT FOUND
Please enter its path (or press Enter to skip): D:\adt-bundle-windows-x8
6\sdk
ADDED
-> Added: ANDROID_SDK_ROOT = D:\adt-bundle-windows-x86\sdk

-> Looking for ANT_ROOT envrironment variable... NOT FOUND
Please enter its path (or press Enter to skip): d:\adt-bundle-windows-x8
6\apache-ant-1.9.3\bin
ADDED
-> Added: ANT_ROOT = d:\adt-bundle-windows-x86\apache-ant-1.9.3\bin

Set up successfull:
COCOS_CONSOLE_ROOT was added into registry
NDK_ROOT was added into registry
ANDROID_SDK_ROOT was added into registry
ANT_ROOT was added into registry

Please restart the terminal or restart computer to make added system variables t
ake effect

命令最后提示我们重新启动终端或者重新启动系统，以让这些环境变量生效。一般我们关闭cmd和资源浏览器即可了，假设后面遇到环境变量找不到的错误，直接重新启动系统试试吧。
要測试环境变量是否生效，又一次打开cmd。输入以下命令查看。正常应该是这样：

F:\cocos2dx\cocos2d-x-3.0rc0>set NDK_ROOT
NDK_ROOT=d:\adt-bundle-windows-x86\android-ndk-r8e

F:\cocos2dx\cocos2d-x-3.0rc0>set ANT_ROOT
ANT_ROOT=d:\adt-bundle-windows-x86\apache-ant-1.9.3\bin

F:\cocos2dx\cocos2d-x-3.0rc0>set ANDROID_SDK_ROOT
ANDROID_SDK_ROOT=D:\adt-bundle-windows-x86\sdk

F:\cocos2dx\cocos2d-x-3.0rc0>set COCOS_CONSOLE_ROOT
COCOS_CONSOLE_ROOT=F:\cocos2dx\cocos2d-x-3.0rc0\tools/cocos2d-console/bin

我们要用tools\cocos2d-console这个工具来新建project，这个工具提供了以下几个功能：

new 创建一个新的project
compile 编译当前project，生成二进制文件，个人认为写为build更贴切一些。
deploy 公布程序到一个平台
run 编译和公布，和执行程序

我们如今仅仅用到new。让我们看看new提供了哪些參数。打到cmd，输入：
cocos new --help

得到以下帮助：

usage: cocos new [-h] [-p PACKAGE_NAME] -l {cpp,lua,js} [-d DIRECTORY]
[-t TEMPLATE_NAME] [--no-native]
[PROJECT_NAME]

创建一个新project

必要參数：
PROJECT_NAME project名

可选參数:
-h, --help 显示帮助信息
-p PACKAGE_NAME, --package PACKAGE_NAME
设置包名。如com.colin.mbgame
-l {cpp,lua,js}, --language {cpp,lua,js}
使用的主要语言，能够是：[cpp | lua | js]
-d DIRECTORY, --directory DIRECTORY
project所在的文件夹
-t TEMPLATE_NAME, --template TEMPLATE_NAME
要创建的project模板名

lua/js project參数:
--no-native No native support.

如今我们在cmd中输入：

F:\cocos2dx>cocos new mygame1 -p com.colin.mbgame -l cpp -d f:\cocos2dx\mbgame

得到以下输出：

F:\cocos2dx>python F:\cocos2dx\cocos2d-x-3.0rc0\tools\cocos2d-console\bin\/cocos.py
new mygame1 -p com.colin.mbgame -l cpp -d f:\cocos2dx\mbgame
Runing command: new
> Copy template into f:\cocos2dx\mbgame\mygame1
> Copying cocos2d-x files...
> Rename project name from 'HelloCpp' to 'mygame1'
> Replace the project name from 'HelloCpp' to 'mygame1'
> Replace the project package name from 'org.cocos2dx.hellocpp' to 'com.colin.mbgame'

这表明我们已经成功创建一个project，到f:\cocos2dx\mbgame\看看，project文件夹结构例如以下：
--<mygame1>
--<Classes>
--<cocos2d>
--<proj.android>
--<proj.ios_mac>
--<proj.linux>
--<proj.win32>
--<Resources>
--.cocos-project.json
--CMakeLists.txt

能够看到各种平台下的project都创建出来了。同一时候它把cocos2d整个框架都拷贝过来了，这样的好坏就见仁见智了。

同一时候是用到cocos2d-console。这里要用的是compile这个命令，在cmd输入以下查看帮助：
f:\cocos2dx\mbgame\mygame1>cocos compile --help

usage: cocos compile [-h] [-s SRC_DIR] [-q] [-p PLATFORM] [-m MODE] [-j JOBS]
[--ap ANDROID_PLATFORM] [--source-map]

把当前project编译为二进制

可选參数:
-h, --help 显示帮助信息
-s SRC_DIR, --src SRC_DIR
project根文件夹，比方上面应该是f:\cocos2dx\mbgame\mygame1
假设不设，就为当前文件夹（cmd定位到的那个文件夹）
-q, --quiet less output
-p PLATFORM, --platform PLATFORM
选择一个平台 android|ios|mac|web|win32|linux
-m MODE, --mode MODE 编译模式 debug|release, 默觉得debug.
-j JOBS, --jobs JOBS 半行编译，假设你有4核。能够设为4。

Android Options:
--ap ANDROID_PLATFORM
指定SDK版本号？没试过。不敢枉下定论，保留英文：
parameter for android-update.Without the parameter,the
script just build dynamic library for project. Valid
android-platform are:[10|11|12|13|14|15|16|17|18|19]

Web Options:
--source-map Enable source-map

如今我们在cmd输入：

F:\cocos2dx\mbgame\mygame1>cocos compile -p android -j 4

BUILD SUCCESSFUL

Total time: 7 seconds

Move apk to F:\cocos2dx\mbgame\mygame1\bin\debug\android

build succeeded.

我们到f:\cocos2dx\mbgame\mygame1\proj.android\bin\，能够看到mygame1-debug.apk，说明构建完毕。

我把它安装到手机上试跑，发现好像启动速度是快了非常多，不知是不是心理作用。

第一次会提示设置工作区，你能够设置工作区放在哪里。我这里为了演示就默认了。

Unable to execute dex: java.nio.BufferOverflowException

后来在网上查了一下，发现是Android SDK Build tools的BUG，把它升级到19.0.3后就好了：打开SDK Manager。找到19.0.3的Android SDK Build Tools，安装之。