Asroads'Blog 君子不器
Mac系统Cocos Creator Native 原生Android和ios打包
发布于: 2019-10-17 更新于: 2025-04-22 分类于: game 阅读次数: 

Cocos Creator是个能发布多平台的引擎工具，之前一直用来发布Web项目，微信小游戏，头条小游戏，QQ小游戏的项目，今天尝试了一下如何发布Native 安卓（Android）apk和ios的ipa 文件。

Cocos Creator 使用基于 cocos2d-x 引擎的 JSB 技术实现跨平台发布原生应用。在使用 Cocos Creator 打包发布到原生平台之前，需要先配置好 cocos2d-x 相关的开发环境。

前期准备

环境准备

配置环境

  • Java SDK
1
java -version

本地输出

1
2
3
4
5
6
Last login: Thu Oct 17 14:39:48 on ttys001
bogon:~ smile$ java -version
java version "12.0.1" 2019-04-16
Java(TM) SE Runtime Environment (build 12.0.1+12)
Java HotSpot(TM) 64-Bit Server VM (build 12.0.1+12, mixed mode, sharing)
bogon:~ smile$

如果不能正确输出，请重新配置JDK环境，如何配置JDK，在此不再赘述。

  • Python
1
Python

本地输出

1
2
3
4
5
bogon:~ smile$ Python
Python 2.7.16 (v2.7.16:413a49145e, Mar  2 2019, 14:32:10)
[GCC 4.2.1 Compatible Apple LLVM 6.0 (clang-600.0.57)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>>

  • 安装Xcode和Android Studio

  • 安装 Android Studio 完成后，参考官方文档，打开 SDK Manager

  • SDK Manager 使用说明（需要使用 VPN）

    1. 在 SDK Platforms 分页栏，勾选你希望安装的 API Level，也就是支持安卓系统的版本，推荐选择最低兼容的 API Level 16（4.1) 和所需的主流 API Level 23（6.0）、API Level 26（8.0）和 API Level 28（9.0）。

    2. 在 SDK Tools 分页栏，首先勾选右下角的 Show Package Details，显示分版本的工具选择。

    3. 在 Android SDK Build-Tools 里，选择最新的 build tools 版本。

    4. 勾选 Android SDK Platform-Tools, Android SDK Tools 和 Android Support Library

    5. 勾选 NDK，确保版本在 r16 及以上。

    6. 记住窗口上方所示的 Android SDK Location 指示的目录，稍后我们需要在 Cocos Creator 里填写这个 SDK 所在位置。

    7. 点击 OK，根据提示完成安装。

      Cocos2d-x 自带的编译工具 Cocos Console 需要以下运行环境：

      • Python 2.7.5+，下载页，注意不要下载 Python 3.x 版本。
      • Windows 下需要安装 Visual Studio 2015 或 2017 社区版，下载页
      • Mac 下需要安装 Xcode 和命令行工具，下载页

注意：如果没有Android Support Library 那么用最后一个就可以出来Android Support Repository 就可以了

image-20191017160918319

image-20191017161004642

  • 安装ios 需要的Xcode

  • 在这里需要配置以下两个路径：

    • NDK 路径，选择 Android SDK Location 路径下的 ndk-bundle 文件夹（NDK 是其根目录），不需要编译 Android 平台的话这里可以跳过。
    • Android SDK 路径，选择刚才在 SDK Manager 中记下的 Android SDK Location 路径（Android SDK 的目录下应该包含 build-tools、platforms 等文件夹），不需要编译 Android 平台的话这里可以跳过。

    配置完成后点击 保存 按钮，保存并关闭窗口。

    注意：这里的配置会在编译 原生工程 的时候生效。如果没有生效（一些 Mac 机器有可能出现这个情况），可能需要您尝试到 系统环境变量 设置这些值：COCOS_CONSOLE_ROOT, NDK_ROOT, ANDROID_SDK_ROOT。

  • 如果遇到 NDK_ROOT not defined. Please define NDK_ROOT in your environment 这个错误

    就是环境变量的问题：

    • 问题原因：使用了zsh ＋ iTerm2 的配置，所以它默认启动时执行的脚本文件是 ～/.zshrc文件

    • 解决办法：参考 简书-DayBreakL

      vim ~/.zshrc //打开配置文件.zshrc
      source ~/.bash_profile;//在.zshrc文件末尾加上这句话，保存退出
      source ~/.bash_profile;//再终端中执行一次这个命令

新建项目

  • 我们大家Cocos Creator新建一个项目,我这里叫 mynativedemo

image-20191017155805750

  • 等待项目生成

image-20191017155925239

  • 我们项目生成，我们需要更改一下项目的参数设置

image-20191017160017354

  • 打开菜单–> 偏好设置

