Ringkasan Mobile

Wails v3 berjalan di iOS dan Android menggunakan main.go dan frontend yang sama dengan desktop. Tidak ada proyek mobile terpisah, tidak ada bridge code-sharing, dan tidak perlu rewrite: binary Go dikompilasi untuk target mobile dan WebView native merender frontend yang sudah ada.

Lihat berjalan: contoh Kitchen Sink

Cara terbaik memahami kemungkinannya adalah melihat Kitchen Sink — satu aplikasi Wails yang berjalan identik di iOS, Android, dan desktop dari satu codebase:

Mobile Kitchen Sink — GitHubBindings · Events · Dialogs · Haptics · Geolocation · Biometrics · Notifications · Secure storage · dan lainnya — semua dari satu main.go

Contoh ini mendemonstrasikan setiap permukaan API mobile utama di 7 tab — dan juga berjalan di desktop. Tab Mobile dan Hardware disembunyikan di desktop via pengecekan platform di frontend; sisi Go tidak mendaftarkan handler untuk event mobile common:* saat di-build untuk desktop. Ini adalah pola yang direkomendasikan untuk mengirim satu codebase ke semua platform.

Untuk menjalankannya sendiri:

git clone https://github.com/wailsapp/wails.git
cd wails/v3/examples/mobile

wails3 task ios:run        # iOS Simulator (macOS + Xcode diperlukan)
wails3 task android:run    # Android Emulator
wails3 task run            # Desktop

Cara kerjanya

Model aplikasi yang sama berlaku di setiap platform:

1. Backend Go — service, event handler, dan logika aplikasi Anda dikompilasi tanpa perubahan untuk GOOS=ios dan GOOS=android.
2. Frontend — HTML/JS/CSS yang persis sama. Paket @wailsio/runtime bekerja identik; service bindings, events, dialog, dan clipboard semua melewati transport in-process yang sama.
3. Host WebView — di iOS WKWebView di dalam UIViewController; di Android WebView di dalam Activity. Wails menghubungkan message bridge secara otomatis.
4. Penyajian aset in-process — aset disajikan langsung dari memori Go, bukan server localhost. Tanpa port terbuka, tanpa loopback, tanpa latency ekstra.

Perilaku spesifik platform ada di file yang dilindungi //go:build ios atau //go:build android, menjaga kode bersama tetap bersih.

Prasyarat sekilas

Yang didukung

Kedua platform berbagi feature set inti yang sama:

Aturan build tag

Dua aturan penting saat menulis kode kondisional platform:

• ios mengimplikasikan darwin — file dengan tag //go:build darwin juga dikompilasi untuk iOS. Untuk target macOS saja, gunakan //go:build darwin && !ios.
• android mengimplikasikan linux — file dengan tag //go:build linux juga dikompilasi untuk Android. Untuk target desktop-Linux saja, gunakan //go:build linux && !android.

Saat runtime, runtime.GOOS mengembalikan "ios" dan "android" masing-masing.

Deteksi platform runtime

Build tag untuk kode yang hanya dapat dikompilasi di platform tertentu. Untuk branching biasa di kode bersama, gunakan application.System — tersedia di setiap build (tanpa build tag) sehingga file yang sama bekerja di semua tempat:

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
}

Tersedia: IsMobile(), IsDesktop(), IsServer() (build tag server), dan IsPlatform(application.PlatformMacOS | PlatformWindows | PlatformLinux | PlatformIOS | PlatformAndroid | PlatformServer).

Frontend memiliki helper yang cocok di @wailsio/runtime:

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

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

Langkah selanjutnya