Корневое содержание файла схемы

Каждый отличный экран настроек представлен файлом списка свойств. Как минимум пакет настроек должен иметь a Root.plist файл, содержащий содержание основного экрана настроек. Дополнительные файлы списка свойств могут создаваться и использоваться для отображения предпочтений на дочерних экранах, к которым получают доступ с помощью дочернего элемента области. Каждый файл списка свойств содержит несколько ключей (перечисленный в Таблице 1) на верхнем уровне, которые предоставляют основную информацию.

Табличные 1  ключи Корневого уровня предпочтительной схемы

Ключ

Ввести

Значение

PreferenceSpecifiers (требуемый)

Массив

Массив словарей, каждый из которых содержит данные для единственного предпочтительного элемента. Порядок элементов в массиве определяет порядок, что они выведены на экран на экране.

StringsTable

Строка

Имя строкового файла связалось с этим файлом схемы. Копия этого файла (с надлежащими локализованными строками) должна быть расположена в каждом из специфичных для языка каталогов проекта Вашего пакета. Если Вы не включаете этот ключ, строки в этом файле схемы не локализуются. Для получения информации о создании строковых файлов посмотрите Руководство по Интернационализации и Локализации.

ApplicationGroupContainerIdentifier

Строка

Идентификатор группы приложений для использования для хранения предпочтительных значений. Укажите этот ключ, когда Вы захотите, чтобы предпочтения были сохранены в контейнере кроме того, используемого Вашим приложением для iOS. Например, укажите этот ключ при создании пакета настроек WatchKit так, чтобы расширение WatchKit могло получить доступ к предпочтениям.

Включите возможность Групп приложений каждой исполнимой программы, которая должна получить доступ к совместно используемым предпочтениям. Группа, которую Вы выбираете, должна соответствовать значение этого ключа. К предпочтениям доступа, сохраненным в группе, передайте значение этого ключа к initWithSuiteName: метод Вашего NSUserDefaults объект.

Этот ключ поддерживается в iOS 8.2 и позже.

Строка заголовка, появляющаяся наверху каждого экрана настроек, получена из внешнего источника. В случае корневого экрана настроек Вашего приложения строка заголовка является самим именем приложения. Для дочерних экранов настроек заголовок взят от ключа Title дочернего элемента области, используемого для отображения того экрана. Для получения дополнительной информации об этом ключе, посмотрите Дочерний Элемент Области.

Каждый словарь в PreferenceSpecifiers ключ содержит ключи, связанные с предпочтительным элементом. Таблица 2 перечисляет поддерживающиеся типы элемента.

Табличные 2  типы Элемента, содержавшиеся в PreferenceSpecifiers ключ

Тип элемента

Описание

PSTextFieldSpecifier

Предпочтение текстового поля. Этот элемент выводит на экран дополнительный заголовок и доступное для редактирования текстовое поле. Можно использовать этот тип для предпочтений, требующих, чтобы пользователь указал значение пользовательской строки. Для получения дополнительной информации посмотрите Элемент Текстового поля.

PSTitleValueSpecifier

Строковое предпочтение только для чтения. Можно использовать этот тип для отображения предпочтительных значений как отформатированных строк. Для получения дополнительной информации посмотрите Элемент Заголовка.

PSToggleSwitchSpecifier

Предпочтение тумблера. Можно использовать этот тип для конфигурирования предпочтения, которое может иметь только одно из двух значений. Несмотря на то, что Вы обычно используете этот тип для представления предпочтений, содержащих булевы значения, можно также использовать его с предпочтениями, содержащими небулевы значения. Для получения дополнительной информации посмотрите Элемент Тумблера.

PSSliderSpecifier

Предпочтение ползунка. Можно использовать этот тип для предпочтения, представляющего диапазон значений. Значение для этого типа является вещественным числом, минимум которого и максимум Вы указываете. Для получения дополнительной информации посмотрите Элемент Ползунка.

PSMultiValueSpecifier

Предпочтение мультизначения. Можно использовать этот тип для предпочтения, поддерживающего ряд взаимоисключающих значений. Для получения дополнительной информации посмотрите Много Элемент Значения.

PSRadioGroupSpecifier

Предпочтение элемента группы, используемое для выбора одного элемента в группе. Этот тип представляет единственную конфигурируемую опцию с двумя или больше значениями. Для получения дополнительной информации посмотрите Элемент Radio Group.

PSGroupSpecifier

Предпочтение элемента группы. Тип группы является способом для Вас организовать группы предпочтений на единственной странице. Тип группы не представляет конфигурируемое предпочтение. Для получения дополнительной информации посмотрите Элемент Группы.

PSChildPaneSpecifier

Дочернее предпочтение области. Можно использовать этот тип для соединения с новой страницей предпочтений. Для получения дополнительной информации посмотрите Дочерний Элемент Области.