Windows 8上搭建Cocos2d-x for Android的开发环境

一 、android平台工程创建

1、android SDK+NDK安装 （已经有Android与NDK环境的可以跳过该步骤 ）

1）、安装java jdk（如果已经安装了，可以不用此步骤）

进入：http://www.oracle.com/technetwork/java/javase/downloads/index.html 或者直接点击下载。如下图

选择JDK DOWNLOAD(android 开发无需JRE)

如果是32位windows 7选择Windows x86 ,64位windows 7选择Windows x64。

安装后，配置环境变量：

新建环境变量：JAVA_HOME 值为：D:\Program Files\Java\jdk1.7.0

新建环境变量：CLASSPATH  值为：.;%JAVA_HOME%\lib;（注意：点号表示当前目录，不能省略）

在系统变量Path的值的前面加入以下内容：%JAVA_HOME%\bin;(注意:这里的分号不能省略)到这里，JDK安装完毕。 

单击“开始”—>“运行”—>输入：cmd命令，在CMD窗口中输入：java -version  
出现如下界面，就表示安装成功：

2）、下载eclipse

进入以下页面：

http://www.eclipse.org/downloads/packages/

选择windows 32-bit 下载，解压后直接打开即可。

3）、安装android sdk和NDK

进入以下页面http://developer.android.com/sdk/index.html

或直接复制此地址下载：http://dl.google.com/android/installer_r18-windows.exe

打开installer_r18-windows.exe

安装时会检查jdk安装情况，如果没安装成功会失败的。

然后运行SDK Manager.exe 进行更新sdk（建议根据需要下载对应版本的sdk）。

点解install packages。完成后，为了方便，也配置下环境变量

新建环境变量：ANDROID_SDK 值为：G:\Android SDK\platforms;G:\Android SDK\tools（这个是SDK存放的位置）

在系统PATH环境变量种加入：%ANDROID_SDK%

单击“开始”—>“运行”—>输入：cmd命令，在CMD窗口中输入：adb -h

进入http://developer.android.com/tools/sdk/ndk/index.html 或点击直接下载

下载解压到E:\android-ndk-r8

Android NDK包含build、docs、samples、sources、GNUmakefile、ndk-build、ndk-gdb及readme等内容。

2、Cygwin安装

由于NDK开发大都涉及到C/C++在GCC环境下编译、运行，所以在Windows环境下，需要模拟Linux模拟编译环境，下载地址：

http://www.cygwin.com/

下载后是个setup.exe文件，使用过程如下：

第一步：运行setup程序，第一步图略，直接点击Next进入下一步。

第二步：选择安装方式，第一次可以采用Direct Connection在线下载安装，如有现成的离线包，可以选择离线安装（Install from Local Directory）。

第三步：选择安装目录，比如C:\Cygwin，注意此目录是指Cygwin最终的安装目录，不是下载文件暂存目录。

第四步：设置本地包暂存路径

暂存目录默认是放到setup.exe的同级目录下，下载后名字类似ftp%3a%2f%2fcygwin.mirrors.pair.com%2f这样格式。

第五步：设置网络连接方式

第六步：选择下载站点地址

起初尝试几个看哪个速度快就用哪个地址（如果感觉不快就点取消，再次来过）。

第七步：等待加载安装项载入，选择安装项

我们编译NDK，在默认设置下，只需选择Devel（点击列表中Devel，将后面的Default改为Install，图中箭头所示），其它均为默认状态。(其实NDK需要的不多，主要autoconf2.1、automake1.10、binutils、gcc-core、gcc- , g++、gcc4-core、gcc4-g++、gdb、pcre、pcre-devel、gawk、make )

第八步：等待下载完成

下载完成时间决定于你选择的安装包数量及网络连接速度，比如按照本文默认的选择方式，可能需要2-3个小时（视网速而定），下载后压缩包约1.2G，下载完成后会自动安装到上文设置的安装目录。

