<h1 id="%E6%A6%82%E8%A6%81" data-line="0" class="code-line">
<a class="header-anchor-link" href="#%E6%A6%82%E8%A6%81" aria-hidden="true"></a> 概要</h1>
<p data-line="1" class="code-line">macOS Ventura 13ではSystem Preferences（システム環境設定）のデザインが刷新され、ビジュアルから名称までiOSやiPadOSと同様の “System Settings”（システム設定）に変更されました。これに合わせて、各アプリケーションのメニューバーに収まっている “Preferences…”（環境設定…）も “Settings…”（設定…）に変更されました。<sup class="footnote-ref"><a href="#fn-b16c-1" id="fnref-b16c-1">[1]</a></sup></p>
<p data-line="3" class="code-line">今回はこのあたりの情報を少し調査したので、資料にまとめておきます。</p>
<p data-line="5" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/a384c4eb4bcc-20221105.jpg" width="600" loading="lazy" class="md-img"></p>
<h1 id="%E9%96%8B%E7%99%BA%E5%AF%BE%E5%BF%9C%E6%96%B9%E9%87%9D" data-line="7" class="code-line">
<a class="header-anchor-link" href="#%E9%96%8B%E7%99%BA%E5%AF%BE%E5%BF%9C%E6%96%B9%E9%87%9D" aria-hidden="true"></a> 開発対応方針</h1>
<p data-line="9" class="code-line">基本的には次のとおりです：</p>
<ul data-line="11" class="code-line">
<li data-line="11" class="code-line">macOS Ventura 13以降のOSでは、<code>Preference(s)</code> の文言は <code>Setting(s)</code> に書き換える</li>
<li data-line="12" class="code-line">アプリケーションメニューの <code>Preferences…</code> はmacOS SDK 13.0以降でビルドすると自動で <code>Settings…</code> に書き換えられる</li>
<li data-line="13" class="code-line">アプリケーションメニュー以外の箇所の表記は手動で対応</li>
<li data-line="14" class="code-line">ローカライズは手動で対応</li>
</ul>
<h1 id="%E3%82%A2%E3%83%97%E3%83%AA%E3%82%B1%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E3%83%A1%E3%83%8B%E3%83%A5%E3%83%BC%E3%81%AE-%E2%80%9Cpreferences%E2%80%A6%E2%80%9D-%E3%81%AE%E6%9B%B8%E3%81%8D%E6%8F%9B%E3%81%88%E6%8C%99%E5%8B%95" data-line="16" class="code-line">
<a class="header-anchor-link" href="#%E3%82%A2%E3%83%97%E3%83%AA%E3%82%B1%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E3%83%A1%E3%83%8B%E3%83%A5%E3%83%BC%E3%81%AE-%E2%80%9Cpreferences%E2%80%A6%E2%80%9D-%E3%81%AE%E6%9B%B8%E3%81%8D%E6%8F%9B%E3%81%88%E6%8C%99%E5%8B%95" aria-hidden="true"></a> アプリケーションメニューの “Preferences…” の書き換え挙動</h1>
<p data-line="18" class="code-line">Xcode 14.1 (macOS SDK 13.0)の環境でmacOS appをビルドすると、アプリケーションメニューの “Preferences…” タイトルが自動的に “Settings…” に書き換えられます。アプリケーションのランタイム内で動的に書き換え処理が走ります。Xcode 14.0.1以前でビルドしたアプリケーションではこの処理は実行されません。</p>
<p data-line="20" class="code-line">今回テストプロジェクトを作成して、あたりをつけた箇所にブレークポイントを仕掛けてこれを検証してみました。</p>
<h2 id="nsmenuitem%E3%81%AE%E3%82%B5%E3%83%96%E3%82%AF%E3%83%A9%E3%82%B9%E3%81%8B%E3%82%89%E3%82%B9%E3%82%BF%E3%83%83%E3%82%AF%E3%83%88%E3%83%AC%E3%83%BC%E3%82%B9%E3%82%92%E6%8E%A2%E3%82%8B-1" data-line="22" class="code-line">
<a class="header-anchor-link" href="#nsmenuitem%E3%81%AE%E3%82%B5%E3%83%96%E3%82%AF%E3%83%A9%E3%82%B9%E3%81%8B%E3%82%89%E3%82%B9%E3%82%BF%E3%83%83%E3%82%AF%E3%83%88%E3%83%AC%E3%83%BC%E3%82%B9%E3%82%92%E6%8E%A2%E3%82%8B-1" aria-hidden="true"></a> NSMenuItemのサブクラスからスタックトレースを探る 1</h2>
<p data-line="24" class="code-line">NSMenuItemのサブクラスを作り、<code>title</code>プロパティのdidSetに<code>print()</code>ログとブレークポイントを仕掛けてみました。するとアプリケーション起動直後にtitleの文言が“Settings…”に書き換えられていることを発見しました。<strong>アプリケーション自身が起動時に設定メニューの名前をダイナミックに書き換えているということです。</strong></p>
<p data-line="26" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/cfcbf1a5d55c-20221105.jpg" width="1200" loading="lazy" class="md-img"><br>
<em>oldValueが“Preferences…”で、newValueが“Settings…”だとわかります。</em></p>
<p data-line="29" class="code-line">これでなんとなく仕組みに察しがついたので、次は「どういうルールで名前の書き換えが起こるのか」を探ってみました。</p>
<h2 id="mainmenu%E3%81%AE%E4%B8%A6%E3%81%B3%E3%82%92%E5%A4%89%E3%81%88%E3%81%9F%E3%82%8A%E3%80%81%E5%90%8C%E3%81%98%E3%82%A2%E3%82%A4%E3%83%86%E3%83%A0%E3%82%92%E8%A4%87%E8%A3%BD%E3%81%97%E3%81%A6%E3%81%BF%E3%82%8B" data-line="31" class="code-line">
<a class="header-anchor-link" href="#mainmenu%E3%81%AE%E4%B8%A6%E3%81%B3%E3%82%92%E5%A4%89%E3%81%88%E3%81%9F%E3%82%8A%E3%80%81%E5%90%8C%E3%81%98%E3%82%A2%E3%82%A4%E3%83%86%E3%83%A0%E3%82%92%E8%A4%87%E8%A3%BD%E3%81%97%E3%81%A6%E3%81%BF%E3%82%8B" aria-hidden="true"></a> MainMenuの並びを変えたり、同じアイテムを複製してみる</h2>
<p data-line="33" class="code-line">今回のテストプロジェクトはStoryboardベースのUI設計にしていたので、Interface Builder上のMainMenuをいじり、“Preferences…”メニューアイテムを複数並べてビルドしてみました。すると次のような結果になりました。</p>
<p data-line="35" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/f0d9b1558b6e-20221105.jpg" width="300" loading="lazy" class="md-img"></p>
<p data-line="37" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/ba67567720fa-20221105.jpg" width="300" loading="lazy" class="md-img"></p>
<p data-line="39" class="code-line">これで大体察しがつきました。<strong>メニュー内に “Preferences…” が複数あっても、最初に見つかった1つ目のみがタイトルの書き換え対象になります。</strong> スクリーンショットは用意しませんでしたが、例えばFileメニューに1つ目の “Preferences…” を置いても書き換え処理が走ります。</p>
<p data-line="41" class="code-line">メニューアイテムにチェックマークがついていようが、Disableステートになっていようが、書き換え対象かどうかはタイトルのみで判断しているようです。</p>
<h2 id="nsmenuitem%E3%81%AE%E3%82%B5%E3%83%96%E3%82%AF%E3%83%A9%E3%82%B9%E3%81%8B%E3%82%89%E3%82%B9%E3%82%BF%E3%83%83%E3%82%AF%E3%83%88%E3%83%AC%E3%83%BC%E3%82%B9%E3%82%92%E6%8E%A2%E3%82%8B-2" data-line="43" class="code-line">
<a class="header-anchor-link" href="#nsmenuitem%E3%81%AE%E3%82%B5%E3%83%96%E3%82%AF%E3%83%A9%E3%82%B9%E3%81%8B%E3%82%89%E3%82%B9%E3%82%BF%E3%83%83%E3%82%AF%E3%83%88%E3%83%AC%E3%83%BC%E3%82%B9%E3%82%92%E6%8E%A2%E3%82%8B-2" aria-hidden="true"></a> NSMenuItemのサブクラスからスタックトレースを探る 2</h2>
<p data-line="45" class="code-line">さっきブレークポイントを仕掛けたところから遡ってみて、どのようなメソッドが呼ばれているのかを眺めてみました。</p>
<p data-line="47" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/ac5b94ea6fad-20221105.jpg" width="1200" loading="lazy" class="md-img"></p>
<pre class="code-line"><code>// ブレークポイントを張ったところ
   0 MenuItem.title.didset
