cocosCreator 入门(二) Android原生环境配置

官网：https://www.cocos.com/

参考：https://docs.cocos.com/creator/manual/zh/publish/setup-native-development.html

配置： MacOS 10.12.6  CocosCreator2.3.3 JavaScript AndroidStudio

 

环境配置

1. 下载JDK工具，网址：https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html

安装后，打开终端，输入命令：

java -version

 2. 下载安装AndroidStudio, 主要使用SDK和NDK，网址：http://www.android-studio.org/

启动AndroidStudio后，可在欢迎页面选择Configure -> SDK Manager ，如图所示

* 在 SDK Platforms分页栏,勾选你希望安装的API，比如：

-- 建议多安装一些，以用于低版本测试
API Level 23(6.0)， API Level 26(8.0),  API Level28(9.0)

安装成功后，会放置在你设定的目录: ../Android/sdk/platforms 中

* 在 SDK Tools分页栏，勾选上右下角的 Show Package Details,

-- Android SDK Build - Tools 选择最新版本，我选择的是
28.0.2
29.0.3
30.0.0-rc1
-- NDK (Side by side) 按照官方指定，选择的是
17.2
19.2

-- 其它
Android Emulator
Android SDK Platform-Tools
Google Play services
NDK 

安装成功后，NDK的放置目录在 ../Android/sdk/ndk-bundle 中

* 为了确保安全，我们可以通过cocos2d-x的setup.py设置下环境变量，以cocos2d-x-3.10为例

-- 进入cocos2d-x 3.10 引擎目录下，输入命令：
python setup.py

该命令会帮助我们一键设定 COCOS_CONSOLE_ROOT, NDK_ROOT, ANDROID_SDK_ROOT等。 或者我们直接打开配置文件

-- 终端命令
open .bash_profile

-- 配置sdk， ndk相关
--[[
# sdk
export ANDROID_SDK_ROOT=/Users/name/Documents/Android/sdk 
export PATH=$PATH:$ANDROID_SDK_ROOT
export PATH=$PATH:$ANDROID_SDK_ROOT/platform-tools

# ndk
export NDK_ROOT=/Users/name/Documents/Android/sdk/ndk-bundle
export PATH=$PATH:$NDK_ROOT
]]

3. 打开cocosCreator, 选择cocosCreator -> 偏好设置... -> 原生开发环境 ,设定路径：

NDK路径： 选择你在Android Studio设定路径下的 ndk-bundle文件夹，比如：/Users/name/Documents/Android/sdk/ndk-bundle

Android SDK路径：选择Android Studio设定路径 ，比如：/Users/name/Documents/Android/sdk

 

原生平台发布

修改apk名称，可打开: ../build/jsb-link/frameworks/runtime-src/proj.android-studio/res目录：

* mipmap相关文件夹用于修改apk图标

* values下的strings.xml用于修改apk名字，比如：

<resources>
    <string name="app_name" translatable="false">apk名</string>
</resources>

1. 为减少包体大小，我们需要去掉无用的模块，步骤：打开cocosCreator后，选择：项目 -> 项目设置... -> 模块设置

2. 安全起见，我们可以通过模拟器运行，来检测下app的问题存在。步骤：打开cocosCreator后，选择：CocosCreator -> 偏好设置... -> 预览运行

// 设置相关
模拟器横竖屏设置：根据您的app设置横屏竖屏
模拟器分辨率设置：选择您需要的设备相关，也可选择自定义分辨率下的宽高
开启模拟器调试界面：打开后，可查看调试日志

3. 打包apk，步骤为：打开cocoscreator后，选择： 项目 -> 构建发布...  

/*
参数说明：

发布平台：Android， 参考：https://docs.cocos.com/creator/manual/zh/publish/
初始场景： 若有多个，请选择起始场景
APP ABI:  对应设备的CPU架构，勾选的越多，适配的设备就越多，但包体也会越大
设备方向：
Portrait           -- 竖屏展示
Upside Down        -- 倒竖屏展示
Landscape Left     -- 横屏，屏幕在home键左边(常用)
Landscape Right    -- 横屏，屏幕在home键右边
*/ 

4. 若想关闭左下角的调试模式，可以在启动脚本中添加：

onLoad: function() {
        // 若为android或ios平台，关闭调试模式
        if (cc.sys.OS_ANDROID === cc.sys.os || cc.sys.OS_IOS === cc.sys.os) {
            cc.debug.setDisplayStats(false)   
        }
},

5. 然后依次选择下方的：构建， 编译，运行。

构建：会在build中生成jsb-link相关

编译：会通过sdk，ndk等编译引擎源码相关，并在../build/jsb-link/publish中生成对应的apk包

运行：会把apk包安装到设备中，为了安全起见，可以使用adb命令相关

// USB连接手机，打开开发者模式下的USB调试模式
adb version              // 查看adb版本
adb devices              // 查看当前连接设备
adb start-server         // 启动adb服务
adb kill-server          // 停止adb服务    
adb logcat               // 查看日志

以后再做补充...