提醒：第一次下载完成后，最好把下载的包目录做个备份，下次安装同样的环境可以直接使用离线安装方式（第二步中选择本地安装）。

运行cygwin，在弹出的命令行窗口输入：cygcheck -c cygwin命令，会打印出当前cygwin的版本和运行状态，如果status是ok的话，则cygwin运行正常。

然后依次输入gcc –v，g++  --version，make –version，gdb –version进行测试，(注意空格和-)如果都打印出版本信息和一些描述信息，这说明cygwin安装成功了。

3、安装ADT和配置Cygwin

1 安装android 开发插件

     (1)打开Eclipse, 在菜单栏上选择 help->Install New SoftWare 出现如下界面:

    点击 Add按钮,出现如下界面

     输入网址: https://dl-ssl.google.com/android/eclipse/    (如果出错，请将https改成http)

     名称: Android (这里可以自定义)

   点击OK，将出现如下界面

全部选中。

点击 Next按钮 ，出现如下界面:

点击Next按钮，出现如下界面:

选择 I accept the terms of the license agreements   点击Next,进入安装插件界面

安装完成后，出现如下界面

点击Yes按钮，重启Eclipse。

点击菜单window->preferences,进入如下界面：

选择你的android SDK解压后的目录(ADT 18 默认会扫描你的电脑，找到并配置好SDK位置)。

如果没安装好SDK的，也可以在eclipse中选择菜单 window->Android sdk and avd manager 出现如下界面：

也可以选择你需要的版本的sdk。

新建AVD(android vitural device)和上面一样，进入android sdk and avd manager,选中Vitural Devices 在点击New按钮

点击New按钮后，进入如下界面:

名称可以随便取，target选择你需要的SDK版本，SD卡大小自定义,点击 Create AVD便成功创建。

配置cygwin

在命令行中进入cygwin目录，并执行cygwin.bat，如果你不是用Administrator账号登录的系统，那么会在cygwin\home\文件夹中生成一个以你的登录名命名的新的文件夹。

修改新生成文件夹中的“.bash_profile ”文件，用UE或editplus等文本编辑器打开，在最后增加： （e/android-ndk-r8-windows/android-ndk-r8是安装ndk的路径）

NDK_ROOT=/cygdrive/e/android-ndk-r8-windows/android-ndk-r8

export NDK_ROOT

然后保存关闭。

至此我们便基本搭建完成windows 8 的android开发环境。

二、Cocos2d-x for Android的环境搭建

Android开发环境安装好，相应的环境之后，我们便可以开始创建cocos2d-x 的android 工程了。

1、进入cocs2d-x目录，用文本编辑器打开create-android-project.bat(在windows 7上如果正常双击，可能创建时有些文件的权限不足，导致创建工程不成，可以在此文件的第一行加上cd /d %~dp0，然后右键以管理员身份运行)

2、在该文件中找到以下几个定义 ： _CYGBIN、_ANDROIDTOOLS、_NDKROOT。

@echo off
:: This script is used to create an android project.
:: You should modify _ANDROIDTOOLS _CYGBIN _NDKROOT to work under your environment.
:: Don't change it until you know what you do.
cd /d %~dp0
setlocal

:: Check if it was run under cocos2d-x root
if not exist "�%\create-android-project.bat" echo Error!!! You should run it under cocos2dx root & pause & exit 2    

if not exist "%~dpn0.sh" echo Script "%~dpn0.sh" not found & pause & exit 3

:: modify it to work under your environment     
set _CYGBIN=D:\cygwin\bin
if not exist "%_CYGBIN%" echo Couldn't find Cygwin at "%_CYGBIN%" & pause & exit 4

:: modify it to work under your environment
set _ANDROIDTOOLS=E:\android-sdk-windows\tools
if not exist "%_ANDROIDTOOLS%" echo Couldn't find android sdk tools at "%_ANDROIDTOOLS%" & pause & exit 5

