Обзор мобильных платформ

Wails v3 работает на iOS и Android, используя тот же main.go и тот же фронтенд, которые вы уже создаёте для настольных платформ. Не требуется ни отдельный мобильный проект, ни промежуточный слой для совместного использования кода, ни переписывание: бинарный файл Go компилируется для целевой мобильной платформы, а нативный WebView отображает существующий фронтенд.

Посмотрите в действии: пример Kitchen Sink

Лучший способ понять доступные возможности — изучить Kitchen Sink: единое приложение Wails, которое одинаково работает на iOS, Android и настольных платформах из одной кодовой базы:

Чтобы запустить пример самостоятельно:

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 это WKWebView внутри UIViewController, а на Android — WebView внутри Activity. Wails автоматически настраивает мост обмена сообщениями.
4. Внутрипроцессное предоставление ресурсов — ресурсы предоставляются непосредственно из памяти Go, а не с сервера localhost. Нет открытых портов, обращений через loopback-интерфейс и дополнительной задержки.

Поведение, зависящее от платформы, находится в файлах, защищённых условиями //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

Следующие шаги