Главная
» MAC OS X
»
Как редактировать файл Plist в macOS с помощью Xcode
Как редактировать файл Plist в macOS с помощью Xcode
В macOS вы можете редактировать файл списка свойств (.plist) в структурированном редакторе Xcode. Создайте резервную копию файла, откройте его в Xcode, измените только задокументированные ключи и значения, а затем сохраните. Избегайте редактирования установленного пакета стороннего приложения: изменение подписанного приложения может привести к аннулированию его подписи или нарушению обновлений. Для собственного приложения отредактируйте исходный код проекта или параметры сборки и пересоберите его.
Когда следует редактировать файл plist напрямую?
Списки свойств содержат структурированные данные — строки, числа, логические значения, массивы и словари. В описании приложения Info.plistуказывается его пакет; отдельные файлы plist могут хранить настройки. Используйте файл и ключ, указанные в документации приложения: создание собственного ключа не добавит поддержку той или иной настройки.
Перед редактированием определите, содержит ли файл метаданные приложения или пользовательские настройки. Если вы хотите изменить функцию в используемом приложении, начните с настроек или документации этого приложения. Файл настроек может быть перезаписан при запуске или закрытии приложения; файл настроек установленного пакета Info.plistне является общей панелью настроек.
Для проекта Xcode, который вы поддерживаете, сначала проверьте панель «Информация» и параметры сборки целевого объекта. Xcode может генерировать данные во время сборки, поэтому редактирование собранной копии может быть временным. РуководствоInfo.plist Apple по редактированию описывает структурированный редактор; в справочнике по параметрам сборки объясняются сгенерированные значения.
Редактирование файла plist с помощью Xcode
1. Установите Xcode
Загрузите Xcode из Mac App Store . В настоящее время он указан как бесплатный; проверьте требования к версии, доступной для вашего Mac. Запустите Xcode один раз после установки.
Страница Xcode в Mac App Store с кнопкой «Получить».
2. Создайте рабочую резервную копию.
Найдите файл plist в Finder и продублируйте его или скопируйте в рабочую папку перед редактированием. Сохраните оригинал, пока не подтвердите изменения. Храните резервные копии вне пакета приложения .app; добавление файлов туда может изменить его подписанное содержимое.
Перед редактированием сделайте отдельную резервную копию.
3. При необходимости найдите файл внутри приложения.
Чтобы просмотреть содержимое пакета приложения, щелкните приложение в Finder, удерживая клавишу Control, и выберите «Показать содержимое пакета» . Это отобразит его внутренние папки. Используйте эту функцию для поиска файла или редактируйте только то приложение, которое вы поддерживаете и можете пересобрать или переподписать; не вносите изменения в сторонние приложения.
Finder отображает внутренние файлы приложения.
4. Откройте файл plist в архиве.
Откройте файл Contents, затем найдите файл Info.plist. Другие файлы plist могут находиться в другом месте, поэтому следуйте документации приложения или проекта. Для поиска автономного файла используйте его обычное расположение в Finder.
Файл Info.plist находится в папке Contents приложения.
5. Откройте файл в Xcode.
Удерживая клавишу Control, щелкните файл plist и выберите «Открыть с помощью» > «Xcode» . Если Xcode отсутствует, выберите «Другое» и выберите его в списке приложений. Вы также можете открыть Xcode и использовать «Файл» > «Открыть» . Структурированный файл plist отобразится в виде строк с ключом, типом и значением.
Выберите Xcode в меню «Открыть с помощью».
6. Изменить существующее значение или добавить строку.
Щелкните существующее значение, чтобы отредактировать его. Чтобы добавить параметр, удерживайте клавишу Control и щелкните в редакторе, затем выберите «Добавить строку» или щелкните элемент управления «Добавить». Используйте точное значение ключа, указанное в приложении; неправильно написанные или неподдерживаемые ключи могут быть проигнорированы.
Добавьте документированный ключ списка свойств.
7. Проверьте тип значения и сохраните.
Сопоставьте тип значения с документированным форматом: логическое значение, число и строка не взаимозаменяемы. Массивы хранят упорядоченные элементы; словари — именованные значения. Избегайте угадывания или повторения ключей, затем нажмите Command-S .
Строка: текст, например, идентификатор или метка.
Логическое значение: истина или ложь.
Число: целое или действительное число.
Массив или словарь: список или группа именованных значений.
Пример отредактированного строкового значения.
8. Откройте файл снова и проверьте его состояние.
Закройте и снова откройте файл plist, чтобы убедиться, что значение сохранилось. Для своего проекта пересоберите и протестируйте копию. Если приложение игнорирует её, убедитесь, что вы отредактировали правильный исходный файл; приложения могут считывать настройки из других источников или заменять их при запуске. Восстановите резервную копию или переустановите приложение, если оно не работает.
Файл открыт повторно с сохраненным значением.
Важные примечания по подписанию документов и устранению неполадок.
Компания Apple отмечает, что изменение подписанного пакета приложения может привести к аннулированию его подписи; обновления также могут заменить внесенные изменения. Для программного обеспечения, которое вы поддерживаете, измените исходный plist-файл или целевую настройку, а затем пересоберите проект. Для обычных настроек используйте параметры приложения. Не отключайте защиту macOS для редактирования plist-файла.
Если Xcode не может сохранить изменения, работайте с копией, доступной для записи. Если изменения исчезают после пересборки, обновите исходный код или параметры сборки. Если ключ игнорируется, проверьте его написание, тип и местоположение в документации приложения.