文章目录
1. 按
- 本文介绍Cocos 2d-x多个版本Android打包配置教程,含3.17.2、3.17.1、3.10、3.3四个版本,其中以Cocos 3.17.1为主讲,含所有与相应的引擎及配套的工具云盘下载链接(Cocos2d-x,NDK,SDK,ANT,JDK,CocosStudio(兼容性差不推荐使用,推荐使用瓦片地图)),你想要的,一应俱全。
所有资源下载统一地址:https://www.cnblogs.com/coco56/p/11223189.html
在开发相关那里。
- 我把所有的都精简优化了一下,SDK都保留一个API的build tools和platform-tools(NDK也在platforms只保留一个platform),这样的话直接到项目根目录下运行。
cocos compile -p android
就可以了
不然的话安装多个API可能还需要指定一下API,如cocos compile -p android -ap 28
老版本如Cocos 3.3指定API之后好像还不行,还得改很多文件,这里只让它保留一个API,消除了二义性,简化了操作,并且相应工具的压缩包的体积也变小了一点儿。 - 官方给出的构建需求:https://docs.cocos.com/cocos2d-x/manual/en/installation/prerequisites.html?h=require
2. Cocos 3.17.2
请参考Cocos 3.17.1,实测发现两者对于安卓打包的配置并没有变化,官网上也有更新日志,并未发现有对打包的调整。
Windows平台的话还是默认使用VS2017的工程,使用VS2019无法用命令提示符进行打包,打开VS2019进行调试时,以Debug模式很快,但以Release模式很慢,会卡在CCTweenFunction.cpp这个文件的编译上。
建议安装VS2019+VS2017(Cocos工程Debug用的VS2019,Release用的VS2017)
VS2019与2017都装好后,用VS2019打开工程,然后右键点击项目,再点击属性,即可进行切换平台工具集(即切换成用VS2017打包)
3.17.2的我对ndk进行了下稍微升级(不升级也没事儿,可以完全按照3.17.1的来)
2.1. NDK下载官网
https://developer.android.google.cn/ndk/downloads
3. Cocos 3.17.1
3.1. Android Studio
可以下载安装Android Studio,不下载也行,不影响使用命令提示符打包。
Android Studio目前的最新版是3.4:https://dl.google.com/dl/android/studio/install/3.4.0.18/android-studio-ide-183.5452501-windows.exe
也可以去官网看下是否是最新版:https://developer.android.google.cn/studio
Android Studio 用于编译原生库的默认构建工具是 CMake。由于很多现有项目都使用构建工具包,因此 Android Studio 也支持 ndk-build。不过,如果您要创建新的原生库,则应使用 CMake。
3.2. 配置
3.2.1. 概要
Cocos 3.17.1也默认采用的Cmake,因此用配置好SDK和NDK就行了(尽管我们用的Cmake而非NDK,因为不配的话会提示NDK未配置,无法正常使用),不用管ANT(默认用的gradle,且会在首次使用时自动下载安装)。
在项目的根目录/proj.android/gradle.properties里可以看到。
使用ndk-build需要改Android.mk,把里面的cpp文件名换成自己的。使用Cmake需要改CmakeLists.txt,除了改cpp文件名之外,还要换.h的文件名。
目标sdk_version 为28,即Android 9.0
默认用的gradle,且会在首次使用时自动下载安装,用户无需手动配置。
CMakeLists.txt配置如图,把自己写的.cpp和.h的文件名都写进去
3.2.2. 先配好Java
jdk下载:https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
需要先配好java,因为安卓是基于Java的,所以后面的SDK、ANT的配置都要依赖于Java,可以说没有Java就没有安卓。
我安装的jdk-8u202-windows-x64.exe
这一步可以取消,因为你装sdk的时候已经装了一个公共的jre
读者可以到jdk路径下自行验证。
可以在系统变量里配置Java,也可以在用户变量里配置Java,Windows支持多用户使用一台电脑(可以新建多个账号,一般情况下用户都是一个账号,这是因为用户的电脑一般都是自己一个人使用的,很少多人共用一台电脑,即使有,那也很少会每人分配一个账号。)。
这里我选择在系统变量里配置Java,这样我换个账号登录我的电脑,也照样能使用Java。
新增JAVA_HOME键值对到系统变量里
JAVA_HOME
修改Path所对应的值,增添两条记录。
%JAVA_HOME%\bin
%JAVA_HOME%\jre\bin
win10以下系统复制以下代码然后追加到Path的值里:
%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin
新增CLASSPATH键值对
CLASSPATH
.;%JAVA_HOME%\lib;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar
3.2.3. SDK
可以用Android Studio下载,也可以用命令提示符敲命令下载。
Android Studio图形化界面,点几下就可以了,好像需要借助梯子(我国政府应该不让访问谷歌,弄的有个长城防火墙,会自动拦截相关请求)才能用,我下载的有谷歌访问助手(安装在浏览器上,可以正常访问谷歌),不知道是不是使用代了(下载的时候没开Chrome浏览器),用命令提示符的话那时候记得也没使用代理,具体自己试吧,应该使用代效果会好点儿,实在不行可以去我网盘下载不是,所有工具都有。
说下命令提示符的那个:
Windows,先下载:https://dl.google.com/android/repository/sdk-tools-windows-4333796.zip
其他的去官网下载:https://developer.android.com/studio
使用帮助:https://developer.android.com/studio/command-line/sdkmanager
安装Android-28
For example, here’s how to install the latest platform tools (which includes adb and fastboot) and the SDK tools for API level 28:
sdkmanager "platform-tools" "platforms;android-28"
弄好之后记得accept一下License,否则会出现异常(我发的含的有这个License,应该不需要再弄了,自己下载的话,弄完了之后可能需要弄一下。)
到你的SDK根目录下的tools\bin目录下运行
sdkmanager --licenses
当然也可以直接下载我配好了,这样就不用作这么多难了。我对这个进行了精简,只保留了Android-28的,感觉其他的也基本用不到,因为下载的SDK就是Android-28的。
重要:下载好之后记得把sdk里面的Cmake所在的目录加到环境变量中的Path里,否则一定无法成功打包到安卓。
注:解压SDK后里面有个Cmake目录知道吧,然后有个以版本号命名的目录知道吧,接着有个bin目录能看到吧???
3.2.4. NDK
官网: https://developer.android.google.cn/ndk/downloads/index.html
3.2.5. 配置Python2
下载安装,然后把Python安装的目录配置到环境变量的Path值里。
3.2.6. 安装Cocos 3.17.1
转到相应目录下,Shift+鼠标右键,然后选择在此处打开PowerShell窗口。
运行Python .\setup.py
.是当前目录知道吧,.\setup.py是当前目录下的setup.py文件。
不行的话直接输入绝对路径也可以,比如F:\cocos2d-x-3.17.1\setup.py
弄好之后,会让你填NDK和SDK的所在路径,这里我已经填过了,就不用再填了,第一次配置时把相应工具的所在路径的根目录填一下就行。
4. Cocos 3.10
4.1. 一键自动配置
打开Cocos,点击偏好设置。
安卓配置如下图所示(这是我点击一键配置完成的,标准配置),另外VS标配是VS2013(一键打包用的这个,也可以使用VS2015,不过不能一键打包)。
Java配置参考本文Cocos 3.17.1的,忘了自动配置的话会不会自动配Java,不行的话就手动配一下Java吧。
4.2. 手动配置
如果自动配置失效,可尝试手动配置
打开Cocos,转到偏好设置。
这里ANT已经自动配好,我们只需要配一下SDK、NDK、JDK就可以了。
解压相应的压缩包,然后把路径填上去,然后保存。
4.2.1. Python2
配置Python2参考Cocos 3.17.1
4.2.2. 安装Cocos
可参考Cocos 3.17.1的配置过程
运行python .\setup,再把路径填一下。
配置Java请参考本文Cocos 3.17.1的配置方式
5. Cocos 3.3
5.1. Java
- 安装并配置Java,参考本文Cocos 3.17.1的配置过程。
5.1.1. Python2
配置Python2参考Cocos 3.17.1
5.2. 安装Cocos
可参考Cocos 3.17.1的配置过程
运行python .\setup,再把路径填一下。
我的这个都填过了,所以再次运行setup.py就不需要配了。
5.2.1. SDK
我网盘有对应的版本,下载好之后安装的时候填一下所在路径就行,填的时候是SDK的根目录。
5.2.2. NDK
我网盘有对应的版本,下载好之后安装的时候填一下所在路径就行,填的时候是NDK的根目录。
5.2.3. ANT
我网盘有对应的版本,下载好之后安装的时候填一下所在路径就行,注意这个填的时候填的不是ANT所在的根目录,而是到根目录下的bin目录。