Visão geral para dispositivos móveis

O Wails v3 é executado no iOS e no Android usando o mesmo main.go e o mesmo frontend que você já desenvolve para desktop. Não há um projeto separado para dispositivos móveis, uma ponte para compartilhamento de código nem a necessidade de reescrever o código: o binário Go é compilado para a plataforma móvel de destino, e uma WebView nativa renderiza o frontend existente.

Veja em execução: exemplo Kitchen Sink

A melhor maneira de entender o que é possível fazer é conferir o Kitchen Sink — um único aplicativo Wails que, a partir de uma só base de código, é executado de forma idêntica no iOS, Android e desktop:

Para executá-lo por conta própria:

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

Como funciona

O mesmo modelo de aplicativo se aplica a todas as plataformas:

1. Backend Go — seus serviços, handlers de eventos e lógica do aplicativo são compilados sem alterações para GOOS=ios e GOOS=android.
2. Frontend — exatamente o mesmo HTML/JS/CSS. O pacote @wailsio/runtime funciona de forma idêntica; bindings de serviços, eventos, caixas de diálogo e a área de transferência são todos encaminhados pelo mesmo transporte dentro do processo.
3. Host da WebView — no iOS, uma WKWebView dentro de um UIViewController; no Android, uma WebView dentro de uma Activity. O Wails configura automaticamente a ponte de mensagens.
4. Fornecimento de recursos dentro do processo — os recursos são servidos diretamente da memória do Go, e não por um servidor localhost. Sem portas abertas, sem loopback e sem latência adicional.

O comportamento específico de cada plataforma fica em arquivos protegidos por //go:build ios ou //go:build android, mantendo limpo o código compartilhado.

Visão geral dos pré-requisitos

O que é compatível

As duas plataformas compartilham o mesmo conjunto principal de recursos:

Regras de tags de compilação

Duas regras importantes para escrever código condicional por plataforma:

• ios implica darwin — um arquivo com a tag //go:build darwin também será compilado para iOS. Para direcionar apenas ao macOS, use //go:build darwin && !ios.
• android implica linux — um arquivo com a tag //go:build linux também será compilado para Android. Para direcionar apenas ao Linux para desktop, use //go:build linux && !android.

Em tempo de execução, runtime.GOOS retorna "ios" e "android", respectivamente.

Detecção da plataforma em tempo de execução

As tags de compilação destinam-se a código que só pode ser compilado em determinada plataforma. Para ramificações comuns em código compartilhado, use application.System — ele está disponível em todas as compilações (sem necessidade de tags de compilação), portanto o mesmo arquivo funciona em qualquer plataforma:

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
}

Disponíveis: IsMobile(), IsDesktop(), IsServer() (a tag de compilação server) e IsPlatform(application.PlatformMacOS | PlatformWindows | PlatformLinux | PlatformIOS | PlatformAndroid | PlatformServer).

O frontend tem as funções auxiliares correspondentes em @wailsio/runtime:

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

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

Próximas etapas