Cocos2d-x项目编译为Android应用——命令行方式

前言:笔者使用 Xcode 开发完成 Cocos2d-x 项目后,想要把项目移植到 Android 平台,打包成 apk 文件。但是笔者并未安装 Eclipse,因此采用命令行方式进行编译打包。

一、编译为 debug 版本

首先介绍如何生成 debug 版本的 apk 文件。

编译前配置

1、完成代码文件的编写,在其他平台上运行成功

给自己:Xcode 开发时相对路径只需要写文件名即可,而 Android 开发时要从项目路径开始写。因此要把 Resource 文件夹下的所有子文件夹的资源文件都放到 Resource 目录下。

2、编辑%ProjectFolder%/proj.android/jni/Android.mk
在 LOCAL_SRC_FILES 中加入程序涉及的所有 .cpp 文件(也就是 Classes 文件夹下的所有 .cpp 文件)
例如

LOCAL_SRC_FILES := hellocpp/main.cpp \
                   ../../Classes/AppDelegate.cpp \
                   ../../Classes/ShapeModel.cpp \
../../Classes/RoundCircle.cpp \
../../Classes/RectDrawNode.cpp \
../../Classes/PrepareLayer.cpp \
../../Classes/MenuLayer.cpp \
../../Classes/LifeCircle.cpp \
../../Classes/HUDLayer.cpp \
../../Classes/HomeScene.cpp \
../../Classes/GameWorldController.cpp \
../../Classes/GameScene.cpp \
../../Classes/GameEndScene.cpp \
../../Classes/GameData.cpp \
../../Classes/BackGroundLayer.cpp

3、添加 NDK、Android SDK、Ant 的路径 (仅在第一次使用 cocos 命令时需要此步骤)

$ cd cocos2d-x //进入coco2d-x-3.2源文件的文件夹
$ ./setup.py	//打开设置文件//运行后会需要进行三个路径的设置
$ source FILE_TO_SAVE_SYSTEM_VARIABLE // 把路径添加到系统变量

FILE_TO_SAVE_SYSTEM_VARIABLE 默认是 /Users/apple/.bash_profile

需要设置的路径均为解压后的根目录文件夹路径。Ant 的路径可能需要延长到 bin 文件夹。
注意 Android SDK 文件夹无法直接使用,需要通过 SDK Manager 下载所需要的API以及相关文件,SDK Manager 可以通过%SDK_ROOT%\tools\android打开。

4、更改%ProjectFolder%/proj.android/AndroidManifest.xml相关配置,例如设置横屏竖屏

5、运行 Android 模拟器(AVD),模拟器需要开启 GPU 加速。

编译并运行

6、转到项目路径,进行编译

$ cd PROJECT_PATH
$ cocos run -p android -j 4

可以添加--ap XX指定编译的目标版本(--ap 16编译为 SDK 版本号16的应用,需要用 Android SDK 安装 API 16 的相关文件)
注意添加的条件 ap 前面有两条 短横杠,不是一条,笔者第二次使用的时候由于只加了一条,导致总是报错Android platform not specified, searching a default one...

7、编译成功后,使用adb logcat查看 log 信息

8、生成的 apk 文件可以在%ProjectFolder%/proj.android/bin路径下找到。

二、编译为 release 版本

上述过程得到的 apk 文件是 debug 版本,如果要编译 release 版本,还需要有一个签名文件,步骤如下:

生成签名文件

1、生成 .keystore 文件

在终端输入如下命令:

$ keytool -genkey -v -keystore android.keystore -alias android -keyalg RSA -validity 20000 -keystore /Users/apple/android.keystore

-genkey 产生证书文件

-keystore 指定生成密钥库的.keystore文件位置和名称

-keyalg 指定密钥的算法

-alias 产生别名

-validity 有限时间

编译运行

编译过程基本与 debug 版本的编译方式相同,只需要在编译命令上多加一个可选属性。执行过程中会要求提供 keystore 文件的信息,填上去就 OK 了。

2、编译 cocos2d-x 项目时加上 -m release命令
3、输入 keystore 文件地址,填入密码、别名、密码(两个密码都是自己在创建 keystore 时的密码,可以设置为一致)。
4、完成,生成的 apk 文件同样可以在%ProjectFolder%/proj.android/bin路径下找到。

可能遇到的问题:提示找不到 Android sdk 下 tools 中的 zipalign 可执行文件,从网上下载一个即可,这是一个打包优化程序。

三、参考链接

  1. 官方: Cocos2d-x README(介绍了 cocos 命令的使用)
  2. Cocos2d-x游戏打包成Android应用程序(介绍了用eclipse打包的过程)
  3. 搭建 cocos2d-x Android 常见问题
    (解决一个编译时的错误,Can't find right android-platform for project :"%ProjectFolder%\proj.android".The android-platform should be equal/larger than 20
  4. android的logcat详细用法
  5. How to Build an Android Project with Eclipse
  6. cocos2d-x3.0rc打包apk遇到的一些问题记录
    (解决一个关于命令行方式创建keystore签名的问题)
  7. Android 打包签名 从生成keystore到完成签名
  8. 官方:Cocos2d Console使用手册(关于 cocos-console 的使用)
  9. 官方:Cocos2d-console (完整 cocos-console 使用手册,英文版)

总结
在经过一次发布后,再次使用只需要:

1、在 jni\Android.mk文件中添加需要编译的 cpp 文件
2、终端输入如下命令

$ cd PROJECT_PATH
$ cocos run -p android -j 4 --ap 20 -m release

作者:唐衣可俊
出处:http://www.cnblogs.com/tangyikejun/
版权:本文版权归作者本人所有
转载:欢迎转载,但未经作者同意,必须保留此段声明;必须在文章中给出原文连接;否则必究法律责任