Skip to content
Copied!
published on 2026-06-08

Settings

TOML 形式の設定ファイルを持つアプリ向けの,独立した設定ウィンドウです。本体とは別プロセスとして動作し,設定ファイルの読み書きのみを担います。

8章公開済み開始:
  1. はじめに

    TOML形式の設定ファイルを持つアプリ向けの,独立した設定ウィンドウです。本体とは別プロセスとして動作し,設定ファイルの読み書きのみを担います。config.tomlのパスを引数で渡します。省略時の既定パスは組み込みを参照してください。

  2. スキーマリファレンス

    スキーマはTOMLで記述し,ビルド時にバイナリへ埋め込まれます。作者はフィールドの意味とTOML構造を把握すれば,設定UIを組み立てられます。型・デフォルト値の厳密な一覧はsettings-schemaクレート(settings-schema/src/lib.rs)を参照してください。タブの中に,設定ファイルの内容に応…

  3. ビルド

    Windows向け.exeは,macOS上でmingw-w64とx86_64-pc-windows-gnuターゲットを使ってクロスビルドします。Linux向けバイナリはmacOSからのクロスコンパイルが難しいため,Linuxホスト上でネイティブにビルドします。ARCH slug: darwin-arm64 / darw…

  4. 組み込み

    同一のconfig.tomlに対して同時に開けるSettingsは1プロセスのみです。同じ設定ファイルのパスを指定して二重起動した場合,後から起動したプロセスは即座に終了します。設定ファイルのパスが異なれば,複数のウィンドウを同時に開けます。引数を省略して起動した場合に読み込まれる既定パスは,プラットフォームと同梱形態…

  5. ローカライゼーション

    Settingsは16言語のUI文字列を組み込んでおり,スキーマ内の文字列も同じ仕組みでローカライズできます。langは,組み込みのUI翻訳とスキーマ内ローカライズ表の両方の表示言語に効きます。対応言語コードの一覧は下記の組み込み16言語を参照してください。lang = "os"のとき,lang_keyで指定した設定キ…

  6. テーマ

    "os"を指定した場合は,アプリ起動中にOSのテーマが切り替わってもリアルタイムに追従します。タイトルバーなどOSが描画するネイティブ装飾も,解決後のテーマに合わせて切り替わります。background_color・accent_color・text_color・tab_text_color・selection_bg_…

  7. 検証

    v0.2で追加された機能です。CEL(Common Expression Language)式を使ってフィールド値を検証できます。スキーマのトップレベルに,再利用可能な検証ルールを名前付きで定義できます。制約idを文字列で参照するか,フィールド側にインラインで式とメッセージを書きます。segmented_control…

  8. ウィジェットリファレンス

    各ウィジェットのTOML例は,全ウィジェットを網羅したテスト用スキーマrepos/settings/demo/schema.tomlを正とします。一行テキスト入力です。min_width / max_widthで幅を調整できます。マスク入力です。表示/非表示を切り替えるアイコンが付きます。複数行テキスト入力です。row…