安卓构建示例

本文将演示 Cocos Creator 项目发布为 Android 应用程序的流程。

请准备一个至少含有一个场景的 Cocos Creator 项目。

project.png

发布环境搭建

要想发布 Android 原生应用，需要安装 Android Studio 开发环境，以及特定版本的 JDK（或者 OpenSDK），Android SDK 和 NDK 等。详情请参考 配置 Android 原生开发环境。

发布流程

接下来，在 Cocos Creator 找到 项目 菜单，点击 构建发布 按钮，弹出 构建发布 面板。

创建发布任务

  1. 选择 项目 -> 构建 菜单，打开构建面板

    cc-build-menu.png

  2. 点击面板上的 新建构建任务 选项：

    new-build-task.png

  3. 选择构建平台为安卓：

    select-platform.png

  4. 选择至少一个场景作为应用载入的首场景，当仅有一个场景时会被默认添加：

    start-scene.png

  5. 参考 Android 平台构建选项 - 渲染后端 选择渲染后端

    render-backend.png

  6. 填入包名

    game-package-name.png

    名称规范请参考 应用 ID 名称

  7. 选择 Target API Level

    target-api-level.png

    如果没有下拉框，请检查上面的 配置 SDK 和 NDK 是否正确。

其他选项请参考 Android 平台构建选项 进行配置。

构建与发布

  1. 构建：点击下方的 构建 按钮会创建一个新的构建任务并开始构建

    build.png

  2. 等待构建完成

    building.png

  3. 在点击下面的按钮打开生成好的 Android Studio 工程：

    open

  4. 找到工程对应的目录

    find-proj

  5. 打开 Android Studio 的菜单：

    android studio open project menu

  6. 打开已经构建好的项目，{项目路径}/build/android/proj：

    android studio open project

  7. 使用 Android Studio 构建 APK

    打开 Android Studio 后，会花一段时间进行准备工作，待 Android Studio 将项目准备完成后，即可打包 APK。准备过程可能会耗时较久，如果长时间无响应，请检查网络，或者切换到其他镜像。此时如果您需要中断目前的后台任务，可参考下列关闭方法：

    Android Studio 有后台任务时，可以点击窗口下方的后台任务栏： background-task.png
    在弹出窗中点击右侧的 × 以结束后台任务： interrupt-sync.png

  8. 打开 Build 菜单选择 Build Bundle(s) / APK(s)：

    build-apk.png

  9. 发布成功后可以在 proj/build 目录内找到 Debug 版本的 APK：

    apk.png

秘钥生成与使用

正式版本的发布，不能使用调试密钥，需要自行创建密钥。

创建密钥

秘钥可以通过 Android Studio 来生成：

  1. 在 Android Studio 中点击 Build 菜单，选中 Generate Signed Bundle / APK：

    gen-sign-apk.png

  2. 在弹出菜单的窗口中选择 APK，点击 Next 按钮：

    gen-apk.png

  3. 在引导的窗口中点击 Create new：

    create-sign.png

  4. 在弹出的窗口中，填好相应信息即可：

    android-keystore-panel.png

    不同的项目，建议使用不同的密钥。可以将每个项目的密钥保存在项目根目录下。

使用密钥

密钥创建成功后，会在选择的目录下生成一个密钥文件，我们可以在 Android 构建面板上，将密钥信息填好。 这样不管是调试版还是发布版，都使用的是自己创建的密钥。

如下图所示，取消 使用调试秘钥，并从下方的 秘钥库路径 中找到自定义的秘钥文件，填好相关信息即可。

debug-keystore.png

注意事项

  1. 建议项目第一次发布时，就为项目创建一个专用的密钥。
  2. 一些 SDK 的服务接入需要 APK 密钥签名验证，使用默认的调试密钥可能导致服务调用失败。

进阶

JAVA 和 TypeScript 互相通信

引擎提供多样化的方法用于解决 TypeScript 和 Native 层交互问题。

常见的 SDK 接入时，我们需要通过 SDK 的登陆接口进行登陆操作，获取到登陆结果后再将结果传入到 TypeScript 层以方便游戏进行处理。

引擎提供了三种用于 TS 与 Android 原生通信的方法。

导入第三方库

为了将应用发布到应用市场，通常需要对接某些第三方的 SDK，通常这些 SDK 会提供给您 JAR 或 AAR 格式，您可以参考 在其他项目中使用您的库 将本地的库导入到工程内。

扩展发布机制

参考 自定义构建流程 通过扩展系统对发布机制进行扩展。

Q&A

  • Q：发布时的错误如何调试

    • A：点击日志按钮，进行查看

      show-log.png

  • Q：提示缺少 LIB_EGL

    • A：更换 NDK 版本为文中所述的版本

  • Q：文件命名

    • A：由于安卓是基于 Linux 的，因此 Linux 的一些文件规范在安卓依然适用，如：
        1. 安卓是大小写敏感的，确保路径的大小写是正确的，否则将无法正确加载
        1. 文件夹或文件名中不要含有空格等字符

特性与系统版本

不同的特性会依赖特定的系统版本，请往 特性与系统版本 查看详情。