【cocos2d-js系列问题】cocos2d HTML5和JSB接口差异，已知的兼容bug

用cocos2d-js开发游戏确实很方便，但在web browser 下运行与打包成app发布到移动设备上运行却是两码事。


总结了cocos2d-x javascript binding（后面简称jsb）和cocos2d-js（后面简称h5）技术开发的原因，这篇总结一下半年来遇到的一些问题。希望能帮到遇到相同问题的人。


jsb和h5开发遇到的问题可以分为下面这几类：


javascript语言本身的坑以及对语言不熟悉造成的使用上的错误;
引擎本身的bug或者API不兼容;
jsb和h5实现机制不同导致代码在浏览器里和native应用里行为不一致;
移动浏览器上只能使用Canvas模式限制了一些功能;




HTML5和JSB接口差异，往往都是我们不经意间造成了这样那样的BUG，

这里列举一些已知的兼容bug，大家开发时可以稍加注意一下：

1、MenuItemImage在HTML5中可以缺省第二个图片，但在JSB中不能缺省，否则可以能出现闪退现象；
2、MenuItemSprite在HTML5中可以缺省第二个参数，但在JSB中不能缺省，否则该节点可能无法显示；
3、MenuItem在HTML5和JSB的表现不一样。setCallback方法在HTML5下有效，但在JSB中却无效；initWithCallback方法在HTML5下接受两个参数，但在JSB下只能接受一个参数，间接导致了扩展MenuItem类时，无法直接在调用this._super()时设置点击的监听函数；
4、HTML5版本在使用addChild时不指定层级关系（第二个参数：深度），同一层多个节点会保持一个叠加顺序，但在JSB中则会出现闪烁，节点之间的叠加顺序不断改变。建议在写HTML5时，每次addChild的时候指定其层级关系，也就是深度，这样能避免在打包成Android平台的时候出现BUG。
5、UI Editor编辑的TextFiled在JSB中显示正常，但在HTML5环境下会出现位置错乱，而且不显示默认的place holder，必须先setString("")一下；
6、TiledMap在JSB中运行正常，但在HTML5中每个瓦片之间会出现黑线；
7、GLProgram的HTML5和JSB接口有较大的差异，例如initWithVertextShaderByteArray和setUniformLocationF32在JSB中没有对应实现。