メインコンテンツにスキップ
バージョン: 次期バージョン 🚧

アプリケーション開発

Wailsでアプリケーションを作成する際に、厳格なルールはありませんが、基本的なガイドラインがいくつかあります。

アプリケーションセットアップ​

デフォルトのテンプレートを使用した場合、main.goにはアプリケーションの構成および起動コードが記述され、app.goにはアプリケーションのロジック定義が記述されています。

app.goファイルには、メインアプリケーションのフックとして機能する2つのメソッドを持った構造体を定義します。

app.go
type App struct {
    ctx context.Context
}

func NewApp() *App {
    return &App{}
}

func (a *App) startup(ctx context.Context) {
    a.ctx = ctx
}

func (a *App) shutdown(ctx context.Context) {
}

  • startupメソッドは、Wailsが起動時に、必要リソースの割り当てが完了した際にすぐに呼び出されます。このメソッド内は、リソースの作成、イベントリスナーの設定、その他アプリケーションに必要な初期処理を実施するのに適しています。 メソッド呼び出し時に与えられるcontext.Contextは、通常は、構造体のフィールドに格納するようにしてください。 なぜならば、このcontextはruntimeを呼び出す際に必要なためです。 このstartupメソッドがエラーを返却した場合、アプリケーションは終了します。 開発モードの場合、コンソールにエラーが出力されます。

  • shutdownメソッドは、シャットダウンプロセスの最後に、Wailsによって呼び出されます。 このメソッド内は、メモリを解放し、任意のシャットダウンタスクを実施するのに適しています。

通常、main.goファイルでは、アプリケーション構成を受け取るwails.Run()メソッドを1回だけ呼び出すようにします。 テンプレートでは、wails.Run()を呼び出す前に、app.goで定義した構造体のインスタンスを作成して、appに格納しています。 アプリケーション構成では、コールバックを追加できます:

main.go
func main() {

    app := NewApp()

    err := wails.Run(&options.App{
        Title:             "My App",
        Width:             800,
        Height:            600,
        OnStartup:  app.startup,
        OnShutdown: app.shutdown,
    })
    if err != nil {
        log.Fatal(err)
    }
}

アプリケーションのライフサイクルフックについて詳しくは、こちらをご覧ください。

メソッドのバインディング​

フロントエンドからGoのメソッドを呼び出したいことがありますよね。 そのようなときは、app.goですでに定義している構造体に、パブリックメソッドを追加しましょう:

app.go
type App struct {
    ctx context.Context
}

func NewApp() *App {
    return &App{}
}

func (a *App) startup(ctx context.Context) {
    a.ctx = ctx
}

func (a *App) shutdown(ctx context.Context) {
}

func (a *App) Greet(name string) string {
    return fmt.Sprintf("Hello %s!", name)
}

アプリケーション構成のBindキーで、Wailsに何をバインドさせたいかを指定できます:

main.go
func main() {

    app := NewApp()

    err := wails.Run(&options.App{
        Title:             "My App",
        Width:             800,
        Height:            600,
        OnStartup:  app.startup,
        OnShutdown: app.shutdown,
        Bind: []interface{}{
            app,
        },
    })
    if err != nil {
        log.Fatal(err)
    }
}

これにより、App構造体のすべてのパブリックメソッドがバインドされます（startupメソッド・shutdownメソッドはバインドされません）。

複数の構造体をバインドするときのcontextの扱い​

もし、複数の構造体のメソッドをバインドしたくて、かつ、各構造体でランタイム関数を呼び出せるようにcontextを共有したい場合は、OnStartupのコールバック内で、各構造体にcontextを渡してあげるのが良いでしょう:

func main() {

    app := NewApp()
    otherStruct := NewOtherStruct()

    err := wails.Run(&options.App{
        Title:             "My App",
        Width:             800,
        Height:            600,
        OnStartup:  func(ctx context.Context){
            app.SetContext(ctx)
            otherStruct.SetContext(ctx)
        },
        OnShutdown: app.shutdown,
        Bind: []interface{}{
            app,
            otherStruct
        },
    })
    if err != nil {
        log.Fatal(err)
    }
}

バインディングの詳細については、こちらをご覧ください。

アプリケーションメニュー​

