如何在 macOS 上使用 Xcode 編輯 plist 文件

在 macOS 上，您可以使用 Xcode 的結構化編輯器編輯屬性清單 (.plist) 檔案。請先備份該文件，然後在 Xcode 中開啟它，僅更改文件中已記錄的鍵和值，最後儲存。避免編輯第三方應用程式的已安裝套件：更改已簽署的應用程式可能會使其簽名失效或導致更新失敗。對於您自己的應用程序，請編輯專案原始碼或建置設定並重新建置。

何時直接編輯 plist 文件

屬性列表用於儲存結構化數據，包括字串、數字、布林值、陣列和字典。應用程式的屬性Info.plist清單描述了其應用程式包；單獨的屬性清單可以儲存偏好設定。請使用應用程式文件中記錄的文件和按鍵：自行建立鍵並不會為某個設定新增支援。

在編輯前，請先確定該檔案包含的是應用程式元資料還是使用者偏好設定。如果您想要變更正在使用的應用程式中的某項功能，請先檢視該套用的設定或文件。偏好設定檔可能會在應用程式啟動或登出時被重寫；已安裝的軟體包的偏好設定Info.plist並非通用設定面板。

對於您維護的 Xcode 項目，請先檢查目標的「資訊」面板和建置設定。 Xcode 可能會Info.plist在建置時產生一些設置，因此編輯已建置的副本可能只是暫時的。 Apple 的編輯指南涵蓋了結構化編輯器；其建構設定參考解釋了產生的值。

使用 Xcode 編輯 plist 文件

1. 安裝 Xcode

從Mac App Store取得 Xcode 。目前它是免費的；請查看產品頁面，以了解適用於您 Mac 的版本要求。安裝完成後，啟動一次 Xcode。

2. 製作一份可用的備份

在 Finder 中找到 plist 文件，將其複製或複製到工作資料夾後再進行編輯。在驗證更改之前，請保留原始文件。將備份檔案儲存在應用程式.app套件之外；向應用程式套件中新增檔案可能會變更其簽名內容。

3. 如有需要，請在應用程式內尋找該檔案。

若要查看應用程式包，請在 Finder 中按住 Control 鍵並點擊該應用程序，然後選擇「顯示包內容」。這將顯示其內部資料夾。您可以使用此功能查找文件，或僅編輯您維護且可重新建置或重新簽署的應用程式；請勿直接修改第三方應用程式。

4. 開啟捆綁包中的 plist 文件

開啟文件Contents，然後尋找Info.plist。其他 plist 檔案可能位於其他位置，請參考應用程式或專案文件。對於獨立文件，請使用其在 Finder 中的常規位置。

5. 在 Xcode 中開啟該檔案。

按住 Control 鍵並點擊 plist 文件，然後選擇「開啟方式」>「Xcode」。如果找不到 Xcode，請選擇「其他」，然後從「應用程式」中選擇它。您也可以開啟 Xcode，然後選擇「檔案」>「開啟」。結構化的 plist 檔案會顯示為鍵、類型和值三行。

6. 更改現有值或新增行

點選現有值即可編輯。若要新增設置，請在編輯器中按住 Control 鍵並點擊，然後選擇「新增行」，或點擊新增控制項。請使用應用程式文件中記錄的準確鍵值；拼字錯誤或不支援的鍵值可能會被忽略。

7. 檢查值類型並儲存

請確保值類型與文件中規定的格式一致：布林值、數字和字串不能互換。陣列儲存有序項；字典儲存命名值。避免猜測或重複的按鍵，然後按Command-S。

• 字串：文本，例如識別碼或標籤。
• 布林值：真或假。
• 數字：整數或實數。
• 陣列或字典：一組命名值的清單或集合。

8. 重新開啟並驗證已儲存的文件

關閉並重新開啟 plist 檔案以確認變更已生效。對於您自己的項目，請重新建置並測試副本。如果應用程式忽略此更改，請檢查您是否編輯了正確的來源檔案；應用程式可能會從其他位置讀取首選項，或在啟動時替換它們。如果應用程式運行失敗，請還原備份或重新安裝。

重要簽章和故障排除說明

蘋果指出，修改已簽署的應用程式套件可能會使其簽章失效；更新也可能會覆寫修改。對於您維護的軟體，請變更來源 plist 檔案或目標設置，然後重新建置。對於普通偏好設置，請使用應用程式的設定。請勿停用 macOS 的保護措施來編輯 plist 檔案。

如果 Xcode 無法儲存，請使用可寫入副本進行操作。如果重新建置後變更消失，請更新原始程式碼或建置設定。如果某個鍵被忽略，請在應用程式文件中驗證其拼字、類型和位置。

有關更多詳細信息，請參閱 Apple 的資訊屬性列表文件及其關於 macOS 代碼簽名的技術說明。