iOS

Aplikasi Wails v3 berjalan di iOS sebagai aplikasi native sepenuhnya — dan bagian terbaiknya bekerja persis seperti versi desktop. Backend Go yang sama, frontend yang sama, @wailsio/runtime yang sama: service bindings, events, dialog, dan clipboard semua berperilaku identik, dengan nol rewiring spesifik mobile. Tidak ada codebase mobile terpisah, tidak ada layer porting, dan tidak ada API khusus untuk dipelajari — aplikasi Wails Anda yang sudah ada cukup berjalan di iOS. Porting benar-benar mulus: bawa aplikasi Anda apa adanya dan ship.

main.go yang sama di-build untuk desktop dan iOS; sentuhan spesifik iOS dikonfigurasi melalui application.Options.IOS.

Persyaratan

  • macOS dengan Xcode lengkap terinstal (command-line tools saja tidak cukup) — wails3 doctor menampilkan SDK iOS yang ditemukan
  • Go 1.25+ dan npm

Simulator

Dari direktori proyek Anda:

bash
wails3 task ios:run

Perintah ini build aplikasi, boot simulator jika belum berjalan, dan meluncurkannya.

Teman yang berguna:

bash
wails3 task ios:logs:dev    # stream log aplikasi dari simulator
wails3 task ios:xcode       # buka proyek Xcode yang di-generate

Di build debug, webview dapat diinspeksi dari menu Develop Safari.

Packaging

bash
wails3 task ios:package             # production .app untuk simulator
wails3 task ios:deploy-simulator    # install + launch

Ini adalah build produksi yang dioptimasi dan di-strip.

Build perangkat

bash
wails3 task ios:package IOS_PLATFORM=device \
    CODESIGN_IDENTITY="Apple Development: You (TEAMID)" \
    PROVISIONING_PROFILE=path/to/profile.mobileprovision

wails3 task ios:deploy-device [DEVICE_ID=<udid>]     # install + launch on a device
wails3 task ios:package:ipa IOS_PLATFORM=device ...  # distribution .ipa

IOS_PLATFORM=device build untuk perangkat fisik. Entitlement berasal dari build/ios/entitlements.plist dan hanya berlaku untuk build perangkat — tambahkan capability key yang dibutuhkan aplikasi Anda.

Konfigurasi

build/config.yml:

ios:
  bundleID: com.example.myapp
  displayName: My App
  version: 1.0.0
  minIOSVersion: "15.0"

Opsi startup (application.Options.IOS) mencakup DisableScroll, DisableBounce, DisableScrollIndicators, DisableInputAccessoryView, EnableBackForwardNavigationGestures, DisableLinkPreview, EnableInlineMediaPlayback, EnableAutoplayWithoutUserAction, DisableInspectable, UserAgent, ApplicationNameForUserAgent, BackgroundColour, dan tab bawah native via EnableNativeTabs + NativeTabsItems.

Fitur native

Kemampuan spesifik iOS tersedia melalui application.IOS, dipanggil dari Go di dalam file //go:build ios agar kode bersama tetap platform-agnostic. Android menawarkan set yang sama melalui application.Android.

Aksi one-shot mengembalikan hasil segera:

//go:build ios

application.IOS.Haptic("impact-medium") // impact-light|impact-medium|impact-heavy|success|warning|error|selection
application.IOS.Share(`{"text":"Hi","url":"https://wails.io"}`)
application.IOS.SetKeepAwake(true)
application.IOS.PostNotification(`{"title":"Done","body":"Build finished","delay":2}`)
application.IOS.SecureSet("token", "abc") // stored securely

Query helper mengembalikan hasil sebagai JSON — SafeAreaJSON(), AppInfoJSON(), PowerJSON(), NetworkJSON(), StorageJSON(), GetOrientation(), GetBrightness().

Events

Apa pun yang selesai nanti — prompt permission, stream sensor, capture kamera — mengirimkan hasilnya sebagai event alih-alih return value, yang dapat didengarkan di Go atau frontend. Nama diberi prefix common: untuk kemampuan yang dibagi dengan Android dan ios: untuk yang khusus iOS.

// Go
app.Event.On("common:location", func(e *application.CustomEvent) {
    // e.Data -> {"lat":..,"lng":..,"accuracy":..} or {"error":..}
})
// frontend
import { Events } from "@wailsio/runtime";
Events.On("common:notification", (e) => { /* {ok, scheduled, presented, tapped, error} */ });
Event Dipicu oleh Payload
common:biometric BiometricAuthenticate(reason) {ok, error}
common:location GetLocation() {lat, lng, accuracy} / {error}
common:motion SetMotion(true) {x, y, z}
common:proximity SetProximity(true) {near}
common:keyboard SetKeyboardWatch(true) {visible, height}
common:torch SetTorch(bool) {on, available}
common:notification PostNotification(json) {ok, scheduled, presented, tapped, error}
common:capture CapturePhoto() / CaptureVideo() {type, path, size, thumb}
common:screenCapture SetScreenProtect(true) {screenshot, recording}
ios:backgroundTask BeginBackgroundTask(seconds) {message, granted}

Contoh kitchen-sink di v3/examples/mobile menghubungkan setiap fitur di atas end to end.

Kontrol WebView

Beberapa perilaku WebView juga dapat diubah saat runtime dari Go:

application.IOS.SetScrollEnabled(false)
application.IOS.SetBounceEnabled(false)
application.IOS.SetScrollIndicatorsEnabled(false)
application.IOS.SetBackForwardGesturesEnabled(true)
application.IOS.SetLinkPreviewEnabled(false)
application.IOS.SetInspectableEnabled(true)
application.IOS.SetCustomUserAgent("MyApp/1.0")

@wailsio/runtime yang disertakan juga mengekspos namespace iOS frontend kecil:

import { IOS } from "@wailsio/runtime";
await IOS.Haptics.Impact("medium"); // light|medium|heavy|soft|rigid
const info = await IOS.Device.Info();

Seleksi tab bawah native tiba sebagai event nativeTabSelected di window.

Status dukungan

Area Status
Rendering frontend & aset ✅
Service bindings, events (kedua arah) ✅
Dialog pesan ✅
Dialog buka file / files / direktori ✅ Diimpor sebagai salinan sandbox
Dialog simpan file ❌ Tulis di dalam sandbox aplikasi
Clipboard ✅
Screens API ✅ Termasuk work area safe-area
Lifecycle events ✅
Geometri window, menu, system tray No-op di iOS
Beberapa window Hanya window pertama yang ditampilkan

Catatan porting

  • Kode desktop di-build untuk iOS tanpa perubahan — panggilan window, menu, dan system-tray hanya tidak melakukan apa-apa.
  • Ganti dialog save-file dengan tulis ke sandbox aplikasi plus share.
  • Desain frontend secara responsif; safe area ditangani untuk Anda.
Edit page

Last updated: