使用pomelo做服务端开发时，无论什么客户端，只要能遵循与服务端的线上协议，就能够与服务端建立通信。pomelo内建提供的sioconnector和hybridconnector都定义了自己的协议格式，其中sioconnector用于socket.io的通信，hybridconnector则用来处理websocket和tcp的连接通信。为了方便客户端的开发，pomelo提供了部分平台的客户端SDK，这里主要会介绍一下用于Web端的JavaScript的SDK以及基于C语言的libpomelo的使用。

Web端JavaScript开发库

对于浏览器来说，HTML5中已经支持了websocket，因此使用支持websocket的浏览器可以直接与服务端的hybridconnector建立通信。而对于比较旧的浏览器来说，还没有支持websocket的，可以使用基于socket.io的方式进行与服务端建立连接。因此，对于Web端，pomelo提供了两套开发库，分别适用于支持websocket的浏览器和不支持websocket的浏览器，这两套开发库的链接如下，适用于socket.io的pomelo-jsclient-socket.io以及适用于websocket的pomelo-jsclient-websocket。

socket.io的客户端开发库

对于使用socket.io的客户端SDK来说，其依赖socket.io-client, 由于这个库在使用component进行管理时有bug，因此在使用的时候，是直接引用其提供的js文件，具体引用的js文件为socket.io-client.js。对于pomelo-jsclient-socket.io来说，同样也是直接使用引用其js文件，也即是pomelo-client.js。在直接引用这两个文件后即可使用pomelo的调用了。

websocket的客户端开发库

对于使用websocket的客户端SDK来说，使用了component进行管理，因此只需要配置一个component.json文件，里面配置相应的依赖，然后运行

$ component install
$ component build

component会自动寻找依赖，完成客户端js的打包。用户只需要引用编译后的build.js即可，然后就可以使用pomelo的调用了。关于component的使用，请参考component的wiki。我们的例子chatofpomelo-websocket，这里就是使用了component来管理前端js的，可以作为用户使用的一个参考。

#### web端API简介

无论是socket.io的还是websocket的，都提供了统一的API，下面对这些API进行简单的介绍。

pomelo.init(params, cb)

这是往往是客户端的第一次调用，params中应该指出要连接的服务器的ip和端口号，cb会在连接成功后进行回调;

pomelo.request(route, msg, cb)

请求服务，route为服务端的路由，格式为"..", msg为请求的内容，cb会响应回来后的回调;

pomelo.notify(route, msg)

发送notify，不需要服务器回响应的，因此没有对响应的回调，其他参数含义同request;

pomelo.on(route, cb)

这个是从EventEmmiter继承过来的方法，用来对服务端的推送作出响应的。route会用户自定义的，格式一般为"onXXX";

pomelo.disconnect()

这个是pomelo主动断开连接的方法。

libpomelo

libpomelo 是 pomelo 的 c 客户端，支持pomelo 0.3版本以后的协议

依赖

libuv 跨平台开发库，主要使用了网络I/O和线程
jansson c 的 json 解析库

使用

创建客户端实例

// create a client instance.
pc_client_t *client = pc_client_new();

添加事件监听

// add some event callback.
pc_add_listener(client, "onHey", on_hey);
pc_add_listener(client, PC_EVENT_DISCONNECT, on_close);

监听器的定义

// disconnect event callback.
void on_close(pc_client_t *client, const char *event, void *data) {printf("client closed: %d.\n", client->state);
}

连接到服务器

struct sockaddr_in address;memset(&address, 0, sizeof(struct sockaddr_in));
address.sin_family = AF_INET;
address.sin_port = htons(port);
address.sin_addr.s_addr = inet_addr(ip);// try to connect to server.
if(pc_client_connect(client, &address)) {printf("fail to connect server.\n");pc_client_destroy(client);return 1;
}

发起一个 notify 请求

