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               // 查看日志

以后再做補充...