モバイル API

ネイティブモバイル機能は、次の 2 つの方法で公開されます。

• プラットフォーム別マネージャー — //go:build ios ファイル内の application.IOS と、//go:build android ファイル内の application.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() は、アプリのプライベートファイルディレクトリへの絶対パスを返します。Android では getFilesDir()、iOS では Application Support ディレクトリであり、データベースやその他の永続ファイルの保存先として推奨されます。デスクトップでは空文字列を返します。デバイス上でもディレクトリを利用できない場合（iOS では作成できない場合）は空文字列を返すため、使用前に "" かどうかを確認してください。

機能

Mobile マネージャーは、iOS と Android でシグネチャが同一の機能を公開します。

非同期の結果は、プラットフォーム別のマネージャーとまったく同様に、common:* イベントとして届きます。ペイロードについては、イベントを参照してください。

プラットフォーム固有のままの機能

iOS と Android で形式が異なる機能は、Mobileには含まれません。ビルドタグ付きファイルから application.IOS / application.Android を介して呼び出してください。