openeuler/binder

keybinder | openEuler Docker镜像文档

镜像概述

keybinder Docker镜像是基于openEuler构建的官方镜像，用于提供keybinder库功能。keybinder是一个用于注册全局键盘快捷键的库，适用于基于GTK的应用程序和X Window系统。本仓库可免费使用，且不受每用户速率限制。

维护者

openEuler CloudNative SIG

获取帮助

• openEuler CloudNative SIG
• openEuler 社区

支持的标签及对应Dockerfile链接

每个binder镜像的标签由binder版本和基础镜像版本组成，详情如下：

核心功能与特性

• 提供全局键盘快捷键注册能力
• 支持基于GTK的应用程序集成
• 兼容X Window系统
• 基于openEuler稳定版构建，确保系统兼容性

使用场景

• 开发需要全局快捷键功能的GTK应用程序
• 在无物理显示环境中测试图形应用的键盘交互
• 构建依赖keybinder库的容器化应用

使用方法

1. 拉取镜像

根据需求选择对应的{Tag}标签拉取镜像：

bash
docker pull openeuler/binder:{Tag}

例如拉取0.3.2-oe2403sp1版本：

bash
docker pull openeuler/binder:0.3.2-oe2403sp1

2. 启动交互式shell

启动容器并进入交互式shell，用于运行基于keybinder的代码：

bash
docker run -it --rm openeuler/binder:{Tag} bash

3. 安装X虚拟帧缓冲区(Xvfb)

由于keybinder依赖X11环境，需安装虚拟X服务器：

bash
dnf install xorg-x11-server-Xvfb

4. 启动Xvfb服务器

在后台启动Xvfb虚拟显示服务：

bash
Xvfb :99 -screen 0 1024x768x24 &

此命令在显示编号:99上启动Xvfb，分辨率为1024x768，色深24位。

5. 设置DISPLAY环境变量

将图形应用定向到Xvfb虚拟显示：

bash
export DISPLAY=:99

6. 示例：最小化keybinder程序

创建测试代码

创建test.c文件，内容如下：

c
#include <gtk/gtk.h>
#include <keybinder.h>

void my_callback(const char *keystring, void *user_data) {
    g_print("Hotkey '%s' activated!\n", keystring);
}

int main(int argc, char *argv[]) {
    gtk_init(&argc, &argv);
    keybinder_init();
    keybinder_bind("<Ctrl><Alt>t", my_callback, NULL);
    g_print("Listening for Ctrl+Alt+T...\n");
    gtk_main();
    return 0;
}

编译程序

使用keybinder和GTK3库编译代码：

bash
gcc test.c \
  -I/usr/include/gtk-3.0 \
  -I/usr/local/include/keybinder-3.0 \
  $(pkg-config --cflags --libs gtk+-3.0) \
  -L/usr/local/lib -lkeybinder-3.0 \
  -Wl,-rpath=/usr/local/lib \
  -o keybinder

运行程序

bash
./keybinder

程序将连接到Xvfb虚拟显示并监听Ctrl+Alt+T快捷键。

问题与反馈

如遇问题或需要特殊功能，请在openeuler-docker-images提交issue或pull request。