AWTK Go 语言绑定笔记

理论上 AWTK支持 Go 语言并不难， AWTK 已经支持 jerryscript、nodejs、quickjs、lua、python、java、minijvm 和 cpp 等语言的绑定。不过每种语言都有自己的特性，所以每次增加新的语言，也是对 AWTK 绑定机制的考验和完善。

这次实现 Go 语言绑定大概花了两天时间。一天时间用来写代码生成器，一天时间用来写 scriptable 为 custom 的函数和示例代码。Go 语言调用 C 语言的函数有些特殊的要求，所以对 AWTK 的部分 API 做来一些扩展或改进：

AWTK 中部分属性使用了位域。如：

  
  uint8_t alt : 1;
  
  uint8_t ctrl : 1;
  
  uint8_t shift : 1;

为此采用了两种方式去解决。

方案 1：如果结构的实例数量不大时，使用其它数据类型代替（如 bool_t)。如：

  
  bool_t alt; 
  
  bool_t ctrl;
  
  bool_t shift;

方案 2：如果结构的实例数量大时，提供相应的 get 函数，代替直接访问成员。如：

bool_t widget_get_visible(widget_t* widget);

方案：提供相应的 get 函数，代替直接访问成员。如：

typedef union _color_t {
  
  rgba_t rgba;
  
  uint32_t color;
} color_t;


uint32_t color_get_color(color_t* c);

AWTK 中的 widget_set_visible 由于历史原因弄成了可变参数。

方案：只好做些修改：

#ifdef AWTK_GO
ret_t widget_set_visible(widget_t* widget, bool_t visible);
#else
ret_t widget_set_visible(widget_t* widget, bool_t visible, ...);
#endif

AWTK 中有些结构的成员名为 type，直接访问会造成编译错误。

方案：提供相应的 get 函数，代替直接访问成员。

int event_get_type(event_t* event);

方案：将函数和函数的上下文合并成一个对象，转递给 C 语言，由 C 语言的函数反过来调用 Go 的包装函数。

type OnTimerFunc func(ctx interface{}) TRet

type OnTimerInfo struct {
	onTimer OnTimerFunc
	ctx     interface{}
}

//export GoOnTimer
func GoOnTimer(ctx unsafe.Pointer) C.int {
	info := gopointer.Restore(ctx).(OnTimerInfo)
	ret := info.onTimer(info.ctx)
	fmt.Println("GoOnTimer", info, ret)

	return C.int(ret)
}

func AddTimer(onTimer OnTimerFunc, ctx interface{}, duration uint32) uint32 {
	c := OnTimerInfo{onTimer: onTimer, ctx: ctx}
	p := gopointer.Save(c)

	id := C.wrap_add_timer(p, C.uint32_t(duration))

	return uint32(id)
}

extern int GoOnTimer(void* ctx);

static ret_t timer_info_on_destroy(void *data) {
  timer_info_t *item = (timer_info_t *)data;
  GoReleasePointer(item->ctx);
  return RET_OK;
}

static ret_t wrap_on_timer(const timer_info_t* info) {
  return (ret_t)GoOnTimer(info->ctx);
}

static uint32_t wrap_add_timer(void* ctx, uint32_t duration) {
  uint32_t ret = timer_add(wrap_on_timer, ctx, duration);
  if(ret == TK_INVALID_ID) {
    GoReleasePointer(ctx);
  } else {
    timer_set_on_destroy(ret, timer_info_on_destroy, NULL); 
  }

  return ret;
}

最早枚举类型直接当作 int 类型处理。

type TRet int

const (
	RET_OK              = C.RET_OK
	RET_OOM             = C.RET_OOM
	RET_FAIL            = C.RET_FAIL
	RET_NOT_IMPL        = C.RET_NOT_IMP
)

但是单元测试会失败：

assert.Equal(t, win.SetText("Hello"), RET_OK)

    awtk_test.go:17: 
        	Error Trace:	awtk_test.go:17
        	Error:      	Not equal: 
        	            	expected: awtk.TRet(0)
        	            	actual  : int(0)
        	Test:       	TestSetGet

于是在常量前面增加一个类型。一切正常了：

type TRet int

const (
	RET_OK             TRet = C.RET_OK
	RET_OOM            TRet = C.RET_OOM
	RET_FAIL           TRet = C.RET_FAIL
	RET_NOT_IMPL       TRet = C.RET_NOT_IMP
)

• import “C” 之前不能有空行

import "C"

整个支持 Go 语言绑定过程还是很顺利也很有趣的。刚开始接触 Go 语言，初步感觉 Go 语言是很好用的，和 C 语言结合很方便。