// notified callback
void on_notified(pc_notify_t *req, int status) {if(status == -1) {printf("Fail to send notify to server.\n");} else {printf("Notify finished.\n");}// release resourcesjson_t *msg = req->msg;json_decref(msg);pc_notify_destroy(req);
}// send a notify
void do_notify(pc_client_t *client) {// compose notify.const char *route = "connector.helloHandler.hello";json_t *msg = json_object();json_t *json_str = json_string("hello");json_object_set(msg, "msg", json_str);// decref json stringjson_decref(json_str);pc_notify_t *notify = pc_notify_new();pc_notify(client, notify, route, msg, on_notified);
}

发起一个 requst 请求

// request callback
void on_request_cb(pc_request_t *req, int status, json_t *resp) {if(status == -1) {printf("Fail to send request to server.\n");} else if(status == 0) {char *json_str = json_dumps(resp, 0);if(json_str != NULL) {printf("server response: %s\n", json_str);free(json_str);}}// release relative resource with pc_request_tjson_t *msg = req->msg;pc_client_t *client = req->client;json_decref(msg);pc_request_destroy(req);// stop clientpc_client_stop(client);
}// send a request
void do_request(pc_client_t *client) {// compose requestconst char *route = "connector.helloHandler.hi";json_t *msg = json_object();json_t *str = json_string("hi~");json_object_set(msg, "msg", str);// decref for json objectjson_decref(str);pc_request_t *request = pc_request_new();pc_request(client, request, route, msg, on_request_cb);
}

API 接口

创建一个新的pomelo client实例

pc_client_t *pc_client_new();

停止客户端的连接
该接口适合于在libuv子线程中调用，然后在主线程中，通过 pc_client_join来wait子线程退出

void pc_client_stop(pc_client_t *client);

销毁客户端的连接

void pc_client_destroy(pc_client_t *client);

主线程中调用等待子线程的退出

int pc_client_join(pc_client_t *client);

创建一个request请求实例

pc_request_t *pc_request_new();

销毁一个request请求实例

void pc_request_destroy(pc_request_t *req);

连接到服务器，在连接过程中会创建子线程用于处理网络I/O

int pc_client_connect(pc_client_t *client, struct sockaddr_in *addr);

销毁pc_connect_t类型的实例

void pc_connect_req_destroy(pc_connect_t *conn_req);

发起一个request请求

int pc_request(pc_client_t *client, pc_request_t *req, const char *route,json_t *msg, pc_request_cb cb);

创建一个notify请求实例

pc_notify_t *pc_notify_new();

销毁一个notify请求实例

void pc_notify_destroy(pc_notify_t *req);

发起一个notify请求

int pc_notify(pc_client_t *client, pc_notify_t *req, const char *route,json_t *msg, pc_notify_cb cb);

添加一个事件监听

int pc_add_listener(pc_client_t *client, const char *event,pc_event_cb event_cb);

删除一个事件监听

void pc_remove_listener(pc_client_t *client, const char *event,pc_event_cb event_cb);

触发一个事件监听

void pc_emit_event(pc_client_t *client, const char *event, void *data);

编译

前提条件

下载 gyp
gyp 其实是一个python写的脚本，并不需要安装，只需要下载下来，可以执行gyp里面的脚本就行

Mac 环境

./pomelo_gyp
xcodebuild -project pomelo.xcodeproj

IOS 环境

./pomelo_gyp -DTO=ios
./build_ios

IOS 模拟器

./pomelo_gyp -DTO=ios
./build_iossim

Linux 环境

./pomelo_gyp
make

Windows 环境

在libpomelo项目跟目录下
打开git bash，敲入

mkdir -p build
git clone https://github.com/martine/gyp.git build/gyp

之后，打开windows cmd命令行窗口，并且cd切换目录到libpomelo跟目录下面，敲入

build\gyp\gyp.bat --depth=. pomelo.gyp -Dlibrary=static_library -DTO=pc

之后就会生成pomelo.sln，使用visual studio打开即可进行编译

Android 环境

开发前提条件：
windows:

安装 Cygwin with make (select make package from the list during the install).
android adt eclipse 这个只要下载最新的 android sdk 里面就有一个配置好环境的 eclipse

环境搭建：
1: 新建一个 android 工程，比如新建一个 test 的工程，建完之后如图：

