macOSでXcodeを使ってPlistファイルを編集する方法

macOS では、Xcode の構造化エディタを使用してプロパティ リスト (.plist) ファイルを編集できます。ファイルをバックアップしてから Xcode で開き、ドキュメントに記載されているキーと値のみを変更して保存してください。サードパーティ製アプリのインストール済みバンドルを編集することは避けてください。署名付きアプリを変更すると、署名が無効になったり、アップデートが失敗したりする可能性があります。独自のアプリの場合は、プロジェクトのソースまたはビルド設定を編集して再ビルドしてください。

plistを直接編集するタイミング

プロパティリストには、文字列、数値、ブール値、配列、辞書などの構造化データが格納されます。アプリのplistファイルはInfo.plistバンドルを記述し、個別のplistファイルに設定を保存できます。アプリで説明されているファイルとキーを使用してください。キーを独自に作成しても、設定のサポートは追加されません。

編集する前に、ファイルにアプリのメタデータが含まれているか、ユーザー設定が含まれているかを確認してください。使用しているアプリの機能を変更したい場合は、まずそのアプリの設定またはドキュメントを参照してください。設定ファイルはアプリの起動時または終了時に書き換えられる場合があります。インストール済みのバンドルは、Info.plist一般的な設定パネルではありません。

管理している Xcode プロジェクトの場合は、まずターゲットの情報パネルとビルド設定を確認してください。Xcode はInfo.plistビルド時にファイルを生成することがあるため、ビルド済みのコピーを編集しても一時的なものになる可能性があります。Apple の編集ガイドでは構造化エディタについて説明しており、ビルド設定のリファレンスでは生成される値について解説しています。

Xcodeでplistファイルを編集する

1. Xcodeをインストールします

Mac App StoreからXcodeを入手してください。現在は無料版として掲載されています。お使いのMacに対応したバージョンの必要条件については、掲載情報をご確認ください。インストール後、一度Xcodeを起動してください。

Mac App Storeの検索結果に、AppleのXcodeの掲載情報と「入手」ボタンが表示される。
XcodeのMac App Store掲載ページ(「入手」ボタン付き)。

2. 動作するバックアップを作成する

Finderでplistファイルを見つけて、編集する前に複製するか、作業フォルダにコピーしてください。変更内容を確認するまでは元のファイルを保管しておいてください。バックアップはアプリの.appバンドルとは別の場所に保存してください。そこにファイルを追加すると、署名されたコンテンツが変更される可能性があります。

Finderのリストビューに、サンプルプロジェクトフォルダ内のInfo.plistと、別途作成されたInfo copy.plistバックアップが表示されている。
編集作業を行う前に、必ず別のバックアップを作成してください。

3. 必要に応じてアプリ内でファイルを探す

アプリバンドルを検査するには、FinderでアプリをControlキーを押しながらクリックし、「パッケージの内容を表示」を選択します。これにより、内部フォルダが表示されます。この機能は、ファイルを探したり、自分が管理していて再構築または再署名できるアプリのみを編集する場合に使用してください。サードパーティ製アプリをその場でパッチ適用しないでください。

Finderのアプリケーションビューで、サンプルアプリが選択され、コンテキストメニューで「パッケージの内容を表示」がハイライト表示されている状態。
Finderはアプリの内部ファイルを表示します。

4. バンドル内のplistファイルを開きます。

を開きContents、 を探してくださいInfo.plist。他の plist ファイルは別の場所にある場合があるので、アプリまたはプロジェクトのドキュメントを参照してください。スタンドアロン ファイルの場合は、通常の Finder の場所を使用してください。

FinderウィンドウにContentsフォルダが表示され、アプリバンドルファイルの中からInfo.plistが選択された状態になっている。
アプリのContentsフォルダ内にあるInfo.plistファイル。

5. Xcodeでファイルを開きます

plistファイルをControlキーを押しながらクリックし、「このアプリケーションで開く」>「Xcode」を選択します。Xcodeが見つからない場合は、「その他」を選択し、「アプリケーション」からXcodeを選択します。または、Xcodeを開いて「ファイル」>「開く」を選択することもできます。構造化されたplistファイルは、キー、型、値の行として表示されます。

FinderのコンテキストメニューでInfo.plistを開き、「このアプリケーションで開く」を展開してXcodeを選択した状態。
「プログラムから開く」でXcodeを選択します。

6. 既存の値を変更するか、行を追加する

