近来被cocos code ide来调试和开发cocos2d-x for lua项目搞的确实的比较蛋疼，真心不想在这里吐槽目前官方团队发布的版本是多么的难用,在前段时间实在忍无可忍的情况下在QQ群里问了一下最新的cocos code ide 什么时候发布得到的答案是9月份,在卡顿和各种系统下各种疑难杂症的情况下,不能让这样的工具来影响自己的开发效率,我也最终放弃使用cocos code ide改到比较老一点的ZeroBrane Studio下去开发脚本了,其实这个工具比较轻量级也不会卡顿,唯一的缺憾是不支持cocos2d-x api代码提示,也想了下直接通过官方的文档然后写个脚本支持来扩展对cocos2d-x api的支持.对学习zerobrane studio自定义代码提示做一个简短的记录.
需要提示的API文件格式
需要提示api文件如下：
{
{
test = {
type="lib or class/function",
description="这里是描述",
args="(参数逗号分割)",
returns="(返回的类型)",
childs={ --这里是类型包含的子函数或值
bar = {
type="function",
description="这里是方法的描述",
valuetype="返回值的类型",
}
},
inherits="父类型"
}
}
}
###api lua文件 table键值介绍： 对应自定义lua文件可使用table键描述
- type: 类型值如下
- keyword: 需要描述语言的关键字符,如：do 、end
- class and lib: 一组包含方法和属性的类型
- value: 描述值可以是一个常量
- function:接受参数的函数来描述(args)和返回值(返回)
- method:描述方法调用；方法类似于函数，也接受参数和返回值和值类型。唯一的区别是，method是在打":“时提示,而function是在打”.“和”:“后提示。
- description: 方法或类的注释简短说明
- args(可选): 字符串参数 如：”(file:file)“
- returns(可选): 字符串，返回值类型,如："(boolean|nil)”
- childs(可选):table类型,当前模块或类所包含的子类或方法
- valuetype(可选):字符串，返回值的类型
- inherits(可选): 字符串,当前模块继承的模块
引用自定的API lua文件
在安装程序interpreters/目录下创建lua文件，如interpresters/Cocos2d.lua,然后在其中api健对应table值中增加"cocos2d":
return {
name="Cocos2d-x",
description = "这里是一个cocos2d-x api",
api={"cocos2d","baselib"},
......
}