1、Cocos Console指令,鮑健運 Cocos引擎技術(shù)布道師，開發(fā)者關(guān)系部,Cocos Console指令,簡介： 命令行工具集，可以用于創(chuàng)建、編譯、運行 cocos 工程。 此工具使用 Python 語言開發(fā)，適用于 Windows，Mac 和 Linux 系統(tǒng)。 環(huán)境要求： 2.7.5 +（但不支持3.x）,Cocos Console指令,環(huán)境要求： 開發(fā)iOS & Mac 程序需要： Xcode 開發(fā)Android程序需要： JDK Android SDK Android NDK （推薦r9d） Apache Ant,Cocos Console指令,安裝Ant： http:/ant.

2、/,Cocos Console指令,環(huán)境要求： 開發(fā)Windows程序需要： 開發(fā)Linux程序需要： 運行 cocos2d-x 或者 cocos2d-js 中的 build/install-deps-linux.sh 腳本來安裝依賴的環(huán)境。,Cocos Console指令,設(shè)置環(huán)境變量： 一般情況： 運行 cocos2d-x 或者 cocos2d-js 根目錄下的 setup.py 開發(fā)Android程序： 如果需要開發(fā) Android 程序，setup.py 執(zhí)行過程中需要輸入 ANDROID_SDK_ROOT, NDK_ROOT & ANT_ROOT 三個路徑。,Co

3、cos Console指令,注意： 使用Cocos安裝，即已安裝 ，則無需再安裝Python和Ant，系統(tǒng)已配置,Cocos Console指令,用法： cocos command arguments 可用命令： 可用參數(shù)：,Cocos Console指令,cocos new： 新建一個Cocos工程 用法： 可用參數(shù)：,Cocos Console指令,cocos new 注意事項： 查找模板的邏輯： 生成模板文件夾字符串，規(guī)則：語言-template-模板名稱。 示例：命令 cocos new -l js -t runtime 所要查找的模板文件夾為 js-template-runtime

4、在引擎的 templates 目錄查找模板文件夾。,Cocos Console指令,cocos new 示例： cocos new -h ：顯示幫助信息。,Cocos Console指令,cocos new 示例： cocos new -l js -p org.cocos2dx.mygame -d ./projects -t runtime MyJSGame 創(chuàng)建的工程屬性： 語言：js 包名：org.cocos2dx.mygame 存放路徑：./projects 工程名稱：MyJSGame 模板名稱：runtime,Cocos Console指令,cocos compile 編譯并打包coc

5、os工程 用法：,Cocos Console指令,cocos compile 參數(shù)說明 通用參數(shù)：,Cocos Console指令,cocos compile 參數(shù)說明續(xù)1 Android 相關(guān)參數(shù)：,Cocos Console指令,cocos compile 參數(shù)說明續(xù)2 Windows 相關(guān)參數(shù)： Web 相關(guān)參數(shù)：,Cocos Console指令,cocos compile 參數(shù)說明續(xù)3 iOS/Mac 相關(guān)參數(shù)： iOS 相關(guān)參數(shù)：,Cocos Console指令,cocos compile 參數(shù)說明續(xù)4 Lua/js 工程參數(shù)： lua 工程參數(shù)：,Cocos Console指令,c

6、ocos compile 注意事項 執(zhí)行命令時，如果不指定 -p, -platform 參數(shù)，會輸出可用的平臺，如下圖： 在編譯 linux 和 web 兩個平臺時，不支持 -compile-script 參數(shù)。,Cocos Console指令,cocos compile 注意事項續(xù) 如果啟用了 -lua-encrypt 參數(shù)，需要修改 C+ 代碼文件 frameworks/runtime-src/Classes/AppDelegate.cpp：,Cocos Console指令,cocos compile 示例 cocos compile -h 顯示幫助信息。 cocos compile -s

7、 ./projects/MyLuaGame -p android -ndk-mode release -compile-script 1 -lua-encrypt 編譯 MyLuaGame 工程的 Android 平臺。ndk-build 模式為 release。并且編譯 & 加密 lua 腳本。 cocos compile -s ./projects/MyLuaGame -p ios -m release -sign-identity iPhone Distribution:xxxxxxxx 編譯 MyLuaGame 工程的 iOS 平臺，使用 release 模式，并且使用代碼簽名 ID：

8、iPhone Distribution:xxxxxxxx.,Cocos Console指令,cocos deploy 編譯并在設(shè)備或模擬器上部署工程。 用法： 依賴命令： cocos compile,Cocos Console指令,cocos deploy 參數(shù)說明 注意事項 目前此命令只有在 -p 參數(shù)為 android 時有效果。會在模擬器或者設(shè)備上重新安裝 apk。,Cocos Console指令,cocos deploy 示例 cocos deploy -h 顯示幫助信息。 cocos deploy -s ./projects/MyJSGame -p andoird -m releas

9、e 編譯 MyLuaGame 工程,并將 apk 安裝到設(shè)備或者模擬器上。,Cocos Console指令,cocos run 編譯工程，并在設(shè)備或者模擬器上部署和運行工程。 用法： 依賴命令： cocos deploy,Cocos Console指令,cocos run 參數(shù)說明 通用參數(shù)： Web工程可用參數(shù)：,Cocos Console指令,cocos run 注意事項 目前不支持在 iOS 設(shè)備上運行工程。 示例 cocos run -h 顯示幫助信息。 cocos run -s ./projects/MyJSGame -p android -m release 使用 release

