Gaim Plugin开发

Gaim Plugin开发

一.     插件描述

      Gaim是基于GTK+2的多平台的即时通信的客户端。它支持很多常见的协议，包括：MSN,Yahoo,ICQ,QQ,JABBER还有我在做的淘宝旺旺.如果需要为一个新的im 协议做一个插件,那么看下面的简单描述,详细的内容只能等再进一步补充了.

二.     接口定义

按照GAIM PLUGIN API的要求定义接口函数和接口变量.

 

1. 定义Gaim Plugin句柄

static GaimPlugin *ww_plugin = NULL;

 

此结构定义在Plugin.h中说明:

结构的成员变量 GaimPluginInfo *info将在初始化中指向插件详细信息的指针.

2.定义插件协议信息

static GaimPluginProtocolInfo prpl_info= {

..

..

..

}

此结构定义了所有协议函数的人口以提供给GAIM调用. GAIM在事件触发的时候来这个结构里面查找相应的函数,如用户在GAIM使用此插件在界面上点击登陆时候,GAIM将在此查找到登陆的函数进行调用.

注意: list_icon函数不能为空

3. 定义插件详细信息

       static GaimPluginInfo info ={

..

..

}

此结构定义在Plugin.h中说明:

其中主要的有插件ID,插件的名字,插件的版本,插件类型(说明是协议插件或者是普通插件),插件协议信息(定义消息处理)

 

4.定义初始化函数

static void init_plugin(GaimPlugin *plugin){

  ww_plugin = plugin; //将plugin指向前面定义的ww_plugin

}

 

 

5.定义插件入口函数

 

GAIM_INIT_PLUGIN(ww, init_plugin, info)

 

6.源代码.

   不知道怎么放,参看gaim代码里面的Protocol例子吧

 

三. 编译安装

  看一下Makefile吧

all:install

libwangwang.so:wwang.o

        ld -shared -o libwwang.so wwang.o

wwang.o:wwang.c

        gcc -fPIC -DGAIM_PLUGINS -Wall -g -DVERSION=/" 1.1.1 /" - I. -I../../src -I.. -I/usr/include/gtk-2.0 -I/usr/lib/gtk-2.0/

include -I/usr/include/glib-2.0 -I/usr/lib/glib-2.0/include -c wwang.c -o wwang.o

install: libwangwang.so

        cp libwwang.so /home/wee/bin/gaim/lib/gaim/

三.     进一步处理

   编译完的so被拷贝到GAIM安装目录下后,启动GAIM选新建一个帐户,然后可以在协议列表里面看到你所定义的插件的名字,可以输入用户名和密码保存,当然登陆的时候,点登陆按钮什么也不没做,进一步的处理是根据你要连接的IM服务器的协议针对每个动作进行处理,如登陆退出,增删改好友,组,收发消息. 可以参考的例子除了GAIM自身带的MSN,JABBER,yahoo的插件外,还有OPENQ..