2: 然后在项目根目录下面，新建一个 jni 文件夹
然后里面添加一个 Android.mk 文件
在 Android.mk 里面敲入

LOCAL_PATH := $(call my-dir)include $(CLEAR_VARS)LOCAL_MODULE := game_sharedLOCAL_MODULE_FILENAME := libgame               LOCAL_WHOLE_STATIC_LIBRARIES := pomelo_staticinclude $(BUILD_SHARED_LIBRARY)LOCAL_CFLAGS    := -D__ANDROID__ $(call import-module,libpomelo)

这样子就表示将在 android 中使用 libpomelo 编译而来的 .so 库

3: 然后在项目目录下面新建一个 pomelo 的文件夹，然后从 github 上把最新的 libpomelo 下载到刚刚建的 pomelo 文件夹下面

4: 然后打开终端（windows 则打开 cygwin）
在项目目录下敲入
ndk-build NDK_MODULE_PATH=/android项目绝对路径/pomelo/
即可完成编译

5: 如果是要结合cocos2d-x进行开发，那么只需要把 libpomelo 放在 /cocos2dx绝对路径/cocos2dx/platform/third_party/android/prebuilt 文件夹里面，然后执行 ./build_native.sh 即可
具体可参考 cocos2d-x android

pomelo客户端开发相关推荐

C# 海康DVR客户端开发系列（2）—— 封装API
前言从上篇文章(10月4日)到本篇文章截止到今天(10月22日)一直在做这个SDK翻译工作,耗时2周半,代码超过1万行,约有三分之二的行数是注释.由于工作忙也只能一天抽出那么半个小时一个小时来整理, ...
移动互联网服务客户端开发技巧 ( Webview及正则)
随着微博.LBS 等移动互联网服务的火爆普及,越来越多的苹果开发者希望制作各网络服务的 iPhone 客户端.CocoaChina 会员 "qdvictory" 的<基于网络 ...
帮助创建未来的 .NET 客户端开发
针对 .NET 客户端开发,Microsoft 正在开发一些革命性的工具和一个易于实现的应用程序框架(代号"Acropolis"),以便开发人员能够更快速地创建.管理和部署 Mic ...
Android:Socket客户端开发，Android 的Socket客户端优化，Android非UI线程修改控件程序崩溃的问题
一.Android:Socket客户端开发创建一个工程我们要做的是按下按键之后,去往服务器 (服务器) 或者我们自己写的服务器 ,给他发送一些预定好的东西然后打开操作界面然后修改一下你要发送 ...
行代码入门python_新浪微博Android客户端开发视频教程（36讲）
教程名称:新浪微博Android客户端开发视频教程(36讲) 课程目录: [IT教程网]新浪微博Android客户端介绍 [IT教程网]新浪微博Android客户端相关资料 [IT教程网]新浪微博An ...
《『若水新闻』客户端开发教程》——01.课程介绍
内容介绍 2011年,若水工作室制作了<Android开发从零开始>系列课程,感谢大家的鼓励和支持.为了进一步提高Android开发培训水平,2012年若水工作室又倾心制作的项目实战视频『 ...
智能客户端ios_为什么现在的客户端开发越来越不吃香了
这是Kevin的第 672 篇原创,持续日更,做产品经理的创业斜杠青年. 年底上线APP,是我们今年PMTalk在产品研发上的一个最终目标. 启动这个项目前,团队.和身边创业朋友都不看好这件事,因为客 ...
SpringBoot——实现WebService接口服务端以及客户端开发
文章目录一.服务端代码开发 1.pom依赖 2.接口类 3.接口实现类 4.webservice配置文件 2.客户端开发 (1)pom依赖 (2)封装客户端方法clientUtil (3)调用接口类 ...
音视频开发（18）---视频监控客户端开发（IP Camera）总结
视频监控客户端开发(IP Camera)总结首先看下项目需求: 1.最多同时支持16路高清音视频同时显示. 2.窗口模式,全屏,1窗口,4窗口,9窗口,16窗口. 3.播放控制,开始播放 ...

pomelo客户端开发