モバイル概要

Wails v3 は、デスクトップ向けにすでに作成しているものと同じ main.go とフロントエンドを使用して、iOS と Android で動作します。モバイル専用の別プロジェクトも、コード共有用のブリッジも、書き直しも必要ありません。Go バイナリがモバイルターゲット向けにコンパイルされ、ネイティブ WebView が既存のフロントエンドをレンダリングします。

実際の動作を見る：Kitchen Sink の例

何ができるかを理解するには、Kitchen Sink を見るのが最適です。これは、1 つのコードベースから 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. プロセス内アセット配信 — アセットは localhost サーバーではなく、Go のメモリから直接配信されます。ポートの開放も、ループバックも、余分なレイテンシーもありません。

プラットフォーム固有の動作は、//go:build ios または //go:build android で保護されたファイルに配置されるため、共有コードを簡潔に保てます。

前提条件の概要

サポートされる機能

両方のプラットフォームで、同じ中核機能セットを利用できます。

ビルドタグのルール

プラットフォーム条件付きコードを記述する際に知っておくべき重要なルールが2つあります。

• 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

次のステップ