Wailsでは、アプリケーションにメニューを追加することができます。 追加したい場合は、アプリケーション構成にMenu構造体を渡してください。 通常は、Menuを返すようなメソッドを使用するようにします。ライフサイクルフックに使用されるApp構造体のメソッドとして用意するのが良いでしょう。

main.go
func main() {

    app := NewApp()

    err := wails.Run(&options.App{
        Title:             "My App",
        Width:             800,
        Height:            600,
        OnStartup:  app.startup,
        OnShutdown: app.shutdown,
        Menu:       app.menu(),
        Bind: []interface{}{
            app,
        },
    })
    if err != nil {
        log.Fatal(err)
    }
}

アセット​

Wails v2にアセットを処理させるための方法は複雑ではありません。 Wailsに与える必要があるのは、embed.FSだけです。 任意の方法で与えてあげてください。 バニラテンプレートで使用されているように、素のhtml/css/jsファイルをアセットとして使用できます。 もちろん、複雑なビルドシステムを使用することも可能ですが、必須要件ではありません。

wails buildコマンドを実行すると、プロジェクトルートディレクトリに存在するプロジェクト構成ファイルであるwails.jsonのチェックが行われます。 プロジェクトファイルには、次の2つのキーを含めることができます:

  • "frontend:install"
  • "frontend:build"

1番目のキーは、frontendディレクトリにおいて、nodeモジュールをインストールするためのコマンドを指定します。 2番目のキーは、frontendディレクトリにおいて、フロントエンドをビルドするためのコマンドを指定します。

2つのキーのどちらともが指定されていない場合、Wailsはフロントエンドプロジェクトに対する操作を一切行いません。 embed.FSで指定されたディレクトリを参照するのみとなります。

アセットハンドラ​

Wails v2では必要に応じて、options.Appの中にhttp.Handlerを定義することができます。これにより、アセットサーバにフックして、その場でファイルを作成したり、POST/PUTリクエストを処理したりすることができます。 GETリクエストが要求されたときは、まず初めに、assets FSにハンドリングされます。 リクエストされたファイルをFSが見つけられなかった場合、そのリクエストはhttp.Handlerに転送されます。 GET以外のリクエストは、AssetsHandlerが指定されていれば、当該ハンドラによって直接処理されます。 なお、Assetsオプションにnilを指定することで、AssetsHandlerのみを使用することも可能です。

ビルトイン開発サーバ​

wails devコマンドを実行すると、ビルトイン開発サーバが起動し、プロジェクトディレクトリ内のファイル監視が開始されます。 デフォルトでは、ファイルの中身が変更された場合、Wailsはそのファイルがアプリケーションファイルであるかどうかをチェックします(デフォルト: .go、 -eフラグで制御可能)。 アプリケーションファイルであった場合は、アプリケーションをリビルドして再起動します。 アセットディレクトリ内でファイルが変更された場合は、少し経ってからリロードが実行されます。

開発サーバは"デバウンシング"と呼ばれるテクニックを使用しています。これにより、短時間で複数のファイルが更新されたとしても、すぐに再読み込みされることはありません。 トリガーが起動すると、再読み込みを実行する前に一定時間待機します。 待機中に別のトリガーが起動した場合、待機時間はリセットされます。 デフォルトでは、待機時間は100msです。 この待機時間の値があなたのプロジェクトで適切ではない場合、-debounceフラグを使用して変更することができます。 このフラグを使用すると、値がプロジェクト構成ファイルに保存され、次回以降のデフォルト値となります。

外部開発サーバ​

フレームワークによっては独自のライブリロードサーバが付属しているものがありますが、それらはWailsのGoバインディングを使用することができません。 このような場面では、Wailsが監視するビルドディレクトリ内で、プロジェクトをリビルドする監視スクリプトを実行すると良いでしょう。 例としては、rollupを使用するデフォルトのsvelteテンプレートをご覧ください。 またcreate-react-appを使用する場合、このスクリプトを使用すると同様の結果を得ることができます。

Goモジュール​

デフォルトのWailsテンプレートは、モジュール名が"changeme"となっているgo.modファイルを生成します。 プロジェクトの生成が完了したら、適切なモジュール名に変更してください。