既存の値をクリックして編集します。設定を追加するには、エディター内でControlキーを押しながらクリックし、 「行を追加」を選択するか、追加コントロールをクリックします。アプリで説明されているキーを正確に使用してください。スペルミスのあるキーやサポートされていないキーは無視される場合があります。

Xcodeのプロパティリストテーブルに、キー、タイプ、値の列が表示され、「行を追加」コマンドが開いた状態。
ドキュメント化されたプロパティリストキーを追加します。

7. 値の型を確認して保存します。

値の型をドキュメントに記載されている形式に一致させてください。ブール値、数値、文字列は互換性がありません。配列には順序付き項目が格納され、辞書には名前付き値が格納されます。推測したキーや重複したキーは避け、Command-Sを押してください。

  • 文字列:識別子やラベルなどのテキスト。
  • ブール値:真または偽。
  • 数値:整数または実数。
  • 配列または辞書:名前付き値のリストまたはグループ。
Xcodeエディタで、サンプルCFBundleName文字列がSampleApp Proに変更されている様子が表示されているが、他の行は表示されたままになっている。
編集された文字列値の例。

8. 保存したファイルを再度開き、確認します。

plistファイルを閉じて再度開き、値が保持されていることを確認してください。独自のプロジェクトの場合は、コピーを再構築してテストしてください。アプリがそれを無視する場合は、正しいソースファイルを編集したかどうかを確認してください。アプリは他の場所から設定を読み込んだり、起動時に置き換えたりすることがあります。アプリが失敗した場合は、バックアップを復元するか、再インストールしてください。

Xcodeのプロパティリストエディタが再度開かれ、保存されたSampleApp Proの文字列がテーブルに表示された。
保存した値を使ってファイルを再度開きました。

重要な署名とトラブルシューティングに関する注意事項

Appleは、署名済みのアプリバンドルを変更すると署名が無効になる可能性があること、またアップデートによって変更内容が上書きされる可能性があることを警告しています。保守しているソフトウェアの場合は、ソースのplistファイルまたはターゲットの設定を変更してから再ビルドしてください。通常の環境設定については、アプリの設定を使用してください。plistファイルを編集するためにmacOSの保護機能を無効にしないでください。

Xcodeで保存できない場合は、書き込み可能なコピーから作業してください。再ビルド後に変更が消える場合は、ソースまたはビルド設定を更新してください。キーが無視される場合は、アプリのドキュメントでそのキーのスペル、タイプ、および場所を確認してください。

詳細については、Apple の情報プロパティ リストのドキュメントおよびmacOS のコード署名に関する技術ノートを参照してください。

(23) コメント

  1. さくら -

    今回の方法でPlistファイルを無事に編集できて本当に嬉しいです!また新しい情報があれば教えてください

  2. 小林健二 -

    この手法、意外と簡単ですね。ただ、設定ミスがあると怖いので注意が必要そうです

  3. 鬼塚翔太 -

    この方法を見てやってみましたが、成功しました!本当にありがとう

  4. 山田花子 -

    この方法を試してみたけど、もう少し詳しい説明が欲しいです。どこで今後の更新情報を得られますか?

  5. むぎ茶 -

    自分もこの方法を使ってみた結果、設定が簡単に変更できて助かりました

  6. さとし -

    それにしても、Plistファイルがあんなにたくさんの設定を持っているなんて初めて知りました!驚きです

  7. 佐藤太郎 -

    この方法でPlistファイルを編集するのが簡単だと思います!本当に助かりました。ありがとう

  8. 大野大輔 -

    このトピックについての他のリソースはありますか?もっと掘り下げたいです

  9. 清水幸子 -

    この記事、お友達にも教えたい!Plistファイルについてもっと情報を共有したいです

  10. りんご娘 -

    それにしても、Plistファイルの編集って思ったより面白いですね。もっと多くの情報をお待ちしています

  11. 山本陽介 -

    編集後にアプリが正常に動作するか少し不安なんですが、試してみる価値はありそうです

  12. 光一 -

    素晴らしい情報を共有してくれてありがとう!これでMacをより効率的に使えそうです。

  13. 成田あかり -

    Plistを編集することで、アプリのカスタマイズができるなんて新発見でした

  14. 田村健司 -

    このやり方、他にも応用が利きそうですね。仕事で役立てられそうです。本当にありがとうございます

  15. はるか -

    自分でPlistファイルを編集するのは初めてですが、この記事のおかげで道が開けた気がします!

  16. 太田健 -

    Plistファイルってどうやってバックアップすればいいですか?いざという時のために知りたいです

  17. タケシ -

    プログラム初心者ですが、このやり方にチャレンジしてみようかな。簡単そうに見えるから!

  18. はなまる -

    私のMacでも同じ方法が使えるか試してみます。期待しています

  19. ヒロキ -

    内容が明確で読みやすいですね。私は最近、Plistファイルの問題に直面していたのでとても助かりました

  20. リョウタ -

    質問ですが、Plistファイルが破損したらどう対処すればいいですか?逆に怖い気がします。

  21. 田中美咲 -

    Plistファイルの編集をする際の注意点があれば教えてください

  22. 猫好き -

    猫ちゃんもこの方法で設定を変更するの?それとも私のお気に入りのアプリだけかな

  23. オタク大好き -

    素晴らしい記事! Plistファイルを編集するのが難しいと思っていたけど、ここで学びました。感謝