:: modify it to work under your environment
set _NDKROOT=E:\android-ndk-r8-windows\android-ndk-r8
if not exist "%_NDKROOT%" echo Couldn't find ndk at "%_NDKROOT%" & pause & exit 6

:: create android project
set /P _PACKAGEPATH=Please enter your package path. For example: org.cocos2dx.example:
set /P _PROJECTNAME=Please enter your project name:
if exist "�%\%_PROJECTNAME%" echo "%_PROJECTNAME%" exists, please use another name & pause & exit 7
echo "Now cocos2d-x suppurts Android 2.1-update1, 2.2, 2.3 & 3.0"
echo "Other versions have not tested."
call "%_ANDROIDTOOLS%\android.bat" list targets
set /P _TARGETID=Please input target id:
set _PROJECTDIR=�%\%_PROJECTNAME%

echo Create android project
call "%_ANDROIDTOOLS%\android.bat" create project -n %_PROJECTNAME% -t %_TARGETID% -k %_PACKAGEPATH% -a %_PROJECTNAME% -p %_PROJECTDIR%
     
:: Resolve ___.sh to /cygdrive based *nix path and store in %_CYGSCRIPT%
for /f "delims=" %%A in ('%_CYGBIN%\cygpath.exe "%~dpn0.sh"') do set _CYGSCRIPT=%%A

:: Resolve current dir to cygwin path
for /f "delims=" %%A in ('%_CYGBIN%\cygpath.exe "�%"') do set _CURRENTDIR=%%A

:: Resolve ndk dir to cygwin path
for /f "delims=" %%A in ('%_CYGBIN%\cygpath.exe "%_NDKROOT%"') do set _NDKROOT=%%A
     
:: Throw away temporary env vars and invoke script, passing any args that were passed to us
endlocal & %_CYGBIN%\bash --login "%_CYGSCRIPT%" %_CURRENTDIR% %_PROJECTNAME% %_NDKROOT% %_PACKAGEPATH% "windows"

pause

将_CYGBIN=设置为cycgwin\bin安装的的绝对路径。

将_ANDROIDTOOLS设置为android sdk 的tools绝对路径

将_NDKROOT设置为android ndk的绝对路径

修改完毕，保存后。

3、双击create-android-project.bat开始工程创建向导

首先是输入包名(建议按照android的命名规则)，如com.android.test

然后输入工程名称（注意不要输入已有的文件夹的名字，如果同名，会被覆盖掉的），如testandroid,如下图：

然后选择target id,

其会列出机器上安装的所有版本的sdk，我们选择6，即2.3.2的sdk.

进入g:\cocos2d-x目录发现多了一个名为testandroid的目录，里面包含三个目录

其中Classes：是存放默认工程的C++文件

proj.android 是android的eclipse工程项目

Resources 资源文件

4、下来我们开始编译刚创建的testandroid项目

打开cygwin，进入到testandroid/proj.android目录，输入 ./build_native.sh 开始编译如下图：

执行完毕，发现编译出错，如下图：

发现报的是文件 Permission denied 错误，考虑的是windows 7的环境，我们看下jni/helloword/mai.cpp的文件的权限。

结果在进jni目录时，边报无权访问了，如下图：

我们不管，因为上面报的是具体文件(main.cpp)文件无权限，而非文件夹，说明编译器已经能访问到文件夹里面了，观察下main.cpp的文件权限：

发现当前用户(ming)都没有读写的权限，编译当然报错了。我们给它赋个完全控制的权限，如下：

点击应用，和确定，再次执行./build_native.sh

还是文件权限的问题，我们按之前的方法，重新赋权一下，再次编译，如果过程中发现还有类似的问题，赋权即可，我为了省麻烦，写了个快速赋权的注册表文件内容如下：

