Cocos Creator 打包原生 Android 包该如何选择 NDK 版本?

时间:2023-01-18 15:08:03

大家好,我是晓衡!

记得前段时间,在一些群里看到有小伙伴说 Cocos Creator 打包 Android 原生 APK 有问题:一种是构建失败,一种是运行起来报错。

晓衡也是有好长一段时间,没有碰过 Android 原生打包,我用的这台新电脑上环境都没有配置。

正好这两天,我将一个 2.0.10 的老项目,升级到了 Creator 3.6.2,并顺手测试了一下在 3.6.2 上打包 Android APK包。

不知道为什么,出乎意料的顺利,一次性构建成功,安装到手机上运行也很丝滑。

Cocos Creator 打包原生 Android 包该如何选择 NDK 版本?

后来我发现有个关键点,Android NDK 版本不能用太新的,Cocos官方文档中推荐在 r18 ~ 21 之间。
Cocos Creator 打包原生 Android 包该如何选择 NDK 版本?

在此记录一下我的 Android 构建配置流程,如果有小伙伴,在打包 APK 遇到问题可以参考一下。

01 官方文档

我在打包 Android 前,还是先认认真真地,看了下官方文档的。

  • 《安装配置原生开发环境》
- 链接:https://docs.cocos.com/creator/manual/zh/editor/publish/setup-native-development.html

首先下载安装 Android Studio,下图是我安装好的版本:Android Studio Dolphin | 2021.3.1
Cocos Creator 打包原生 Android 包该如何选择 NDK 版本?

安装好后,第一次运行 Android Studio 会有一大......顿的下载更新操作,需要有点耐心,基本上是跟着提示来就行。
Cocos Creator 打包原生 Android 包该如何选择 NDK 版本?

02 下载SDK 和 NDK

根据官方文档,下载当前主流 Platform SDK,我这里下载的是 Level 33、Level 32 两个版本。

Cocos Creator 打包原生 Android 包该如何选择 NDK 版本?

然后切换到 SDK Tools 这一页,安装最新版本的 Build-Tools,我这里显示的是 33.0.1。
Cocos Creator 打包原生 Android 包该如何选择 NDK 版本?
如果在你的电脑上,不是像上图这样显示的,勾选面板底部的 Show Packages Details 复选框,就能看到了。

SDK Tools 面板继续向下,找到 NDK(Side by side) ,我这里选择的是 18.1.5063045 ,看下图:
Cocos Creator 打包原生 Android 包该如何选择 NDK 版本?

勾选好后点击面板下面的 Apply 按钮开始下载,再耐心等一阵。

03 Creator 偏好设置

Android SDK & NDK 下载完成后,打开 Cocos Creator 主菜单 -> 偏好设置 -> 外部程序,分别设置配置 NDK、SDK 路径。
Cocos Creator 打包原生 Android 包该如何选择 NDK 版本?

我用的是 Mac 系统,路径在:

- NDK: /Users/[用户名]/Library/Android/sdk/ndk/18.1.5063045 
- SDK:/Users/[用户名]/Library/Android/sdk

你可在自己电脑上 Android Studio 的 SDK 面板上可以找到,具体路径位置。

04 Creator 构建发布

打开 Creator 构建面板,创建一个 Android 发布,在 Target API Level 一项会检测到我们安装的 Android SDK 版本,我这里配置的是 android-32。
Cocos Creator 打包原生 Android 包该如何选择 NDK 版本?

再设置一个 Android 的包名ID,屏幕方向设置为竖屏,其它的选项都默认。

检查没有问题后,依次点击构建面板下方的 构建 -> 生成,构建是生成 Cocos Creator 游戏资源包,生成才是真正打包 Andoird APK。

这时,你可以打开构建日志,查看整个 Android 构建打包过程。
Cocos Creator 打包原生 Android 包该如何选择 NDK 版本?

最后显示 BUILD SUCCESSFUL 就表示打包完成,我这个项目总共花了 3分46秒。
Cocos Creator 打包原生 Android 包该如何选择 NDK 版本?

构建生成出的 APK 文件路径:

- release:当前工程/build/android/publish/release
- debug:当前工程/build/android/publish/debug

05 小结

这次打包 Android 感觉还是挺方便的,总结一下环境配置流程:

  1. 安装 Android Studio 并按提示升级更新;
  2. 在 Android Studio 中下载 SDK、NDK;
  3. 在 Cocos Creator 中配置 Android SDK、NDK 路径;
  4. 在 Cocos Creator 构建面板中选择打包 Android 平台。

希望我的分享能对你有所帮助和启发!

更多精彩请关注Creator星球游戏开发社区