移动端概览

Wails v3 可使用你已经为桌面端编写的同一套main.go和前端在iOS 和 Android上运行。无需单独创建移动端项目，无需代码共享桥接，也无需重写：Go 二进制文件会针对移动端目标进行编译，并由原生 WebView 渲染现有前端。

查看实际运行效果：Kitchen Sink 示例

要了解可以实现哪些功能，最好的方式是查看Kitchen Sink。这是一个使用单一代码库、在 iOS、Android 和桌面端上以相同方式运行的 Wails 应用：

要自行运行此示例：

git clone https://github.com/wailsapp/wails.git
cd wails/v3/examples/mobile

wails3 task ios:run        # iOS Simulator (macOS + Xcode required)
wails3 task android:run    # Android Emulator
wails3 task run            # Desktop

工作原理

所有平台均采用相同的应用模型：

1. Go 后端——你的服务、事件处理程序和应用逻辑无需修改，即可为GOOS=ios和GOOS=android编译。
2. 前端——使用完全相同的 HTML/JS/CSS。@wailsio/runtime包的工作方式也完全相同；服务绑定、事件、对话框和剪贴板都通过同一进程内传输机制进行路由。
3. WebView 宿主——在 iOS 上，是位于UIViewController中的WKWebView；在 Android 上，是位于Activity中的WebView。Wails 会自动连接消息桥。
4. 进程内资源服务——资源直接从 Go 内存中提供，而不是通过 localhost 服务器。无需开放端口，无需环回连接，也不会增加额外延迟。

平台特定行为位于受//go:build ios或//go:build android保护的文件中，从而让共享代码保持整洁。

前置条件速览

支持的功能

两个平台具有相同的核心功能集：

构建标签规则

编写平台条件代码时，需要了解两条重要规则：

• ios 隐含 darwin——标记为 //go:build darwin 的文件也会针对 iOS 进行编译。若要仅针对 macOS，请使用 //go:build darwin && !ios。
• android 隐含 linux——标记为 //go:build linux 的文件也会针对 Android 进行编译。若要仅针对桌面 Linux，请使用 //go:build linux && !android。

在运行时，runtime.GOOS会分别返回 "ios" 和 "android"。

运行时平台检测

构建标签适用于只能在特定平台上编译的代码。对于共享代码中的常规分支，请使用 application.System——它在每个构建中都可用 （无需构建标签），因此同一文件可在所有平台上使用：

import "github.com/wailsapp/wails/v3/pkg/application"

if application.System.IsMobile() {
    // iOS or Android
} else if application.System.IsDesktop() {
    // macOS, Windows or Linux
}

// Or test a single target directly:
if application.System.IsPlatform(application.PlatformIOS) {
    // iOS only
}

可用值：IsMobile()、IsDesktop()、IsServer()（对应 server 构建标签）以及 IsPlatform(application.PlatformMacOS | PlatformWindows | PlatformLinux | PlatformIOS | PlatformAndroid | PlatformServer)。

前端在 @wailsio/runtime 中提供了相应的辅助函数：

import { System } from "@wailsio/runtime";

if (System.IsMobile()) { /* iOS or Android */ }
if (System.IsIOS()) { /* … */ }      // also IsAndroid, IsMac, IsWindows, IsLinux, IsDesktop

后续步骤