Windows Registry Editor Version 5.00
[HKEY_CLASSES_ROOT\*\shell\runas]
@="管理员取得所有权"
"NoWorkingDirectory"=""
[HKEY_CLASSES_ROOT\*\shell\runas\command]
@="cmd.exe /c takeown /f \"%1\" && icacls \"%1\" /grant administrators:F"
"IsolatedCommand"="cmd.exe /c takeown /f \"%1\" && icacls \"%1\" /grant administrators:F"
[HKEY_CLASSES_ROOT\exefile\shell\runas2]
@="管理员取得所有权"
"NoWorkingDirectory"=""
[HKEY_CLASSES_ROOT\exefile\shell\runas2\command]
@="cmd.exe /c takeown /f \"%1\" && icacls \"%1\" /grant administrators:F"
"IsolatedCommand"="cmd.exe /c takeown /f \"%1\" && icacls \"%1\" /grant administrators:F"

[HKEY_CLASSES_ROOT\Directory\shell\runas]
@="管理员取得所有权"
"NoWorkingDirectory"=""
[HKEY_CLASSES_ROOT\Directory\shell\runas\command]
@="cmd.exe /c takeown /f \"%1\" /r /d y && icacls \"%1\" /grant administrators:F /t"
"IsolatedCommand"="cmd.exe /c takeown /f \"%1\" /r /d y && icacls \"%1\" /grant administrators:F /t"

 以管理员身份运行这个文件后，就可以为windows 7右键添加取得所有权的菜单。如下图：

如果再次出现有访问权限的问题，右键点击下目录，选择管理员取得所有权即可。

最后编译成功截图如下：

编译成功之后，会直接在testandroid\proj.android\libs\armeabi这个目录底下生成so文件（libgame.so）

编译完毕，下来就是在eclipse里面编译成apk文件，并安装运行一把。

注意 ： 

如果遇到如下类似错误：

fatal error C1083: 无法打开包括文件:“CCStdC.h”:No such file or directory

fatal error C1083: 无法打开包括文件:“SimpleAudioEngine.h”:No such file or directory。可参考http://www.cocos2d-x.org/boards/6/topics/17940、http://blog.csdn.net/edbrant/article/details/8738894。

三、创建工程并运行

1、将刚编译完的工程导入到eclipse中。

以管理员身份打开eclipse（因为之前都是以管理员身份获取的权限的，否则会出现编译时权限有问题的），选择FILE->New->Android Project,然后选择如下：

点击next，选择Build Target，如下：

注意 ： 

1、工程导入编译的时候eclipse会报错，Cocos2dxActivity，org.cocos2dx.lib.Cocos2dxActivity 也找不到

解决方法：复制 ***\cocos2dx\platform\android\java\src\ (***为cocos2d-x更目录) 到你android项目中的src文件夹中，这样就又有一个麻烦问题，是不是每次创建都要复制呢，答案当然是否定的，来看一劳永逸的方法，定位 （cocos2d-x根目录）\template\android\，用文本文件打开 copy_files.sh，找到 copy_src_and_jni() 函数，添加入下代码 ： 

cp -rf $COCOSJAVALIB_ROOT/src $APP_DIR/proj.android  

搞定，以后都不用在麻烦，让程序自动帮我们处理 ：）

2、搞定以上，启动模拟器却跑不起HelloWorld程序，出现的错误信息如下：

我换了几乎所有的版本SDK，都这样，应该是支持SDK对openGL支持的限制吧，换下真机调试就ok，文章完毕。

运行该工程，右键该工程，选择Run as ->android application(从cocos2d-2.0-rc0a-x-2.0起，支持了open gl es2.0，默认的工程创建是要求运行于open gl es2.0上的，即目前模拟器还未支持，所以必须用真机去调试)

如下：

参考 ： 

http://www.cnblogs.com/lhming/archive/2012/06/27/2566467.html

http://blog.csdn.net/edbrant/article/details/8738894