API móvel

Os recursos móveis nativos são disponibilizados de duas formas:

• Gerenciadores específicos de cada plataforma — application.IOS (em arquivos //go:build ios) e application.Android (em arquivos //go:build android). Use-os para qualquer funcionalidade específica da plataforma. Consulte as referências do iOS e do Android para ver a API completa de cada plataforma.
• application.Mobile — um único gerenciador, protegido por restrições de compilação, que abrange o subconjunto de recursos com comportamento idêntico nas duas plataformas. Use-o quando quiser um único fluxo de código que seja compilado e executado em todos os ambientes.

application.Mobile

application.Mobile encaminha as chamadas para IOS no iOS, para Android no Android e para uma implementação stub que não realiza nenhuma operação no desktop. Como não tem restrições de compilação, você pode chamá-lo em código Go comum e independente de plataforma — sem precisar criar seus próprios arquivos //go:build:

// Works in any file, on any target.
// On desktop this returns "" (no-op); on device it returns the real path.
dbDir := application.Mobile.StoragePath()
if dbDir == "" {
    // Off-device, or the directory could not be created — handle accordingly.
    return
}
db, _ := sql.Open("sqlite", filepath.Join(dbDir, "app.db"))

StoragePath() retorna o caminho absoluto do diretório privado de arquivos do aplicativo — getFilesDir() no Android e o diretório Application Support no iOS —, o local recomendado para bancos de dados e outros arquivos persistentes. Retorna uma string vazia no desktop e, no dispositivo, se o diretório não estiver disponível (no iOS, se não puder ser criado); portanto, verifique se o resultado é "" antes de usá-lo.

Recursos

O gerenciador Mobile disponibiliza os recursos cujas assinaturas são idênticas no iOS e no Android:

Os resultados assíncronos chegam como eventos common:*, exatamente como ocorre com os gerenciadores específicos de cada plataforma — consulte Eventos para ver os payloads.

O que permanece específico de cada plataforma

Os recursos cujo formato difere entre iOS e Android não estão disponíveis em Mobile; chame-os por meio de application.IOS / application.Android em um arquivo com tags de compilação: