01. 安装指南

安装指南 #

使用 Fyne 工具包构建跨平台应用程序非常简单,但在开始之前需要安装一些工具。如果您的计算机已经为Go开发设置好了,以下步骤可能不是必需的,但我们建议您阅读一下您操作系统的提示,以防万一。如果本教程后面的步骤出现问题,那么您应该重新检查以下的先决条件。

先决条件 #

Fyne需要3个基本元素:Go工具(至少版本1.12)、一个C编译器(用于与系统图形驱动连接)和一个系统图形驱动。根据您的操作系统,安装指令会有所不同,请选择下面适合您的选项卡查看安装指令。

请注意,这些步骤仅用于开发 - 您的Fyne应用不需要为最终用户安装任何设置或依赖!

如下的 termux 是用于在 Android 设备上构建 Fyne 应用,无 PC 依赖。
  • 下载页面下载Go并按照说明安装
  • 为Windows安装以下测试过的C编译器之一:
  • 在Windows上,您的图形驱动程序已经安装好了,但建议确保它们是最新的。

使用MSYS2(推荐)的安装步骤如下:

  • msys2.org安装MSYS2
  • 安装完成后不要使用打开的MSYS终端
  • 从开始菜单打开“MSYS2 MinGW 64位”
  • 执行以下命令(如果询问安装选项,请确保选择“全部”):
$ pacman -Syu
$ pacman -S git mingw-w64-x86_64-toolchain
  • 您需要将 /c/Program\ Files/Go/bin和 ~/Go/bin 添加到您的 $PATH 中,对于MSYS2,您可以将以下命令粘贴到终端中:
$ echo "export PATH=\$PATH:/c/Program\ Files/Go/bin:~/Go/bin" >> ~/.bashrc
  • 为了让编译器在其他终端上工作,您需要设置Windows的%PATH%变量,以便找到这些工具。进入“编辑系统环境变量”控制面板,点击“高级”,并将“C:\msys64\mingw64\bin”添加到路径列表中。
  • 下载页面下载Go并按照说明进行安装。
  • Mac App Store安装Xcode。
  • 通过打开终端窗口并输入以下命令来设置Xcode命令行工具:xcode-select --install
  • 在macOS上,图形驱动程序将已经安装。
  • 您需要使用包管理器安装Go、gcc和图形库头文件,以下命令之一可能会起作用。

  • Debian / Ubuntu: sudo apt-get install golang gcc libgl1-mesa-dev xorg-dev

  • Fedora: sudo dnf install golang gcc libXcursor-devel libXrandr-devel mesa-libGL-devel libXi-devel libXinerama-devel libXxf86vm-devel

  • Arch Linux: sudo pacman -S go xorg-server-devel libxcursor libxrandr libxinerama libxi

  • Solus: sudo eopkg it -c system.devel golang mesalib-devel libxrandr-devel libxcursor-devel libxi-devel libxinerama-devel

  • openSUSE: sudo zypper install go gcc libXcursor-devel libXrandr-devel Mesa-libGL-devel libXi-devel libXinerama-devel libXxf86vm-devel

  • Void Linux: sudo xbps-install -S go base-devel xorg-server-devel libXrandr-devel libXcursor-devel libXinerama-devel

  • Alpine Linux: sudo apk add go gcc libxcursor-dev libxrandr-dev libxinerama-dev libxi-dev linux-headers mesa-dev

  • NixOS: nix-shell -p libGL pkg-config xorg.libX11.dev xorg.libXcursor xorg.libXi xorg.libXinerama xorg.libXrandr xorg.libXxf86vm

您需要使用包管理器安装Go、gcc和图形库头文件。

sudo apt-get install golang gcc libegl1-mesa-dev xorg-dev

您需要使用包管理器安装Go、gcc和图形库头文件。

  • FreeBSD: sudo pkg install go gcc xorg pkgconf
  • OpenBSD: sudo pkg_add go
  • NetBSD: sudo pkgin install go pkgconf
  • 要为Android开发应用,您首先需要为您当前的电脑(Windows、macOS或Linux)安装工具。
  • 完成后,您需要安装Android SDK和Android NDK——推荐的方法是安装 Android Studio,然后转到Tools > SDK Manager,并从SDK Tools安装NDK(并行)包。
  • 或者,您可以下载 Standalone Android NDK,这是一种更精简的方法。解压缩文件夹,并将ANDROID_NDK_HOME环境变量指向它。
  • 要为iOS开发应用,您将需要访问一台按照上面macOS标签配置的苹果Mac电脑。
  • 您还需要创建一个苹果开发者账户并注册开发者计划(需要支付费用)以获取在任何设备上运行应用所需的证书。

在Android上编译Fyne应用,您将需要Android 9或以上版本。

  • 安装fdroid,然后从那里安装termux。
  • 打开Termux并安装Go和Git:pkg install golang git
  • https://github.com/Lzhiyong/termux-ndk安装NDK和SDK到termux,并设置环境变量ANDROID_HOMEANDROID_NDK_HOME

下载 #

使用Go模块(Go 1.16及更高版本要求),在使用包之前需要设置模块。

Go模块(适用于Go 1.16或更新版本) #

如果您不使用模块或您的模块已经初始化,可以跳过此步骤到下一个步骤。运行以下命令并将MODULE_NAME替换为您偏好的模块名(应在为您的应用程序专门创建的新文件夹中调用)。

$ cd myapp
$ go mod init MODULE_NAME

现在您需要下载Fyne模块和辅助工具。使用以下命令完成:

$ go get fyne.io/fyne/v2@latest
$ go install fyne.io/fyne/v2/cmd/fyne@latest

如果您不确定Go模块如何工作,考虑阅读[教程:创建一个Go模块]。

旧版Go安装 #

使用旧版Go发布安装Fyne工具包和辅助工具,只需执行go get命令:

$ go get fyne.io/fyne/v2
$ go get fyne.io/fyne/v2/cmd/fyne

检查您的安装 #

在编写应用或运行示例之前,您可以使用Fyne安装工具检查您的安装。只需从链接下载适合您计算机的应用并运行它,您应该看到类似以下屏幕的内容:

如果您的安装有任何问题,请查看 故障排除 部分以获取提示。

运行演示 #

如果您在开始编写自己的应用程序之前想看看Fyne工具包的实际运行情况,您可以通过执行以下命令在您的计算机上运行我们的演示应用:

$ go run fyne.io/fyne/v2/cmd/fyne_demo@latest

请注意,首次运行需要编译一些C代码,因此可能比平时需要更长的时间。后续构建会重用缓存,将会快得多。

旧版 Go 版本 #

要在旧版Go上运行演示,只需执行以下命令:

$ go run fyne.io/fyne/v2/cmd/fyne_demo

安装 #

如果您愿意,您也可以使用以下命令安装演示(需要Go 1.16或更高版本):

$ go install fyne.io/fyne/v2/cmd/fyne_demo@latest

对于早期版本的Go,您需要使用以下命令:

$ go get fyne.io/fyne/v2/cmd/fyne_demo

如果您的GOBIN环境变量已添加到路径中(在macOS和Windows上默认应该如此),那么您就可以运行演示了:

$ fyne_demo

就这些了!

现在你可以在你选择的IDE中编写自己的Fyne应用程序了。如果你想看到一些Fyne代码的实际运用,那么你可以阅读你的 第一个应用程序