// NSMenuItem.titleのセッターが呼ばれている
   2 @objc MenuItem.title. setter
// NSApplication内部で何やらMainMenuの書き換え処理が行われているっぽい箇所
   3 - [NSApplication(NSMenuUpdating) _updateSettingsMenuItemIfNeeded]
   4 - [NSApplication(NSMenuUpdating)_customizeMainMenu]
// アプリケーションの起動が完了
   5 - INSApplication finish Launching]
// アプリケーションのメインループ開始
   7 NSApplicationMain
</code></pre>
<p data-line="61" class="code-line">途中省きましたが、アプリケーション起動直後にNSApplication内で<code>_customizeMainMenu</code>なるメソッドが呼ばれ、次に<code>_updateSettingsMenuItemIfNeeded</code>なるメソッドも呼ばれています。その直後にブレークポイントを張ったNSMenuItem（のサブクラス）の<code>title</code>プロパティにメッセージが到達しています。名前も明らかにそれっぽい <code>_updateSettingsMenuItemIfNeeded</code> が、設定メニュー名のタイトルの書き換えを行なっている正体だと思われます。</p>
<h2 id="nsmenushouldupdatesettingstitle-%E3%81%A7%E3%82%BF%E3%82%A4%E3%83%88%E3%83%AB%E3%81%AE%E8%87%AA%E5%8B%95%E6%9B%B8%E3%81%8D%E6%8F%9B%E3%81%88%E5%87%A6%E7%90%86%E3%82%92%E6%AD%A2%E3%82%81%E3%82%8B" data-line="63" class="code-line">
<a class="header-anchor-link" href="#nsmenushouldupdatesettingstitle-%E3%81%A7%E3%82%BF%E3%82%A4%E3%83%88%E3%83%AB%E3%81%AE%E8%87%AA%E5%8B%95%E6%9B%B8%E3%81%8D%E6%8F%9B%E3%81%88%E5%87%A6%E7%90%86%E3%82%92%E6%AD%A2%E3%82%81%E3%82%8B" aria-hidden="true"></a> NSMenuShouldUpdateSettingsTitle でタイトルの自動書き換え処理を止める</h2>
<p data-line="65" class="code-line">続けて、右側のアセンブリコードの中身を少し眺めてみます。</p>
<p data-line="67" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/ac5b94ea6fad-20221105.jpg" width="1200" loading="lazy" class="md-img"><br>
<em>再掲</em></p>
<p data-line="70" class="code-line">何やらよくわからなコードだらけなのですが、一部読みやすい部分があります。一番気になるのが <code>@"NSMenuShouldUpdateSettingsTitle"</code> と書かれた部分です。<code>@""</code>はObjective-C文字列なので内部でもこの文字列を使って何かの評価が行われているっぽいです。そして名前も直球に「NSMenuがSettingsタイトルを更新するか」みたいな意味が取れるので、きっとこいつが何かのフラグになっているのだと思います。</p>
<p data-line="72" class="code-line">これを見たとき、なんとなく「NSMenuShouldUpdateSettingsTitleはdefaultsコマンドでBoolean値を指定できそうな雰囲気があるな」と思ったのですが、まさにこの見解が正解でした。ググったらちょうど次のWeb資料を見つけたのですが、ここにはdefaultsコマンドが実行できたと書かれています。</p>
<p data-line="74" class="code-line"><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__cf84e33242e1c" src="https://embed.zenn.studio/card#zenn-embedded__cf84e33242e1c" data-content="https%3A%2F%2Flapcatsoftware.com%2Farticles%2FPreferences.html" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://lapcatsoftware.com/articles/Preferences.html" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://lapcatsoftware.com/articles/Preferences.html</a></p>
<div class="code-block-container">
<div class="code-block-filename-container"><span class="code-block-filename">“Preferences…”を“Settings…”に書き換えるのをOS全体で止める</span></div>
<pre><code class="code-line" data-line="76">defaults write -g NSMenuShouldUpdateSettingsTitle -bool NO
</code></pre>
</div><p data-line="80" class="code-line"><code>-g</code>はGlobal Domainに対する指定なので、ここをBundle Identifierとかにすると特定アプリケーションのみで書き換え防止を起動変数に設定できそうです。<sup class="footnote-ref"><a href="#fn-b16c-2" id="fnref-b16c-2">[2]</a></sup></p>
<p data-line="82" class="code-line">defaults コマンドが実行できるということは、XcodeのSchemeからLaunch Argumentsを指定することでもきっと同様のことが行えるだろうと思い試したところ、これもうまくいきました。</p>
<p data-line="84" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/5b6d282469de-20221105.jpg" width="400" loading="lazy" class="md-img"></p>
<p data-line="86" class="code-line">“Arguments Passed On Launch” のところにフィールドを追加して、中身を<code>-NSMenuShouldUpdateSettingsTitle NO</code>とします。これでアプリケーションを実行すると<strong>Xcode 14.1以降のコンパイルでも設定メニュー名の書き換え処理を止めることができます。</strong></p>
<p data-line="88" class="code-line">だから何って感じではあるのですが、ドキュメントに載っていないOSの裏側の仕組みが明らかになったので興味深い気持ちは抱けたかなあと思います。実用性はあまりないでしょうが、デバッグのための知識として持っておいても損はないかと。</p>
<h1 id="%E3%83%AD%E3%83%BC%E3%82%AB%E3%83%A9%E3%82%A4%E3%82%BA%E3%81%AE%E6%96%B9%E9%87%9D" data-line="90" class="code-line">
<a class="header-anchor-link" href="#%E3%83%AD%E3%83%BC%E3%82%AB%E3%83%A9%E3%82%A4%E3%82%BA%E3%81%AE%E6%96%B9%E9%87%9D" aria-hidden="true"></a> ローカライズの方針</h1>
<p data-line="92" class="code-line">ローカライズされた文言は自動で書き換えられるわけではないため、これまで通りの方法で対応します。</p>
<p data-line="94" class="code-line">もしMainMenuのタイトルをキーに取る形でNSLocalizedString()を実行している場合、<code>Localizable.strings</code> に <code>"Preferences…" = "環境設定…";</code> 的な記述があるならそれはそのまま残しつつ、新たに <code>"Settings…" = "設定…";</code> を加えるだけで済むと思います。Main.storyboardを直接.stringsでローカライズしている場合は少し工夫が必要かもしれません。</p>
<p data-line="96" class="code-line">注意したいのは、アプリケーションがmacOS Monterey 12.x以前とmacOS Ventura 13.0以降どちらのOSにも対応するケースです。この場合、ランタイムの環境が12.xの時は “Preferences…”（環境設定…）のまま、13.0以降の時は “Settings…”（設定…）に書き換えることをしなければなりません。「<code>"Preferences…" = "環境設定…";</code>を残して<code>"Settings…" = "設定…";</code>を追加する」と言ったのはこれが理由です。</p>
<p data-line="98" class="code-line">デバッグの際はOSごとの表記の違いを意識し、どちらにも対応するようにしましょう。</p>
<h1 id="%E3%81%BE%E3%81%A8%E3%82%81" data-line="101" class="code-line">
<a class="header-anchor-link" href="#%E3%81%BE%E3%81%A8%E3%82%81" aria-hidden="true"></a> まとめ</h1>
<ul data-line="103" class="code-line">
<li data-line="103" class="code-line">macOS Monterey以前までのデザインは、“Preferences…”（環境設定…）</li>
<li data-line="104" class="code-line">macOS Ventura以降のデザインは、“Settings…”（設定…）</li>
<li data-line="105" class="code-line">Ventura対応としては、Xcode 14.1 (macOS SDK 13.0)以降でビルドすること
<ul data-line="106" class="code-line">
<li data-line="106" class="code-line">アプリケーション起動時にMainMenu内の対象アイテムのタイトルが自動で“Settings…”に書き換えられる</li>
<li data-line="107" class="code-line">NSMenuShouldUpdateSettingsTitle = NOで書き換え処理を無効化可能</li>
</ul>
</li>
<li data-line="108" class="code-line">ローカライズやその他の箇所は手動で対応</li>
</ul>
<hr data-line="111" class="code-line">
<section class="footnotes">
<span class="footnotes-title">脚注</span>
<ol class="footnotes-list">
<li id="fn-b16c-1" class="footnote-item">
<p data-line="113" class="code-line">WWDC22で言及があります：<a href="https://developer.apple.com/videos/play/wwdc2022/10074/?time=221" target="_blank" rel="nofollow noopener noreferrer">10074 - What's new in AppKit</a> <img src="https://storage.googleapis.com/zenn-user-upload/40028a18ea3b-20221105.jpg" width="400" loading="lazy" class="md-img"> <a href="#fnref-b16c-1" class="footnote-backref">↩︎</a></p>
</li>
<li id="fn-b16c-2" class="footnote-item">
<p data-line="115" class="code-line">そんなことをしても実用性がありませんが。 <a href="#fnref-b16c-2" class="footnote-backref">↩︎</a></p>
</li>
</ol>
</section>


macOS Venturaからの新しい“Settings”表記と、旧“Preferences”表記からの移行

NSMenuItemのサブクラスからスタックトレースを探る 1

MainMenuの並びを変えたり、同じアイテムを複製してみる

NSMenuItemのサブクラスからスタックトレースを探る 2

NSMenuShouldUpdateSettingsTitle でタイトルの自動書き換え処理を止める

アプリケーションメニューの “Preferences…” の書き換え挙動

Discussion