Übersicht für Mobilgeräte

Wails v3 läuft auf iOS und Android und verwendet dabei dieselbe main.go und dasselbe Frontend, die Sie bereits für Desktop-Anwendungen schreiben. Es gibt weder ein separates Mobilprojekt noch eine Brücke zur gemeinsamen Codenutzung oder eine Neuentwicklung: Das Go-Binärprogramm wird für die mobile Zielplattform kompiliert, und eine native WebView rendert Ihr vorhandenes Frontend.

In Aktion: das Kitchen-Sink-Beispiel

Am besten erkennen Sie die Möglichkeiten anhand von Kitchen Sink – einer einzelnen Wails-App, die aus einer Codebasis identisch auf iOS, Android und Desktop-Plattformen läuft:

So führen Sie das Beispiel selbst aus:

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

Funktionsweise

Auf jeder Plattform gilt dasselbe Anwendungsmodell:

1. Go-Backend – Ihre Dienste, Ereignishandler und Anwendungslogik werden unverändert für GOOS=ios und GOOS=android kompiliert.
2. Frontend – exakt dasselbe HTML, JavaScript und CSS. Das Paket @wailsio/runtime funktioniert identisch; Dienstbindungen, Ereignisse, Dialoge und die Zwischenablage werden über denselben prozessinternen Transport geleitet.
3. WebView-Host – unter iOS eine WKWebView innerhalb einer UIViewController, unter Android eine WebView innerhalb einer Activity. Wails richtet die Nachrichtenbrücke automatisch ein.
4. Prozessinterne Bereitstellung von Assets – Assets werden direkt aus dem Go-Arbeitsspeicher bereitgestellt, nicht von einem localhost-Server. Keine offenen Ports, kein Loopback, keine zusätzliche Latenz.

Plattformspezifisches Verhalten befindet sich in Dateien, die durch //go:build ios oder //go:build android geschützt sind. So bleibt Ihr gemeinsam genutzter Code übersichtlich.

Voraussetzungen auf einen Blick

Unterstützte Funktionen

Beide Plattformen unterstützen dieselben Kernfunktionen:

Regeln für Build-Tags

Beachten Sie beim Schreiben von plattformabhängigem Code zwei wichtige Regeln:

• ios impliziert darwin – eine mit //go:build darwin gekennzeichnete Datei wird auch für iOS kompiliert. Verwenden Sie //go:build darwin && !ios, um ausschließlich macOS anzusprechen.
• android impliziert linux – eine mit //go:build linux gekennzeichnete Datei wird auch für Android kompiliert. Verwenden Sie //go:build linux && !android, um ausschließlich Desktop-Linux anzusprechen.

Zur Laufzeit gibt runtime.GOOS jeweils "ios" beziehungsweise "android" zurück.

Plattformerkennung zur Laufzeit

Build-Tags sind für Code vorgesehen, der nur auf einer bestimmten Plattform kompiliert werden kann. Verwenden Sie für gewöhnliche Verzweigungen in gemeinsam genutztem Code application.System. Dieses Objekt ist in jedem Build verfügbar (keine Build-Tags erforderlich), sodass dieselbe Datei überall funktioniert:

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
}

Verfügbar sind IsMobile(), IsDesktop(), IsServer() (das Build-Tag server) und IsPlatform(application.PlatformMacOS | PlatformWindows | PlatformLinux | PlatformIOS | PlatformAndroid | PlatformServer).

Das Frontend enthält die entsprechenden Hilfsfunktionen in @wailsio/runtime:

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

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

Nächste Schritte