有点懒得把图片传上来了,请移步这里看
Cocos官方论坛-wiki
CocoaChina论坛帖子
上面两个是一样的
##代码编辑器
Cocos Code IDE 2.0.0 是一个基于 IntelliJ IDEA 的跨平台IDE,专门为 Cocos2d-x Lua & JavaScript 开发人员准备,通过IDE 你可以方便的创建游戏工程、编写并且支持在不同平台上调试代码、实时查看代码被改变后的效果,最终直接发布成一个可上架的安装包。
特别告知:IDE 1.x版本的用户们,2.0.0版本并不是在1.2.0版本上的升级,而是把IDE的原有功能从Eclipse框架下迁移到Intellij IDEA的一个版本。
###为什么换框架?
![image](./mac/0927090.png)
一个字,快。无论是在敲入代码时,立刻出现的提示,还是输入错误语法时,几乎瞬时出现的警告,或者是ALT+ENTER提供的自动修复语意义,都让你在敲代码时的感受特别爽快;再加上IntelliJ IDEA的智能提示,已经在代码编辑这个领域做到极佳的体验。
IDE在1.x版本中代码提示慢,卡顿已经被大家喷出翔,而基于Eclipse框架去开解决这些问题,可改善的空间不大。
此外Google也推出了基于IntelliJ IDEA的Android Studio,对于我们这些在移动设备上混饭吃的厂商,赶紧跟进就是了。
IDE的定位为Cocos2d Lua&JavaScript 调试工具,而代码编辑和调试又是不可分的,所以现在我们会专注提高代码编辑和Debug的开发者体验上;
对于Eclipse的诸多好处,IDE只默默送上一张好人卡,拜拜不送。
###IDE 2.0.0beta开发状态
IDE在1.x版本中提供了这些主要功能:
1 新建JS/Lua工程,同时支持-x/js/quick/cocos等产品
2 代码提示、自动完成、资源提示
3 调试功能,断点设置、步进步出、堆栈、变量查看,包括模拟器和真机。
4 代码热更新
5 一键发布,支持mac/iOS/Android/win32/
以及一大堆辅助功能和UI配置等:
1 添加本地代码
2 构建自定义模拟器
3 升级引擎
4 DS-5调试
从2014.7发布1.0,到2015.2发布1.2,前后7个月时间才把这些功能慢慢累积起来的。而现在我们要把这些模块都移植过来,需要一定时间,也不是所有的功能都在一个版本发布。
###IDE 2.0.0beta版本说明
1 新建JS/Lua工程,支持-x/js/cocos(已完成),支持quick(未完成)
2 代码提示(JS已完成,Lua未完成)、自动完成(Lua未完成)
3 调试功能,断点设置、步进步出、堆栈、包括模拟器和真机(已完成)。变量查看(未完成)
4 代码热更新(未完成)
5 一键发布(未完成)
6 添加本地代码(已完成)
7 构建自定义模拟器(已完成)
8 升级引擎(未完成)
9 DS-5调试(未完成)
亲爱的开发者们,IDE此次发布2.0.0版本,我们没有提供详细操作文档和以及还有很多功能未完成,感觉很愧疚;请不要放弃我们,我们还有得救。
![image](./mac/face1.jpg)
###下载安装
分为完整安装和插件安装,`推荐插件安装`。
####1 完整安装
[Windows下载链接](http://www.cocos2d-x.org/filedown/cocos-code-ide-2.0.0-beta.exe)
[Mac下载链接](http://www.cocos2d-x.org/filedown/cocos-code-ide-2.0.0-beta.dmg)
点击下载安装即可,此版本的代码提示比插件安装版本稍慢。
####2 插件安装
[下载IntelliJ IDEA Ultimate](https://www.jetbrains.com/idea/download/)
[IDE插件](http://www.cocos2d-x.org/filedown/cocos-intellij-plugin-2.0.0-beta.zip)
需下载IDE插件和IntelliJ IDEA Ultimate(以下简称插件和IntelliJ),下载IntelliJ安装之后,通过IntelliJ界面导入到插件(具体操作看环境配置一节)。
此版本代码提示速度快,配色美观。
特别说明:IntelliJ IDEA Ultimate版本提供30天免费使用,之后要收费(貌似也可以继续免费试用,这对小伙伴们来说不是问题),请支持收费版。
##Windows环境
####环境配置
使用IDE之前,你需要在Window上搭建好开发环境。
主要是Android开发环境和安装Visual Studio。推荐Android NDK r10c以上和Visual Studio 2013。
[Cocos2d-x环境搭建教程汇总](http://cn.cocos2d-x.org/tutorial/lists?id=145)
####加载插件
如果下载了插件,在启动页面上选择Configure->Plugins->Install plugin from disk,选中插件加载;
![image](./win/configplugin.png)
加载成功如下图,点击OK,重启。
另外,从系统菜单File->Settings->Plugins也可以打开此页面
![image](./win/plugin.png)
如果要卸载插件,点击Uninsall plugin,然后重启。
####新建工程
启动IDE之后,就可以通过主页面创建工程,点击Create New Project,在弹出页面选择左侧的Cocos,一路点击Next即可(在系统菜单的File->New->Project也可以进入)
![image](./win/newproject.png)
第一次新建工程加载较慢,点击Project显示工程文件
![image](./win/newproject1.png)
遇到这个提示,点击Yes,然后查看配置引擎了解如何操作。
![image](./win/tipsengin.png)
####运行游戏
在Project区域点击右键,在菜单内找到Run ‘工程名’,点击即可
![image](./win/rungame.png)
通过系统菜单的Run->Run '工程' 以及工具栏上的绿色三角形按钮![image](./win/debugbar.png)也可以执行
第一次运行会要求你配置模拟器,请到对应章节了解
![image](./win/tipssimulator.png)
####代码提示
在Project侧边栏中点开Src文件夹,双击打开任意一个Lua或者Js文件,输入一个字符或变量,就可以看到快到飞起的代码提示。
IntelliJ官方对Js提示已经非常好用,我们延用了这个功能;`但是它对Lua的提示并未支持,IDE正在研发此功能`。
####代码调试
在Project区域点击右键,在菜单内找到Debug ‘工程名’,点击即可
![image](./win/debugmenu.png)
通过系统菜单的Run->Debug '工程' 以及工具栏上的绿色小虫按钮![image](./win/debugbar.png)也可以执行
####设置断点
在Project侧边栏中点开Src文件夹,双击打开任意一个Lua或者Js文件,在打开的文件窗口侧边单击,即可设置一个断点
![image](./win/debugpoint.png)
####查看堆栈和内存变量
在调试状态下,设置好断点,就可以进入此页面
点击Debugger窗口进入
![image](./win/debugger.png)
第一次运行会要求你配置模拟器,请到对应章节了解
![image](./win/tipssimulator.png)
####配置引擎
此功能从系统菜单File->Settings->Other Settings->Cocos Framework打开
![image](./win/filesetting.png)
配置了引擎,才能新建工程。如果你需要从创建不同引擎版本的游戏工程,先到这里配置确认,然后去新建工程。
![image](./win/configengine.png)
#####Framework Mode
这种模式是通过基于预编译库版本的引擎创建工程,这种方式创建游戏编译速度快,缺点是修改引擎源码不方便,如果你没有修改引擎的需求,推荐用这种方式。
预编译库引擎目录,需要安装Cocos Framework才有:(默认目录如下)
c:\Cocos\frameworks
#####Engine Mode
这种模式是通过基于源码的引擎创建工程,用这种方式创建游戏,你可以自由修改引擎,缺点是编译速度较慢。
####配置模拟器
从系统菜单的Run->Edit Configurations进入
![image](./win/menuconfigsimulator.png)
模拟器是运行脚本的一个空壳程序,而空壳程序的具体表现由它所运行的脚本及资源决定。
![image](./win/configsimulator.png)
如果你是基于Framework Mode创建的工程,在这个位置有通用的模拟器:(默认路径)
C:\Program Files (x86)\Cocos\cocos-simulator-bin
如果你是基于Engine Mode创建的工程,在工程根目录下,有一个runtime文件夹,包含了对应的模拟器
testlua1/runtime
####配置Android开发环境
此功能从系统菜单File->Settings->Other Settings->Cocos打开
如果你需要开发Android游戏,才需要配置这些选项。
![image](./win/configandroid.png)
如图是推荐配置,Android SDK版本取决于你需要支持的Android版本。
##Mac环境
####环境配置
使用IDE之前,你需要在Mac上搭建好开发环境。
主要是Android开发环境和安装XCode。推荐Android NDK r10c和XCode6以上。
[Cocos2d-x环境搭建教程汇总](http://cn.cocos2d-x.org/tutorial/lists?id=145)
####加载插件
如果下载了插件,在启动页面上选择Configure->Plugins->Install plugin from disk,选中插件加载;
![image](./mac/plugin.png)
加载成功如下图,点击OK,重启。
另外,从系统菜单IntelliJ IDEA->Preferences->Plugins也可以打开此页面
![image](./mac/plugininstall.png)
如果要卸载插件,点击Uninsall plugin,然后重启。
####新建工程
启动IDE之后,就可以通过主页面创建工程,点击Create New Project,在弹出页面选择左侧的Cocos,一路点击Next即可(在系统菜单的File->New->Project也可以进入)
![image](./mac/createproject.png)
第一次新建工程加载较慢,点击侧边栏Project显示工程文件
![image](./mac/project1.png)
遇到这个提示,点击Yes,然后查看配置引擎了解如何操作。
![image](./mac/tipsconfigcocos.png)
####运行游戏
在Project区域点击右键,在菜单内找到Run ‘工程名’,点击即可
![image](./mac/rightmenu.png)
通过系统菜单的Run->Run '工程' 以及工具栏上的绿色三角形按钮![image](./mac/taskbarrun.png)也可以执行
第一次运行会要求你配置模拟器,请到对应章节了解
![image](./mac/tipsconfigsimulator.png)
####代码提示
在Project侧边栏中点开Src文件夹,双击打开任意一个Lua或者Js文件,输入一个字符或变量,就可以看到快到飞起的代码提示。
IntelliJ官方对Js提示已经非常好用,我们延用了这个功能;`但是它对Lua的提示并未支持,IDE正在研发此功能`。
####代码调试
在Project区域点击右键,在菜单内找到Debug ‘工程名’,点击即可
![image](./mac/rightmenu.png)
通过系统菜单的Run->Debug '工程' 以及工具栏上的绿色小虫按钮![image](./mac/taskbarrun.png)也可以执行
####设置断点
在Project侧边栏中点开Src文件夹,双击打开任意一个Lua或者Js文件,在打开的文件窗口侧边单击,即可设置一个断点
![image](./mac/codehintjs.png)
####查看堆栈和内存变量
在调试状态下,设置好断点,就可以进入此页面
点击Debugger窗口进入
![image](./mac/debugger.png)
第一次运行会要求你配置模拟器,请到对应章节了解
![image](./mac/tipsconfigsimulator.png)
####配置引擎
此功能从系统菜单IntelliJ IDEA->Preferences->Other Settings->Cocos Framework打开
![image](./mac/menuconfig.png)
配置了引擎,才能新建工程。如果你需要从创建不同引擎版本的游戏工程,先到这里配置确认,然后去新建工程。
![image](./mac/configcocos.png)
#####Framework Mode
这种模式是通过基于预编译库版本的引擎创建工程,这种方式创建游戏编译速度快,缺点是修改引擎源码不方便,如果你没有修改引擎的需求,推荐用这种方式。
预编译库引擎目录,需要安装Cocos Framework才有:
/Applications/Cocos/frameworks
#####Engine Mode
这种模式是通过基于源码的引擎创建工程,用这种方式创建游戏,你可以自由修改引擎,缺点是编译速度较慢。
####配置模拟器
从系统菜单的Run->Edit Configurations进入
![image](./mac/menuconfigsimulator.png)
模拟器是运行脚本的一个空壳程序,而空壳程序的具体表现由它所运行的脚本及资源决定。
![image](./mac/configsimulator.png)
如果你是基于Framework Mode创建的工程,在这个位置有通用的模拟器
/Applications/Cocos/cocos-simulator-bin
如果你是基于Engine Mode创建的工程,在工程根目录下,有一个runtime文件夹,包含了对应的模拟器
newideujs1/runtime
####配置Android开发环境
此功能从系统菜单IntelliJ IDEA->Preferences->Other Settings->Cocos打开
如果你需要开发Android游戏,才需要配置这些选项。
![image](./mac/configandroid.png)
如图是推荐配置,Android SDK版本取决于你需要支持的Android版本。
###FAQ,适用于2.0版本,适用于2.0版本,适用于2.0版本
####安装运行
1 哪个版本的IDE最好用?
1.x的版本是基于Eclipse的,功能较全,但是使用起来比较卡。2.x的版本是基于IntelliJ的,速度快,缺lua提示和打包功能。
推荐Lua开发者使用1.2版本;JS开发者使用2.0,下载IntelliJ官方的旗舰版(Ultimate),然后安装IDE插件。
[IDE1.x版本下载](http://www.cocos2d-x.org/download/version)
[IDE2.0插件](http://www.cocos2d-x.org/filedown/cocos-intellij-plugin-2.0.0-beta.zip)
2 Mac上无法打开IDE。
Mac系统有一个设置页面,按图所示设置一下。
![image](./mac/macsetting.jpeg)
3 为什么要装旗舰版?
老版本的智能提示是基于Elipse的提示机制扩展出来的,现在迁移到IntelliJ,要再扩展一次;旗舰版的智能提示已经足够好,而且IntelliJ就靠这个收费,我们在社区版本的基础上开发,赶上它自身的效果很难;所以推荐大家用旗舰版装插件。
4 为什么不直接发布旗舰版IDE?
因为旗舰版是收费的,我们没有拿到授权去发布这个版本,所以提供了IDE插件,给大家使用。
####模拟器问题
1 模拟器运行崩溃。
首先请先检查一下配置的模拟器路径,到模拟器目录下双击打开对应的可执行程序(包括ipa/apk,可运行在对应的iOS和Android模拟器
中或真机中),如果打开也会崩溃,说明需要重新构建自定义模拟器。右键点击工程,在弹出的菜单中选择Cocos工具->构建自定义模拟器,
按提示一步步操作,直到模拟器编译成功。
2 模拟器windows版本,点击区域偏移一个菜单的距离。
这个Bug是glfw造成的,负责模拟器的筒子已经说了,把菜单移到系统菜单里解决,请耐心等待下一个版本。
3 模拟器关闭后,IDE无响应。
这是一个bug,模拟器关闭时,应该给IDE发一个通知,已经记下来,待解决。
建议大家通过IDE的Stop Debug按钮来关闭模拟器。
####调试问题
1 js3.6版本无法调试,无法下断点?
基于cocos2d-js-v3.6引擎创建的工程,调试的时候无法下断点,这是引擎的一个bug。
请升级到cocos2d-js-v3.6.1解决,十分抱歉。
2 设置断点之后,调试时不会停在断点上?
首先建议重新编译模拟器,因为某些引擎版本创建的默认模拟器不支持IDE调试。
![image](./faq/makesimulator.jpg)
2 怎么调试web版本
右键点击基于工程中的index.html文件,通过菜单Open In Browser在浏览器中打开js工程进行调试。
3 不能访问端口6050或者6060?
此端口被其他程序占用,导致IDE无法与模拟器连接;请到工程目录下找到config.json文件夹中的内容。
![image](./faq/configjson.png)
然后重新开始调试。
4 调试时报错-timeout
模拟器和IDE之间调试的时候,现在不太稳定,最近我们解决了2个这方面通讯的问题,能缓解这个问题。等我们再查一下看。
5 调试报错-No file found at script/jsb_boot.jsc. Possible missing file
此报错对调试和开发没有任何影响,属于引擎内部log,请忽略。
####新建导入工程
1 不支持新建Quick工程
目前还不支持Quick,这块和Quick的负责人正在沟通。你们知道Quick已经整合到Cocos2d-x里面,和lua合并了,所以接下来还要不要单独支持Quick,加一堆配置什么的,还没有最后定下来,有新的进展我们会尽快通知大家。
2 创建工程失败,请查看cocos console,是什么问题?
a 请确认python已经安装,并能通过命令行调用。
b 查看IDE的日志窗口,如果有这样的报错
Read json file null failed, the reason is:null
请到配置引擎,设置成Engine Mode模式
3 console新建工程,怎么导入工程(包括Studio创建、Cocos Console创建以及Cocos创建的工程)?
导入功能在下个版本就能提供。不过要注意,console新建工程记得加-t runtime参数(cocos new -l js/lua -t runtime),才能被IDE支持。
http://cn.cocos2d-x.org/article/index?type=code-ide&url=/doc/cocos-docs-master/manual/code-ide/install-idea-zh.md
4 导入工程时,config.json文件找不到?
有些早起版本创建的工程,不支持IDE,需从其他工程中拷贝一个config.json文件过来。
5 导入工程,出现out of memory。
开发者的资源变增大以后,通过IDE调试可能会出现此问题,把Xmx调大一点再使用。
![image](./faq/outofmemory.png)
####打包发布
1 如何打包apk/如何打包html5
目前还不支持打包功能,建议可以用cocos命令,自行打包。
cocos compile -p android
cocos compile -p web
####各种问题
1 构建模拟器失败?
有很多种情况会导致构建模拟器失败,首先打开工程目录下frameworks/runtie-src/proj.win32文件夹,打开 工程名.sln文件,在Visual Studio中编译,查看编译失败的错误提示;根据提示解决问题;在Visual Studio编译成功之后,回到IDE,再次构建自定义模拟器。
2 没有代码提示?
Lua提示我们还没做,十分抱歉;JS提示要安装IntelliJ旗舰版(ULTIMATE)才有,装了之后,提示速度快到飞起,虽然要收费,对你来说这应该不是问题。
3 IDE就是个垃圾!
我们非常理解你在使用IDE过程中遇到问题的心情,不过这样的信息不能解决你的麻烦。不如稍微花点时间,把你的操作系统及版本号,IDE版本,以及发生问题的情况描述一下提交上来,如果其他人也许遇到同样的问题,马上就能告诉你解决方案了。实在不行,还有我们官方的技术支持团队给你帮助http://support.cocos.com
4 lua绑定C++代码,怎么用
不知道你问的是lua怎么绑定C++代码,还是绑定完之后怎么用。前者的话,我记得有篇教程
[链接在这里](http://www.cocos.com/doc/article/index?type=code-ide&url=/doc/cocos-docs-master/manual/code-ide/function-guides/add-3rd-party-lib/binding-custom-class-to-lua/zh.md)
如果是绑定完成,你只需要在工程上点击右键,使用Cocos工具->构建自定义模拟器,重新编译一个模拟器,就在里面使用你的C++代码了。