Pesquisar
Contribuir

Editar esta documentação

Traduza a documentação ou abra o projeto completo no seu computador.

Nada será publicado até que você decida enviar seu trabalho.

iOS

Compile e execute aplicativos Wails no iOS — configuração do ambiente, simulador, compilações para dispositivos, configuração e recursos nativos

Os aplicativos Wails v3 são executados no iOS como aplicativos totalmente nativos — e o melhor é que funcionam exatamente como a versão para desktop. O mesmo backend em Go, o mesmo frontend e o mesmo @wailsio/runtime: os vínculos de serviços, eventos, caixas de diálogo e a área de transferência se comportam de maneira idêntica, com zero reconfiguração específica para dispositivos móveis. Não há uma base de código móvel separada, uma camada de portabilidade nem uma API especial para aprender — seu aplicativo Wails existente simplesmente é executado no iOS. A portabilidade é realmente transparente: use o aplicativo como está e publique-o.

O mesmo main.go é compilado tanto para desktop quanto para iOS; os ajustes específicos do iOS são configurados por meio de application.Options.IOS.

Requisitos

  • macOS com o Xcode completo instalado (somente as ferramentas de linha de comando não são suficientes) — wails3 doctor mostra os SDKs do iOS que consegue encontrar
  • Go 1.25+ e npm

Simulador

No diretório do projeto:

bash
wails3 task ios:run

Esse comando compila o aplicativo, inicializa um simulador caso ainda não haja um em execução e abre o aplicativo.

Comandos complementares úteis:

bash
wails3 task ios:logs:dev    # stream the app's logs from the simulator
wails3 task ios:xcode       # open the generated Xcode project

Nas compilações de depuração, a WebView pode ser inspecionada pelo menu Desenvolvedor do Safari.

Empacotamento

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

Essas são compilações de produção otimizadas e sem símbolos desnecessários.

Compilações para dispositivos

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 compila para um dispositivo físico. Os direitos vêm de build/ios/entitlements.plist e se aplicam somente às compilações para dispositivos — adicione as chaves de recursos exigidas pelo seu aplicativo.

Configuração

build/config.yml:

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

As opções de inicialização (application.Options.IOS) incluem DisableScroll, DisableBounce, DisableScrollIndicators, DisableInputAccessoryView, EnableBackForwardNavigationGestures, DisableLinkPreview, EnableInlineMediaPlayback, EnableAutoplayWithoutUserAction, DisableInspectable, UserAgent, ApplicationNameForUserAgent, BackgroundColour e abas inferiores nativas por meio de EnableNativeTabs + NativeTabsItems.

Recursos nativos

Os recursos específicos do iOS estão disponíveis por meio de application.IOS, chamado no Go dentro de um arquivo //go:build ios para que o código compartilhado permaneça independente da plataforma. O Android oferece o mesmo conjunto por meio de application.Android.

As ações pontuais retornam imediatamente:

go
//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

As funções auxiliares de consulta retornam seus resultados como JSON — SafeAreaJSON(), AppInfoJSON(), PowerJSON(), NetworkJSON(), StorageJSON(), GetOrientation(), GetBrightness(). StoragePath() retorna o caminho absoluto do diretório Application Support do aplicativo — um bom local para bancos de dados e outros arquivos persistentes (o equivalente no iOS a getFilesDir() do Android). O diretório é criado no primeiro acesso; StoragePath() retorna uma string vazia se não for possível criá-lo, portanto verifique "" antes de usá-lo.

Eventos

Tudo que termina posteriormente — uma solicitação de permissão, um fluxo de sensor ou uma captura da câmera — entrega o resultado como um evento, e não como um valor de retorno; você pode escutá-lo no Go ou no frontend. Os nomes recebem o prefixo common: para recursos compartilhados com o Android e ios: para os exclusivos do iOS.

go
// Go
app.Event.On("common:location", func(e *application.CustomEvent) {
    // e.Data -> {"lat":..,"lng":..,"accuracy":..} or {"error":..}
})
js
// frontend
import { Events } from "@wailsio/runtime";
Events.On("common:notification", (e) => { /* {ok, scheduled, presented, tapped, error} */ });
Evento Acionado por Carga útil
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}

O exemplo completo em v3/examples/mobile integra de ponta a ponta todos os recursos acima.

Controles da WebView

Alguns comportamentos da WebView também podem ser alterados em tempo de execução pelo Go:

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")

O @wailsio/runtime incluído também expõe um pequeno namespace do iOS para o frontend:

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

As seleções de abas inferiores nativas chegam como um evento nativeTabSelected em window.

Status do suporte

Área Status
Renderização do frontend e ativos ✅
Vinculações de serviços e eventos (em ambas as direções) ✅
Caixas de diálogo de mensagem ✅
Caixas de diálogo para abrir arquivo, arquivos ou diretório ✅ Importados como cópias no sandbox
Caixas de diálogo para salvar arquivo ❌ Em vez disso, grave no sandbox do aplicativo
Área de transferência ✅
API de telas ✅ Inclui a área de trabalho dentro da área segura
Eventos do ciclo de vida ✅
Geometria da janela, menus e bandeja do sistema Não têm efeito no iOS
Várias janelas Somente a primeira janela é exibida

Observações sobre portabilidade

  • O código para desktop é compilado para iOS sem alterações — as chamadas de janela, menu e bandeja do sistema simplesmente não fazem nada.
  • Substitua as caixas de diálogo para salvar arquivos por uma gravação no sandbox do aplicativo seguida de um compartilhamento.
  • Crie um frontend responsivo; as áreas seguras são tratadas automaticamente.
Editar página

Última atualização: