Ikhtisar Seluler

Wails v3 berjalan di iOS dan Android menggunakan main.go dan frontend yang sama dengan yang sudah Anda tulis untuk desktop. Tidak ada proyek seluler terpisah, jembatan berbagi kode, atau penulisan ulang: biner Go dikompilasi untuk target seluler dan WebView native merender frontend Anda yang sudah ada.

Lihat cara kerjanya: contoh Kitchen Sink

Cara terbaik untuk memahami kemungkinannya adalah dengan melihat Kitchen Sink — satu aplikasi Wails yang berjalan secara identik di iOS, Android, dan desktop dari satu basis kode:

Untuk menjalankannya sendiri:

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

Cara kerjanya

Model aplikasi yang sama berlaku di setiap platform:

1. Backend Go — layanan, handler peristiwa, dan logika aplikasi Anda dikompilasi tanpa perubahan untuk GOOS=ios dan GOOS=android.
2. Frontend — HTML/JS/CSS yang sama persis. Paket @wailsio/runtime berfungsi secara identik; binding layanan, peristiwa, dialog, dan papan klip semuanya dirutekan melalui transport dalam proses yang sama.
3. Host WebView — di iOS, WKWebView di dalam UIViewController; di Android, WebView di dalam Activity. Wails menyiapkan jembatan pesan secara otomatis.
4. Penyajian aset dalam proses — aset disajikan langsung dari memori Go, bukan dari server localhost. Tanpa port terbuka, tanpa loopback, tanpa latensi tambahan.

Perilaku khusus platform ditempatkan dalam file yang dilindungi oleh //go:build ios atau //go:build android, sehingga kode bersama Anda tetap bersih.

Ringkasan prasyarat

Yang didukung

Kedua platform memiliki rangkaian fitur inti yang sama:

Aturan tag build

Dua aturan penting yang perlu diketahui saat menulis kode kondisional berdasarkan platform:

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

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

Deteksi platform saat runtime

Tag build digunakan untuk kode yang hanya dapat dikompilasi pada platform tertentu. Untuk percabangan biasa dalam kode bersama, gunakan application.System — fitur ini tersedia di setiap build (tanpa memerlukan tag build), sehingga file yang sama dapat digunakan di semua platform:

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() (tag build server), dan IsPlatform(application.PlatformMacOS | PlatformWindows | PlatformLinux | PlatformIOS | PlatformAndroid | PlatformServer).

Frontend menyediakan fungsi pembantu yang sesuai di @wailsio/runtime:

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

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

Langkah berikutnya