image-20191017160057975

  • 偏好设置–>原生开发环境配置
    • NDK 路径，选择 Android SDK Location 路径下的 ndk-bundle 文件夹（NDK 是其根目录）
    • Android SDK 路径，选择刚才在 SDK Manager 中记下的 Android SDK Location 路径（Android SDK 的目录下应该包含 build-tools、platforms 等文件夹）
    • 默认 /Users/smile/Library/Android/sdk/ndk-bundle(此处Android Studio 4.1后有改动)
    • /Users/smile/Library/Android/sdk/ndk/21.3.6528147
    • 默认 /Users/smile/Library/Android/sdk
    2020-11-24 更新 –开始升级Android Studio 4.1 关于 Android Studio 4.1这样配置会报错 A problem occurred configuring project ‘:app’.
    1
    2
    3
    NDK is missing a “platforms” directory.
    If you are using NDK, verify the ndk.dir is set to a valid NDK directory. It is currently set to C:\DJZHAO\Workspace\Android\Sdk\ndk-bundle.
    If you are not using NDK, unset the NDK variable from ANDROID_NDK_HOME or local.properties to remove this warning.
    解决办法 NDK 路径不对，重新配置正确的路径 应修改为 image-20201124132939890/Users/smile/Library/Android/sdk/ndk/21.3.6528147 其中21.3.6528147 是自己对应下载的NDK下载ADK image-202011241323516512020-11-24 更新 –结束

image-20191017160336544

  • 偏好设置–>预览运行 修改 我这里写 750 X 1334 竖屏

image-20191017161435248

  • 打开 项目–>项目设置

image-20191017161602143

  • 项目设置–>项目预览 设置分辨率、 适配宽度

image-20191017161928244

安卓平台（apk）

  • 选择 项目–>构建发布

image-20191017162024592

  • 设置需要的选项

    image-20191017162631119

Portrait —> 这个是竖屏展示；

Upside Down –> 这个是手机竖屏，但是你的手机需要倒过来；

Landscape Left –> 这个是横屏，屏幕在home键左边；（常用的）

Landscape Right –> 这个也是横屏，屏幕在home右边。

附加 Android 的 API Levels对应表 大家可以根据这个表 判断自己要兼容的版本

Android 的 API Levels对应表

名称 版本号 发行日期 API等级
Android 11 11 2020-09-08 30
Android 10 10 2019-09-03 29
Pie 9 2018-08-06 28
Oreo 8.0 – 8.1 2017-08-21 26 – 27
Nougat 7.0 – 7.1.2 2016-08-22 24 – 25
Marshmallow 6.0 – 6.0.1 2015-10-05 23
Lollipop 5.0 – 5.1.1 2014-11-12 21 – 22
KitKat 4.4 – 4.4.4 2013-10-31 19 – 20
Jelly Bean 4.1 – 4.3.1 2012-07-09 16 – 18
Ice Cream Sandwich 4.0 – 4.0.4 2011-10-18 14 – 15
Honeycomb 3.0 – 3.2.6 2011-02-22 11 – 13
Gingerbread 2.3 – 2.3.7 2010-12-06 9 – 10
Froyo 2.2 – 2.2.3 2010-05-20 8
Eclair 2.0 – 2.1 2009-10-26 5 – 7
Donut 1.6 2009-09-15 4
Cupcake 1.5 2009-04-27 3
1.1 1.1 2009-02-09 2
1.0 1.0 2008-09-23 1
  • 等待发布成功

image-20191017162717336

控制台没有输出错误log

1
2
3
4
5
6
Start building assets
Enable "内联所有 SpriteFrame" in native platform will increase the package size used in hot update.
Finish building assets
Start building plugin scripts
Checked Python Version [2.7.16]
Built to "/test/cc/mynativedemo/build/jsb-link" successfully
  • 此时我们的项目已经生成 在 .build 文件夹下
  • 修改我们的项目 自定义部分
  • 然后点击 编译按钮

image-20191017162959672

  • 等待项目完成

image-20191017163025828

image-20191017164659108

1
2
3
4
5
6
7
Skipping task ':hello_world:assembleRelease' as it has no actions.
:hello_world:assembleRelease (Thread[Task worker for ':' Thread 3,5,main]) completed. Took 0.0 secs.
BUILD SUCCESSFUL in 14m 13s
59 actionable tasks: 59 executed
Move apk to /test/cc/mynativedemo/build/jsb-link/publish/android
Build succeed.
Compile native project successfully.

路径 build/jsb-link/publish/android下 生成我们的APK文件

image-20191017164915280

  • 点击安装 运行效果

image-20191017171806738

关于返回键不能正常关掉游戏的问题，此处先不谈这些，只讨论如何正确发布，这个问题，后面再说如何解决

ios 平台（ipad）

准备工作

  • 需要正确安装的Xcode
  • 然后需要安装开发者证书
  • 需要再证书添加调试设备者账号ID

开始构建设置

  • 选择 项目–>构建发布

image-20191017172508043

  • 设置需要的选项

    image-20191017172508043

  • 成功构建后

image-20191017172615058

