開発者オプション¶
Added in version 2.0.3.
開発者オプションです。 仕様は予告なく変更される可能性があります。
boot_config.json¶
Blender の CONFIG ディレクトリ配下に置かれる、起動前に読む外部設定ファイルです。
アドオンの register() よりも前に読み込まれます。
設定項目¶
キー |
型 |
デフォルト |
説明 |
|---|---|---|---|
|
bool |
|
|
|
bool |
|
起動時の初期化ログを有効にする |
|
string |
|
データ永続化バックエンド（現在は |
|
bool |
|
|
|
bool |
|
起動成功後、PME のアドオンパッケージ内に |
読み込み優先順位¶
コマンドライン引数 > boot_config.json > 既定値
Tip
--pme-log-init フラグがあれば init_log_enabled の値に関係なくログが有効になります。
ファイル形式¶
{
"version": 1,
"enable_public_api_alias": false,
"init_log_enabled": false,
"persistence_backend": "prefs",
"dev": {
"use_loader_manifest": true,
"auto_generate_candidate": false
}
}
更新・上書きポリシー¶
アドオンの更新では 上書きされない
ファイルが存在しない場合、デフォルト値で自動生成される
ファイルが壊れている場合、デフォルト値で起動を続行する
削除すると次回起動時にデフォルトで再生成される
loader_manifest.json¶
アドオンに同梱される、モジュール読み込み順を定義したファイルです。
役割¶
リリース用ビルドに含まれる静的ファイル
起動時のモジュール読み込み順を素早く確定するために使う
通常はユーザーが直接編集しない
ファイル形式¶
{
"version": 1,
"module_order": [
"core.namespace",
"infra.logging",
"infra.boot_config",
"..."
]
}
フォールバック¶
loader_manifest.json が見つからない、または壊れている場合は、依存関係ベースの動的探索に戻ります。
モジュール読み込み順の決定順¶
--pme-use-candidate-loader-manifest--pme-use-loader-manifest/--pme-no-loader-manifestboot_config.dev.use_loader_manifestloader_manifest.json依存関係ベースの動的探索
通常起動では、
loader_manifest.jsonを使いますdev.use_loader_manifest = falseの場合は、依存関係ベースの動的探索で起動します検証用 manifest は開発用の補助経路であり、この設定だけで直接採用されることはありません
検証用 manifest または
loader_manifest.jsonが使えない場合は、動的探索に戻ります
検証用 loader manifest (loader_manifest_candidate.json)¶
loader_manifest_candidate.json は、開発中の確認に使う検証用 loader manifest です。
作成場所¶
loader_manifest_candidate.jsonは PME のアドオンパッケージ内に作成されます
役割¶
起動成功時に観測されたモジュール読み込み順を記録する
loader_manifest.jsonへ反映する前の比較や確認に使うUse Bundled Loader Manifest の ON/OFF だけでは自動採用されない
作成される条件¶
次の条件をすべて満たしたときだけ loader_manifest_candidate.json が作成されます。
boot_config.dev.auto_generate_candidate == trueまたは Developer UI で Save Candidate Loader Manifest を実行している
起動処理が成功している
bundled / candidate manifest ではなく、動的探索で起動している
保存先へ書き込める
loader_manifest.json への反映¶
検証用 manifest から loader_manifest.json への反映は、通常起動の途中では行われません。
次のどちらかの明示操作でのみ反映されます。
python3 tools/promote_loader_manifest.pyPreferences > Settings > Developer の Promote Candidate to Bundled
Settings > Developer UI¶
Preferences > Settings > Developer タブで、boot_config.json を編集することができます。
変更した値は
boot_config.jsonにすぐ書き戻されます起動時には
boot_config.jsonの内容が UI に反映されますimport pmeと初期化ログのような起動前設定は、次回起動から有効 ですUse Bundled Loader Manifest は、
loader_manifest.jsonで起動するか、動的探索で起動するかを切り替えますAuto-Save Candidate on Startup は、起動成功後に
loader_manifest_candidate.jsonを作成しますSave Candidate Loader Manifest は、現在の動的探索の読み込み順を
loader_manifest_candidate.jsonに書き出しますPromote Candidate to Bundled は、検証用 manifest の内容を
loader_manifest.jsonに反映する操作です
注釈
dev namespace の設定は、同一 Blender プロファイル上にある全ての PME インストールに影響します。