From 94f0af90636b5eae99f7d131ccc1f5a60c4145e7 Mon Sep 17 00:00:00 2001
From: "Rick.Chan" <cy@haoan119.com>
Date: Tue, 13 Dec 2022 19:11:37 +0800
Subject: [PATCH] =?UTF-8?q?=E5=A2=9E=E5=8A=A0=20GioUI=20=E6=A6=82=E8=A7=88?=
 =?UTF-8?q?.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Rick.Chan <cy@haoan119.com>
---
 .../Language/Go/Package/GioUI/GioUI_概览.md   | 134 ++++++++++++++++++
 1 file changed, 134 insertions(+)
 create mode 100644 Software/Development/Language/Go/Package/GioUI/GioUI_概览.md

diff --git a/Software/Development/Language/Go/Package/GioUI/GioUI_概览.md b/Software/Development/Language/Go/Package/GioUI/GioUI_概览.md
new file mode 100644
index 0000000..09b8fd5
--- /dev/null
+++ b/Software/Development/Language/Go/Package/GioUI/GioUI_概览.md
@@ -0,0 +1,134 @@
+# GioUI 概览
+
+GioUI 是一款支持多平台的 Go GUI 库，支持 Linux、macOS、Windows、Android、iOS、FreeBSD、OpenBSD 和 WebAssembly。
+
+## 1. 安装
+
+GioUI 的安装与其他 Go 包一样，只要在源码中引用，然后通过 go 命令即可自动下载：
+
+源码中引用“gioui”后：
+
+```bash
+go mod tidy
+```
+
+即可自动安装。
+
+另外也可以到[官方网站](https://gioui.org/)下载[源码](https://git.sr.ht/~eliasnaur/gio)或获取帮助文档：
+
+编译 Android 程序时需要用到 gogio 工具，需要通过如下命令安装：
+
+```bash
+go install gioui.org/cmd/gogio@latest
+```
+
+### 1.1. Android 开发环境配置
+
+如果需要开发基于 GioUI 的 Android 程序，需要先搭建好 Android 开发环境：
+
+1. 安装 Android Studio 后通过 IDE 安装 Android SDK（>31） ，配置 ANDROID_SDK_ROOT。ANDROID_SDK_ROOT 可在 Android Studio->More Actions->SDK Manager->Android SDK Location 中获取到；
+2. 进入 Android Studio->More Actions->SDK Manager->SDK Tools 勾选 NDK（我使用的是 25.1.893xxxx 版本）；
+3. 当前使用的 GioUI commit id 为 dee53b36，该版本仅支持 OpenJDK 1.8，与之对应的版本是 OpenJDK 8，因此需要下载 [openjdk-8u42-b03-windows-i586-14_jul_2022.zip](https://download.java.net/openjdk/jdk8u42/ri/openjdk-8u42-b03-windows-i586-14_jul_2022.zip) 并进行安装（[官网地址](https://jdk.java.net/java-se-ri/8-MR4)）。配置 JAVA_HOME 并将 %JAVA_HOME%\bin 添加到系统 PATH 中。配置好后通过命令行输入：
+
+    ```bash
+    java -version
+    ```
+
+    进行版本验证。
+
+## 2. PC 示例
+
+创建模块：
+
+```bash
+go mod init gio.test
+```
+
+main 包代码：
+
+```go
+package main
+
+import (
+    "image/color"
+    "log"
+    "os"
+
+    "gioui.org/app"
+    "gioui.org/font/gofont"
+    "gioui.org/io/system"
+    "gioui.org/layout"
+    "gioui.org/op"
+    "gioui.org/text"
+    "gioui.org/widget/material"
+)
+
+func main() {
+    go func() {
+        w := app.NewWindow()
+        err := run(w)
+        if err != nil {
+            log.Fatal(err)
+        }
+        os.Exit(0)
+    }()
+    app.Main()
+}
+
+func run(w *app.Window) error {
+    th := material.NewTheme(gofont.Collection())
+    var ops op.Ops
+    for {
+        e := <-w.Events()
+        switch e := e.(type) {
+        case system.DestroyEvent:
+            return e.Err
+        case system.FrameEvent:
+            gtx := layout.NewContext(&ops, e)
+
+            title := material.H1(th, "Hello, Gio")
+            maroon := color.NRGBA{R: 127, G: 0, B: 0, A: 255}
+            title.Color = maroon
+            title.Alignment = text.Middle
+            title.Layout(gtx)
+
+            e.Frame(gtx.Ops)
+        }
+    }
+}
+```
+
+编译命令：
+
+```bash
+go mod tidy
+go run .
+```
+
+### 2.1. PC 示例说明
+
+调用 app.NewWindow() 将创建新的窗体。调用 app.Main() 将阻塞至窗体退出。
+
+通过 w.Events() 可以接收窗体事件消息。system.DestroyEvent 为窗体析构消息；system.FrameEvent 为窗体绘制请求消息。
+
+需要绘制的控件需要像压栈那样装入 Ops 的 Context，最后调用 e.Frame(gtx.Ops) 绘制全部控件。
+
+## 3. Android 示例
+
+```bash
+git clone https://git.sr.ht/~eliasnaur/gio-example
+cd gio-example
+gogio -target android <module name>[/sub-directory] [-token <github token>]
+# 如
+gogio -target android gioui.org/example/kitchen
+```
+
+将生成 APK 文件，可通过手机安装或使用如下命令：
+
+```bash
+adb install kitchen.apk
+```
+
+## 4. 外部参考资料
+
+1. [GUI With Gio](https://jonegil.github.io/gui-with-gio/teleprompter/02_user_input.html)