Présentation de la prise en charge mobile

Wails v3 s’exécute sur iOS et Android avec le même main.go et le même frontend que ceux que vous développez déjà pour les applications de bureau. Aucun projet mobile distinct, aucune passerelle de partage de code et aucune réécriture ne sont nécessaires : le binaire Go est compilé pour la plateforme mobile cible, et une WebView native affiche votre frontend existant.

Découvrez-le en fonctionnement : exemple Kitchen Sink

La meilleure façon de comprendre les possibilités offertes consiste à examiner Kitchen Sink, une application Wails unique qui, à partir d’une seule base de code, s’exécute de façon identique sur iOS, Android et les plateformes de bureau :

Pour l’exécuter vous-même :

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

Fonctionnement

Le même modèle d’application s’applique à toutes les plateformes :

1. Backend Go — vos services, gestionnaires d’événements et logique applicative sont compilés sans modification pour GOOS=ios et GOOS=android.
2. Frontend — exactement les mêmes fichiers HTML/JS/CSS. Le paquet @wailsio/runtime fonctionne à l’identique ; les liaisons de services, les événements, les boîtes de dialogue et le presse-papiers passent tous par le même transport au sein du processus.
3. Hôte WebView — sur iOS, un WKWebView dans un UIViewController ; sur Android, un WebView dans une Activity. Wails configure automatiquement la passerelle de messages.
4. Service des ressources au sein du processus — les ressources sont servies directement depuis la mémoire de Go, et non depuis un serveur localhost. Aucun port ouvert, aucune interface de bouclage, aucune latence supplémentaire.

Le comportement propre à chaque plateforme réside dans des fichiers protégés par //go:build ios ou //go:build android, ce qui préserve la propreté de votre code partagé.

Prérequis en un coup d’œil

Fonctionnalités prises en charge

Les deux plateformes partagent le même ensemble de fonctionnalités de base :

Règles des balises de compilation

Deux règles importantes à connaître lorsque vous écrivez du code conditionnel selon la plateforme :

• ios implique darwin : un fichier portant la balise //go:build darwin sera également compilé pour iOS. Pour cibler uniquement macOS, utilisez //go:build darwin && !ios.
• android implique linux : un fichier portant la balise //go:build linux sera également compilé pour Android. Pour cibler uniquement Linux sur ordinateur, utilisez //go:build linux && !android.

À l’exécution, runtime.GOOS renvoie respectivement "ios" et "android".

Détection de la plateforme à l’exécution

Les balises de compilation sont destinées au code qui peut uniquement être compilé sur une plateforme donnée. Pour les branchements ordinaires dans du code partagé, utilisez application.System, disponible dans chaque build (aucune balise de compilation nécessaire), de sorte que le même fichier fonctionne partout :

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
}

Disponibles : IsMobile(), IsDesktop(), IsServer() (la balise de compilation server) et IsPlatform(application.PlatformMacOS | PlatformWindows | PlatformLinux | PlatformIOS | PlatformAndroid | PlatformServer).

Le frontend dispose des fonctions auxiliaires correspondantes dans @wailsio/runtime :

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

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

Étapes suivantes