重磅消息!poco框架正式支持Cocos-Creator啦。目前支持最新的2.2.1版本,本文将作为教程,引导大家如何在Cocos-Creator平台下接入Poco-SDK。
Poco-SDK集成官方教程
Cocos-Creator平台下,Poco-SDK集成的官方教程链接为:
poco.readthedocs.io/en/latest/s…
下文将针对此部分教程详细进行讲解。
下载Poco-SDK
首先我们需要下载Poco-SDK的源码到我们的本地地址,直接使用如下命令即可:
# 从GitHub上克隆源码到本地 git clone https://github.com/AirtestProject/Poco-SDK 复制代码
或者直接上GitHub下载源码zip,然后解压即可:
复制SDK文件
在下载好的源码中,打开Poco-SDK/cocos-creator
目录,然后将该目录下的整个Poco
文件夹复制到待测游戏项目的assets/scripts
目录下。
编辑Cocos Js引擎的配置文件
因为SDK
需要WebSocketServer
的支持,所以我们需要开启WebSocketServer
模块。 需要注意的是,WebSocketServer
已经被cocos creator 2.2.1
默认支持,但是默认是没有开启的,所以我们需要按照如下步骤去开启它:
- 进入引擎目录,修改ccConfig.h文件,如图所示
- 编辑第62行,把
#define USE_WEBSOCKET_SERVER 0
改为#define USE_WEBSOCKET_SERVER 1
在编辑器中添加引入脚本
如上图所示在你的游戏项目中,选择asserts/Scripts/某个不会销毁的脚本
,并在该脚本的onLoad
函数中,添加如下脚本:
onLoad:function(){ var poco = require("Poco") //此处添加你自己的Poco.js文件的路径 window.poco = new poco(); cc.log(window.poco); }, 复制代码
注意,红框圈起来的,要填写你自己的Poco.js的相对路径。
构建-编译-运行
然后你就可以开始编译你的项目了。注意 Airtest-IDE 还没有支持Windows版的包体,目前只支持Android版;但是如果是纯写Poco脚本,不使用Airtest-IDE的辅助工具的话,几乎所有平台都可以支持。因此我们要打包为Android安装包,接下来再使用Airtest-IDE录制脚本。
在Poco Assistant 中选择Cocos-Js
在IDE面板左侧的Poco Assistant窗口中,下拉选择Cocos-Js,然后就能看到生成的UI树了。
温馨提示
目前版本刚刚发布,可能会有Bug或者其它建议,欢迎到 github.com/AirtestProj… 上发布issue。
而且通过修改ccConfig.h文件来开启WebSocketServer的方式不太优雅,应该通过修改项目配置文件来设定。Airtest-IDE 的辅助录制工具还没有支持Cocos Win版,目前只支持Android版。
拓展(poco当前支持的平台)
Poco在大多数平台中,需要 事先接入Poco-SDK才可正常使用 ,在少数平台(如Android原生APP)可直接使用Poco,目前支持平台如下:
平台 | Airtest | Poco |
Cocos-Creator | √ | 需要接入 |
Cocos2dx-js, Cocos2dx-lua | √ | 需要接入 |
Unity3D | √ | 需要接入 |
Native Android APP | √ | 直接使用 |
Native iOS APP | √ | 直接使用 |
Egret | √ | 需要接入 |
Other engines | √ | 可自行接入 |
WeChat Applet&webview | √ | 随着微信更新可能会失效 |
Windows, MacOS | √ | 敬请期待 |
Netease | √ | 需要接入 |