# awtk-java

**Repository Path**: zlgopen/awtk-java

## Basic Information

- **Project Name**: awtk-java
- **Description**: awtk-java
- **Primary Language**: Unknown
- **License**: LGPL-2.1
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-12-21
- **Last Updated**: 2025-06-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# awtk-java

ZLG 开源 GUI 引擎 [awtk](https://github.com/zlgopen/awtk) 针对 JAVA 的绑定。

## 为什么要支持 JAVA

JAVA 运行环境体积很大，而且自己有强大的 GUI 系统。AWTK 为什么要支持 JAVA 的绑定呢：

* 首先这是一件很好玩的事情。

* JAVA 是一个典型的静态类型语言，希望支持 JAVA 绑定后，再支持 C#/Go/Rust 应该不难了。

* JAVA 是从嵌入式开发来的。嵌入式 Linux 系统用 J2ME + AWTK 或 minijvm + AWTK 也是有趣的尝试。

## 准备

1. 获取 awtk 并编译

```
git clone https://github.com/zlgopen/awtk.git
cd awtk; scons; cd -
```

> AWTK 的编译环境请参考 AWTK 的文档。

2. 获取 awtk-java 并编译

* 获取代码

```
git clone https://github.com/zlgopen/awtk-java.git
cd awtk-java
```

* 安装 [JDK](https://www.oracle.com/java/technologies/downloads/)。

* 安装 [Maven](https://maven.apache.org/)。

* 根据平台修改 env_xxx.sh，设置 JAVA_HOME 等环境变量。

* 编译 

```
make
```

> 如果系统中没有 make 命令，可以手工执行 make.sh 中的命令。

```
./make.sh
```

## 运行

```
./bin/awtkRun bin/awtk.jar:bin/awtk_demos.jar classname
```

请把 classname 换成具体的 classname。如：

```
./bin/awtkRun bin/awtk.jar:bin/awtk_demos.jar DemoBasic
```

> Linux平台可以直接用java命令运行。如：

```
java -Djava.library.path=./lib -cp "bin/awtk_demos.jar:bin/awtk.jar" DemoButton 800 600
```

## 更新绑定（由本项目的维护人员完成）

```
./sync.sh
```

> 在非 bash 终端（如 Windows 平台的 cmd.exe)，需要根据 sync.sh 的内容手工执行相应的命令。

## 代码示例

```java
    TWidget win = TWindow.createDefault();
    TWidget button = TButton.create(win, 0, 0, 0, 0);

    button.setName("quit");
    button.setText("Quit");
    button.setSelfLayout("default(x=c,y=m,w=200,h=40)");

    button.on(TEventType.CLICK.value(), new TOnEvent() {
      @Override
      public TRet onEvent(TEvent evt) {
        System.out.println("OnClick");
        TGlobal.quit();
        return TRet.OK;
      }
    }, 0)
```

## 文档

[AWTK 脚本绑定原理](https://github.com/zlgopen/awtk/blob/master/docs/script_binding.md)

[JAVA 绑定笔记](docs/tech_notes.md)

[在 C++中嵌入 JAVA](docs/embedd_java_in_cpp.md)
> 本文以 Linux/MacOS 为例，Windows 可能会微妙差异，请酌情处理。