10、模式編譯 MyJSGame 工程，并在 Android 設(shè)備或者模擬器上運行工程。,Cocos Console指令,cocos jscompile 對 js 文件進行加密和壓縮處理。 用法：,Cocos Console指令,cocos jscompile 參數(shù)說明,Cocos Console指令,cocos jscompile 示例 cocos jscompile -h 顯示幫助信息。 cocos jscompile -s ./projects/MyJSGame/src -d ./projects/MyJSGame/src 將 ./projects/MyJSGame/src 文件夾下的 js

11、文件編譯為 jsc 文件。,Cocos Console指令,cocos luacompile 對 lua 文件進行加密和編譯為字節(jié)碼處理。 用法：,Cocos Console指令,cocos luacompile 參數(shù)說明,Cocos Console指令,cocos luacompile 示例 cocos luacompile -h 顯示幫助信息。 cocos luacompile -s ./projects/MyLuaGame/src -d ./projects/MyLuaGame/src -e -k MyLuaKey -b MyLuaSign 將 ./projects/MyLuaGame/

12、src 文件夾下的 lua 文件編譯為 luac 文件，并使用 XXTea 算法進行加密。加密的 key 為 MyLuaKey，加密的 sign 為：MyLuaSign。,Cocos Console指令,cocos gen-libs 生成引擎的預(yù)編譯庫。生成的庫文件會保存在引擎根目錄的 prebuilt 文件夾。 用法：,Cocos Console指令,cocos gen-libs 參數(shù)說明 通用參數(shù)： Windows 相關(guān)參數(shù)：,Cocos Console指令,cocos gen-libs 參數(shù)說明續(xù) Android 相關(guān)參數(shù)： 注意事項： 不同的操作系統(tǒng)中可用的目標平臺是不一樣的： Mac

13、 : ios, mac, android Windows : android, win32 Linux : android 如果需要一次生成多個目標平臺的預(yù)編譯庫，可以通過多次使用 -p 參數(shù)來實現(xiàn)。例如： -p ios -p mac 會同時生成 iOS 和 Mac 兩個目標平臺的預(yù)編譯庫。,Cocos Console指令,cocos gen-libs 示例 cocos gen-libs -h 顯示幫助信息 cocos gen-libs -c 刪除 prebuilt 文件夾。然后生成所有可用的目標平臺預(yù)編譯庫。 cocos gen-libs -e /Work/cocos2d-x -p ios

14、-p android 指定引擎路徑為 /Work/cocos2d-x。 然后生成 iOS 和 Android 兩個平臺的預(yù)編譯庫。 cocos gen-libs -p win32 -vs 2015 -m debug 使用 VS2015 和 debug 模式生成 win32 平臺的預(yù)編譯庫。,Cocos Console指令,cocos gen-simulator 生成 Cocos 模擬器 用法：,Cocos Console指令,cocos gen-simulator 參數(shù)說明,Cocos Console指令,cocos gen-simulator 注意事項 不同的操作系統(tǒng)中可用的目標平臺是不一樣

15、的： Mac : ios, mac, android Windows : android, win32 Linux : android 如果需要一次生成多個目標平臺的預(yù)編譯庫，可以通過多次使用 -p 參數(shù)來實現(xiàn)。例如： -p ios -p mac 會同時生成 iOS 和 Mac 兩個目標平臺的預(yù)編譯庫。,Cocos Console指令,cocos gen-simulator 示例 cocos gen-simulator -h 顯示幫助信息 cocos gen-simulator -c 刪除指定的輸出文件夾。然后生成所有可用的目標平臺的模擬器。 cocos gen-simulator -e /W

16、ork/cocos2d-x -o /MySimulator -p ios -p android 指定引擎路徑為 /Work/cocos2d-x。 然后生成 iOS 和 Android 兩個平臺的模擬器輸出到 /MySimulator 文件夾。 cocos gen-simulator -p win32 -vs 2015 -m debug 使用 VS2015 和 debug 模式生成 win32 平臺的模擬器。,Cocos Console指令,cocos gen-templates 生成用于 Cocos Framework 環(huán)境的模板。 用法： 參數(shù)說明,Cocos Console指令,cocos

17、 gen-templates 注意事項 生成的模板只能用于 Cocos Framework 環(huán)境。 生成的模板是以預(yù)編譯庫的方式使用引擎而不是源碼。 示例 cocos gen-templates 生成用于 Cocos Framework 環(huán)境的模板。生成的模板存放在引擎根目錄下的 templates 文件夾中。新生成的模板以 language-template-binary 格式命名。,Cocos Console指令,cocos upgrade 升級工程所用的Cocos引擎版本 用法：,Cocos Console指令,cocos upgrade 參數(shù)說明 注意事項 升級過程不可逆，需要根據(jù)實際

18、情況做好備份工作,Cocos Console指令,cocos upgrade 示例 cocos upgrade -h 顯示幫助信息 cocos upgrade -l js -backup-dir ./project-backup -return-error 對工程的Cocos引擎進行升級，編程語言為JavaScript，原來的工程備份到project-backup文件夾，一旦過程中出錯，返回錯誤信息,Cocos Console指令,cocos package 管理Cocos中的package，提供開發(fā)所需的各種資源 示例 cocos package search package_name 搜索特定的packa