コメントを残す

Macでアプリを強制終了する方法:アプリを素早く閉じる5つの方法

Macでアプリを強制終了する方法:アプリを素早く閉じる5つの方法

応答しないMacアプリを強制終了するには、Option+Command+Escキーを押すか、Appleメニュー、Dock、アクティビティモニタ、またはターミナルからアプリを閉じます。

Macで分割画面を使用する方法:2つのアプリを並べて表示する

Macで分割画面を使用する方法:2つのアプリを並べて表示する

Split Viewの設定方法、ペインのサイズ変更や置換方法、Mission Controlの使い方、そしてMacでデスクトップウィンドウのタイル表示がより適している場面について学びましょう。

macOSで写真からEXIFデータを削除する方法

macOSで写真からEXIFデータを削除する方法

macOSで写真からEXIFデータを削除する方法、写真アプリで位置情報を隠す方法、ExifToolを使用してエクスポートしたJPEGコピーをクリーンアップする方法、そして結果を確認する方法を学びましょう。

Macで2つのフォルダを安全に同期する方法

Macで2つのフォルダを安全に同期する方法

SyncTwoFoldersを使えば、Mac上の2つのフォルダを同期できます。一方向または双方向の更新を選択でき、ファイルの置換や削除を行う前に変更内容をプレビューできます。

MacでTumblrブログをバックアップする方法

MacでTumblrブログをバックアップする方法

Tumblrのウェブエクスポート機能を使って、Mac上でTumblrブログをバックアップしましょう。ZIPファイルをダウンロードして解凍すれば、投稿やメディアを安全に保存でき、アーカイブに含まれないデータも確認できます。

MacのデスクトップでGoogleマップを使用する方法

MacのデスクトップでGoogleマップを使用する方法

MacのSafariまたはChromeでGoogleマップを使用し、場所やルートを検索したり、マップレイヤーを切り替えたり、macOS Sonoma 14以降でSafariウェブアプリをDockに追加したりできます。

WindowsとmacOS向けの無料WAVからMP3への変換ソフトベスト5

WindowsとmacOS向けの無料WAVからMP3への変換ソフトベスト5

WindowsとmacOSに対応した無料のWAVからMP3への変換ソフト5つを比較します。オンラインファイル数の制限、ローカルバッチツール、実用的なエクスポート設定などについても解説します。

WindowsとMacでマウスを使わずに右クリックする方法

WindowsとMacでマウスを使わずに右クリックする方法

WindowsとMacでコンテキストメニューを開くためのキーボードショートカットとアクセシビリティ機能(マウスキーやMacのコンテキストメニューキーなど)を学びましょう。

Windows向けおすすめファイルマネージャー:ファイルエクスプローラーの代替となる5つのツール

Windows向けおすすめファイルマネージャー:ファイルエクスプローラーの代替となる5つのツール

無料のQ-DirやFilesから、デュアルペイン表示や上級者向けツールまで、5つのWindowsファイルマネージャーを比較し、ファイルのコピー、並べ替え、整理に最適なものを見つけましょう。

macOSのFinderに位置情報バーを追加する方法

macOSのFinderに位置情報バーを追加する方法

Finderのクリック可能なパスバーを表示したり、ターミナル設定を使用してウィンドウタイトルに完全なフォルダパスを表示したり、macOSの組み込みコマンドを使用してパスをコピーしたりできます。