1
2
3
4
5
6
7
Checked Python Version [2.7.16]
Start building assets
Enable "内联所有 SpriteFrame" in native platform will increase the package size used in hot update.
Finish building assets
Start building plugin scripts
Checked Python Version [2.7.16]
Built to "/test/cc/mynativedemo/build/jsb-link" successfully

  • 找到 构建目录.build 目录下面的 jsb-link–>frameworks–>runtime-src–>proj.ios_mac–>hello_world.xcodeproj 使用 Xcode 打开

    image-20191017172921364

  • 修改我们项目的配置

    • 修改秘钥

    image-20191017173103276

    • 修改后

      image-20191017174336649

  • 修改我们调试设备 Build Settings

    image-20191017174454507

    image-20191017174610543

    • 连接我们的设备 然后点击运行按钮等待

    image-20191017174727660

    image-20191017174758089

    • 编译结束

    image-20191017175007955

    image-20191017175119545

    OK 调试结束

  • 导出我们的ipad 文件

    • 选择 Achieve

      image-20191017175321044

      等待编译结束

      image-20191017175349905

    • 结束后 会主动弹出一个窗口 或者我们自己打开 Window–> Organizer 打开窗口

      image-20191017175936077

      选择 Development 点击 Next 然后 继续 Next

      image-20191017181115155

      然后选择 Profile 点击 Next

      image-20191017181139645

  • 最后选择 导出 export 我们的项目

image-20191017180543007

选择导出目录

image-20191017180617273

最后 打开已经生成 ipa文件

image-20191017180707333

备注 导出的项目 目录 /Users/smile/Library/Developer/Xcode/Archives 点击小箭头 可以打开

image-20191017181525986

使用iTools 安装 ipa 文件

  • 下载 iTools 进入官网
  • 安装iTools
  • 打开iTools软件

image-20191017182156967

安装我们生成的ipa 文件

image-20191017182400689

安装成功

image-20191017182429311

打开运行成功

image-20191017182627753

本地 模拟器删除缓存

删除：/Applications/CocosCreator.app/Contents/Resources/cocos2d-x/simulator/mac/Simulator.app/Contents/Resources/jsb.sqlite 这个文件即可

1
/Applications/CocosCreator.app/Contents/Resources/cocos2d-x/simulator/mac/Simulator.app/Contents/Resources/jsb.sqlite

注意：删除 整个 resources 文件夹 会导致运行不起来

关于安卓手机如何监听返回键

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
cc.systemEvent.on(cc.SystemEvent.EventType.KEY_DOWN, this.onKeyDown, this);
onKeyDown(event) {
       switch (event.keyCode) {
           case cc.macro.KEY.back:
               cc.game.end();
               break;
           default:
       }
       // if (!this._toExitGame) {
       //     // 首次点击，重置该标记
       //     this._toExitGame = true;
       //
       //     // 发出后退消息，这里监听者来弹出提示：再次点击后退，退出游戏。
       //     // 这里要替换成自己的消息处理方法
       //     // AppFacade.getInstance().sendNotification(GAMEEVENTS.APP.TRY_EXIT);
       //
       //     // 3秒后没有再次按【后退】按钮，则重置该标记
       //     this.node.runAction(cc.sequence(cc.delayTime(3), cc.callFunc(() => {
       //         this._toExitGame = false;
       //         // this.label.string = '';
       //     })));
       // }else{
       //     // 已经点击过一次，则直接退出
       //     cc.game.end();
       //     return;
       // }
   }

2021-09-24 更新

最新版本 使用 Cocos Creator 3.3.1 版本 安卓版本 Target API Level 为 30 情况下 返回键已经无效 可以使用一个迂回的方案解决

AppActivity.java

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
@Override
  public boolean onKeyDown(int keyCode, KeyEvent event) {
      if(keyCode == KeyEvent.KEYCODE_BACK) {
          Cocos2dxHelper.runOnGLThread(new Runnable() {
              @Override
              public void run() { 
    Cocos2dxJavascriptJavaBridge.evalString("cc.game.jsBridge.onBackPressed();");
              }
          });
          return true;
      } else {
          return super.onKeyDown(keyCode, event);
      }
  }

原文链接：https://blog.csdn.net/lebsharing/article/details/110004131

JavaScript 端 写对应处理即可

1
2
3
onBackPressed() {
       console.log("----onBackPressed----");
}

其他相关问题 比如 Editbox 等问题 ：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
@Override
public boolean onKeyDown(int keyCode, KeyEvent event) {
    if (keyCode == KeyEvent.KEYCODE_BACK){
        if(hasExitBox){//直接调用sdk的退出框
            OutFace.getInstance(this).outQuit(this);
        }else{
            JSONObject jsonObject = new JSONObject();
            try {
                jsonObject.put("status",0);
            } catch (JSONException e) {
                e.printStackTrace();
            }
            sActivity.evalStringWithJsonData("xxx.showExitAlert", jsonObject);
        }
        return true;
    }
    return super.onKeyDown(keyCode, event);
}

思路：就是自己把信息传到 Javascript 那边，然后处理对应的动作。

总结

打包Native安装包，应该了解安卓环境或者Xcode环境，熟悉项目目录结构文件配置，能更轻松顺利的解决遇到的问题。

--- 本文结束 The End ---