Мобильный API

Нативные мобильные возможности доступны двумя способами:

• Менеджеры для отдельных платформ — application.IOS (в файлах //go:build ios) и application.Android (в файлах //go:build android). Используйте их для всего, что зависит от конкретной платформы. Полный набор API для каждой платформы приведён в справочниках по iOS и Android.
• application.Mobile — единый менеджер с защитой на уровне сборки, охватывающий подмножество возможностей, которые одинаково работают на обеих платформах. Используйте его, если нужен единый путь выполнения кода, который компилируется и работает везде.

application.Mobile

application.Mobile перенаправляет вызовы к IOS в iOS, к Android в Android и к заглушке, которая ничего не делает, в настольных системах. Поскольку ограничений сборки у него нет, его можно вызывать из обычного, не зависящего от платформы кода Go — собственные файлы //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() возвращает абсолютный путь к каталогу личных файлов приложения — getFilesDir() в Android или каталогу Application Support в iOS. Это рекомендуемое место для баз данных и других постоянных файлов. Метод возвращает пустую строку в настольных системах, а на устройстве — если каталог недоступен (в iOS — если его не удаётся создать), поэтому перед использованием проверьте результат на "".

Возможности

Менеджер Mobile предоставляет возможности с одинаковыми сигнатурами в iOS и Android:

Асинхронные результаты поступают в виде событий common:*, точно так же, как при использовании менеджеров отдельных платформ. Описание полезной нагрузки см. в разделе События.

Что остаётся платформозависимым

Возможности, форма которых различается в iOS и Android, не представлены в Mobile; вызывайте их через application.IOS / application.Android из файла с тегом сборки: