Наиболее удаленный словарь

Наиболее удаленный словарь содержит явные ключи, описывающие предпочтительный файл манифеста в целом. Некоторые явные ключи только допустимы в наиболее удаленном словаре.

Наиболее удаленный словарь обычно содержит следующие явные ключи:

• a pfm_description ключ, предоставляющий общее описание предпочтительного файла манифеста.

• a pfm_title ключ, обеспечивающий имя, которое будет показано в Предпочтительном Редакторе Декларации менеджера по Рабочей группе как имя для предпочтений приложения в целом

• a pfm_format_version ключ, указывающий предпочтительную версию формата декларации использование файла; этот ключ только допустим в наиболее удаленном словаре

• a pfm_version ключ, указывающий номер версии для этого предпочтительного файла манифеста так, чтобы это можно было отличить от других версий, которые могли бы быть выпущены; этот ключ только допустим в наиболее удаленном словаре

• a pfm_domain ключ, указывающий домен приложения для этого предпочтительного файла манифеста, такой как com.apple.myapp, где myapp обычно имя пакета приложения ID, указанный в приложении info.plist и имя что использование приложения для получения предпочтений через CPPreferences или NSUserDefaults Вызовы API.

• a pfm_subkeys ключ, указывающий, что массив словарей следует с каждым использованием словаря ключи для описания предпочтения

Вот пример наиболее удаленного словаря для названного приложения myapp:

<dict>

    <key>pfm_description</key>

    <string>Configurable preferences for MyApp.</string>

    <key>pfm_title</key>

    <string>myapp</string>

    <key>pfm_format_version</key>

    <real>1.0</real>

    <key>pfm_version</key>

    <real>0.9</real>

    <key>pfm_domain</key>

    <string>com.apple.myapp</string>

    <key>pfm_subkeys</key>

Внутренние словари

Наиболее удаленный словарь сопровождается рядом внутренних словарей, которые могут содержать другие словари.

Вот пример внутреннего словаря, который мог бы следовать pfm_subkeys введите демонстрационный наиболее удаленный словарь:

        <array>

            <dict>

                <key>pfm_name</key>

                <string>autohide</string>

                <key>pfm_title</key>

                <key>Hiding</key>

                <key>pfm_type</key>

                <string>boolean</string>

                <key>pfm_default</key>

                <false/>

                <key>pfm_description</key>

                <string>True to turn hiding on.</string>

                <key>pfm_targets</key>

                <array>

                    <string>user</string>

                    <string>user-managed</string>

                </array>

            </dict>

            // Other dictionaries containing manifest keys that  describe

            // preference keys.

        </array> // End of the array of dictionaries.

    </dict> // End of the preference manifest file.

В примере внутреннего словаря,

• pfm_name ключ определяет имя (autohide) из предпочтительного ключа.

• pfm_title ключ указывает видимое пользователем имя, показанное в Предпочтительном Редакторе Декларации менеджера по Рабочей группе.

• pfm_type ключ определяет boolean как тип данных этого предпочтительного ключа.

• pfm_default ключ определяет значение по умолчанию этого предпочтительного ключа как false.

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

• pfm_targets ключ указывает, когда и где этот предпочтительный ключ должен использоваться программным обеспечением управления клиентами OS X для надлежащего управления пользователем или компьютером. В этом примере, user указывает, что ключ может быть установлен в предпочтениях пользователя (в ~/Library/Preferences/com.apple.myapp.plist) и user-managed указывает, что ключ может быть установлен в управляемых предпочтениях пользователя (в /Library/Managed Preferences/имя пользователя/com.apple.myapp.plist, где имя пользователя является кратким названием зарегистрированного пользователя).

Значения по умолчанию

Если явный ключ не определяется для предпочтительного ключа, менеджер по Рабочей группе использует контекст и использование для определения значения по умолчанию для неопределенного ключа. Если значение по умолчанию не может быть определено, предпочтительный ключ или весь предпочтительный файл манифеста могут быть проигнорированы.

Используя pfm_domain Ключ

Рекомендуемый подход для каждого предпочтительного файла манифеста для указания всего одного домена. Когда предпочтительный файл манифеста указывает один домен, pfm_domain явный ключ не должен быть указан для каждого предпочтительного ключа. Когда pfm_domain не указан для предпочтительного ключа, менеджер по Рабочей группе получает домен для предпочтительного ключа от pfm_domain введите наиболее удаленный словарь. Вот пример:

<key>pfm_format_version</key>

<real>1.0</real>

<key>pfm_version</key>

<real>1.0</real>

<key>pfm_domain</key>

<string>com.apple.myapp</string>

<key>pfm_subkeys</key>

<array>

    <dict>

        <key>pfm_name</key>

        <string>Preference One</string>

        // Additional information for “Preference One”

        <key>pfm_name</key>

        <string>Preference Two</key>

        // Additional information for “Preference Two”

    </dict>

</array>

В этом примере, домене для Preference One и Preference Two com.apple.myapp как указано pfm_domain введите outmost словарь.

Несмотря на то, что выполнение так не рекомендуется, возможно указать больше чем один домен в предпочтительном файле манифеста. Вот пример:

<key>pfm_format_version</key>

<real>1.0</real>

<key>pfm_version</key>

<real>1.0</real>

<key>pfm_subkeys</key>

<array>

    <dict>

        <key>pfm_name</key>

        <string>Preference One</string>

        // Additional information for “Preference One”

        <key>pfm_domain</key>

        <string>com.apple.myapp1</string>

        <key>pfm_name</key>

        <string>Preference Two</string>

        // Additional information for “Preference Two”

        <key>pfm_domain</key>

        <string>com,apple.myapp2</string>

    <dict>

</array>

Значения для pfm_targets Ключа

Значение pfm_targets ключ является массивом, состоящим из любой комбинации user, user-managed, и system-managed. Эти значения говорят клиенту MCX когда (прежде чем или после входа в систему) обрабатывать предпочтительные ключи для определенного домена приложения.

Значение pfm_targets ключевые работы в сочетании с настройками, установленными администратором, которые указывают, когда должно быть обработано предпочтение приложения:

• Всегда — Это - предпочтение приложения, которое установлено и не может быть изменено.

• Один раз — Это - предпочтение приложения, которое установлено, но может быть постоянно изменено.

• Часто — Это - предпочтение приложения, которое установлено и может быть временно изменено. То, когда пользователь регистрирует назад в предпочтении, установлено в его исходное значение.

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

Когда user значение pfm_targets ключ, любые установки приложения, установленные администратором в Один раз и Часто, обрабатывается сразу после аутентификации и прежде чем работают любые пользовательские приложения. Ключ может быть установлен в предпочтениях пользователя в ~/Library/Preferences/com.apple.myapp.plist.

Когда user-managed значение pfm_targets ключ, любые установки приложения, установленные администратором во Всегда, обрабатывается сразу после аутентификации и прежде чем работают любые пользовательские приложения. Ключ может быть установлен в управляемых предпочтениях пользователя в ~/Library/Managed Preferences/имя пользователя/com.apple.myapp.plist. где имя пользователя является кратким названием зарегистрированного пользователя.

Когда system-managed значение pfm_targets ключ, любые установки приложения, установленные системным администратором во Всегда, обрабатывается во время запуска и после каждого пользовательского выхода из системы. Например, предпочтение, управляющее, показать ли loginwindow со списком пользователей или с полем, в котором вводится имя пользователя, имеет к обработанному, прежде чем любой пользователь войдет в систему. Ключ будет установлен в файле списка свойств (.plist) в /Library/Managed Preferences/.

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

Определение предпочтительного ключа псевдонима типа

Предпочтительный ключ, чей pfm_type alias заставляет Предпочтительного Редактора Декларации менеджера по Рабочей группе позволять Вам указывать псевдоним к файлу или папке. Данные, соответствующие записи псевдонима, хранятся в предпочтительных данных как a data тип plist.

Вот демонстрационное определение для предпочтительного ключа чей pfm_type alias:

<key>pfm_name</key>

<string>backupVolume</string>

<key>pfm_type</key>

<string>alias</string>

<key>pfm_title</key>

<string>Backup Volume</string>

<key>pfm_description</key>

<string>Alias to the backup volume</string>

<key>pfm_targets</key>

<array>

    <string>user</string>

    <string>user-managed</string>

</array>

Определение предпочтительного ключа массива типа

Вот демонстрационное определение для предпочтительного ключа чей pfm_type array:

<key>pfm_name</key>

<string>OptionCheckboxStringsTemp</string>

<key>pfm_type</key>

<string>array</string>

<key>pfm_default</key>

<array>

    <string>antialias</string>

    <string>fullcolor</string>

</array>

<key>pfm_title</key>

<string>Checkbox Strings</string>

<key>pfm_description</key>

<string>One array element for each visible checkbox containing  the internal name of  that checkbox.</string>

<key>pfm_targets</key>

<array>

    <string>user</string>

    <string>user-managed</string>

</array>

<key>pfm_subkeys</key>

<array>

    <dict>

        <key>pfm_description</key>

        <string>Checkbox string values.</string>

        <key>pfm_name</key>

        <string>checkboxnames</string>

        <key>pfm_rangelist</string>

        <array>

            <string>antialias</string>

            <string>fullcolor</string>

            <string>invertcolor</string>

        </array>

        <key>pfm_repetition_max</key>

        <integer>3</integer>

        <key>pfm_repetition_min</key>

        <integer>0</integer>

        <key>pfm_title</key>

        <string>Checkbox name</string>

        <key>pfm_type</key>

        <string>string</string>

    </dict>

</array>

Определение предпочтительного ключа булевской переменной типа

Вот демонстрационное определение для предпочтительного ключа чей pfm_type boolean.

<key>pfm_name</key>

<string>reverseHilite</string>

<key>pfm_type</key>

<string>boolean</string>

<key>pfm_default</key>

<false/>

<key>pfm_title</key>

<string>Reverse Highlighting</string>

<key>pfm_description</key>

<string>Set to true for black on white highlighting.</string>

<key>pfm_targets</key>

<array>

    <string>user</string>

    <string>user-managed</string>

</array>

Определение предпочтительного ключа даты типа

Вот демонстрационное определение для предпочтительного ключа чей pfm_type date.

<key>pf_domain</key>

<string>com.apple.myapp</string>

<key>pfm_name</key>

<string>database creation time</string>

<key>pfm_type</key>

<string>date</string>

<key>pfm_title</key>

<string>Database Creation Date</string>

<key>pfm_description</key>

<string>Date when the main database was created.</string>

<key>pfm_targets</key>

<array>

    <string>user</string>

    <string>user-managed</string>

</array>

Определение предпочтительного ключа данных типа

Вот демонстрационное определение для предпочтительного ключа чей pfm_type data.

<key>pfm_name</key>

<string>preference data</string>

<key>pfm_type</key>

<string>data</string>

<key>pfm_title</key>

<string>Database Bit Flags</string>

<key>pfm_description</key>

<string>Database Bit Flags. 10 bytes long.</string>

<key>pfm_targets</key>

<array>

    <string>user</string>

    <string>user-managed</string>

</array>

Определение предпочтительного ключа словаря типа

Вот демонстрационное определение для предпочтительного ключа чей pfm_type dictionary.

<key>pfm_name</key>

<string>document objects</string>

<key>pfm_type</key>

<string>dictionary</string>

<key>pfm_title</key>

<string>Document Object Dictionary</string>

<key>pfm_description</key>

<string>Dictionary of document objects.</string>

<key>pfm_targets</key>

<array>

    <string>user</string>

    <string>user-managed</string>

</array>

<key>pfm_subkeys</key>

<array>

    <dict>

        <key>pfm_name</key>

        <string>Preference One</string>

        // Other keys describing this preference.

    </dict>

    <dict>

        <key>pfm_name</key>

        <string>Preference Two</string>

        // Other keys describing this preference.

    </dict>

</array>

Определение предпочтительного ключа целого числа типа

Вот демонстрационное определение для предпочтительного ключа чей pfm_type integer.

<key>pfm_name</key>

<string>zoom factor</string>

<key>pfm_type</key>

<string>integer</string>

<key>pfm_default</key>

<integer>100</integer>

<key>pfm_range_max</key>

<integer>1000</integer>

<key>pfm_range_min</key>

<integer>0</integer>

<key>pfm_title</key>

<string>Zoom Factor</string>

<key>pfm_description</key>

<string>Document zoom factor. Only multiples of 10 are valid.</string>

<key>pfm_targets</key>

<array>

    <string>user</string>

    <string>user-managed</string>

</array>

Определение предпочтительного ключа реального типа

Вот демонстрационное определение для предпочтительного ключа чей pfm_type real. В этом примере, pfm_range_max не указан, таким образом, менеджер по Рабочей группе использовал бы значение по умолчанию, + <бесконечность>. pfm_description ключ не указан, таким образом, предпочтительный ключ не имеет никакого описания.

<key>pfm_name</key>

<string>scaling</string>

<key>pfm_type</key>

<string>real</string>

<key>pfm_default</key>

<real>1.0</real>

<key>pfm_range_min</key>

<real>0.01</real>

<key>pfm_title</key>

<string>Scaling Factor</string>

<key>pfm_targets</key>

<array>

    <string>user</string>

    <string>user-managed</strings>

</array>

Определение предпочтительного ключа строки типа

Вот демонстрационное определение для предпочтительного ключа чей pfm_type string.

<key>pfm_name</key>

<string>input source</string>

<key>pfm_type</key>

<string>string</string>

<key>pfm_default</key>

<string>file</string>

<key>pfm_range_list</key>

<array>

    <string>file</string>

    <string>network</string>

</array>

<key>pfm_title</key>

<string>Input Source</string>

<key>pfm_description</key>

<string>Input can be taken from a file or the network.</string>

<key>pfm_targets</key>

<array>

    <string>user</string>

    <string>user-managed</string>

</array>

Определение предпочтительного ключа политики объединения типа

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

• это все компьютеры показывает «Калькулятор» в прикреплении

• та Рабочая группа «MyWorkGroup» показывает «DVD-плеер» в прикреплении

• тот пользователь «Джимми» показывает «TextEdit» в прикреплении

Когда «Джимми» (кто принадлежит рабочей группе «MyWorkGroup») входит в систему, что должно появиться в его прикреплении? Просто «TextEdit» или должен «Калькулятор», «DVD-плеер» и «TextEdit» быть в его прикреплении?

Ключи политики объединения устанавливают правила так, чтобы массив или ключи словаря, найденные в пользователе, группе или компьютерных записях списка, могли быть объединены в единый массив или словарь в получающемся предпочтительном файле.

Следующий пример указывает политику объединения для мозаик приложения в:

<key>pfm_description</key>

<string>Application tiles union policy keys for user domain</string>

<key>pfm_name</key>

<string>appTilesUPKUser</string>

<key>pfm_remove_duplicates</key>

<true/>

<key>pfm_targets</key>

<array>

    <string>user</string>

</array>

<key>pfm_title</key>

<string>Application Tiles Union Policy - User</string>

<key>pfm_type</key>

<string>union policy</string>

<key>pfm_upk_input_keys</key>

<array>

    <string>AppItems-Raw</string>

</array>

<key>pfm_upk_output_name</key>

<string>persistent-apps</string>

<key>pfm_upk_output_type</key>

<string>array</string>

Определение предпочтительного ключа типа URL

Предпочтительный ключ, чей pfm_type url заставляет Предпочтительного Редактора Декларации менеджера по Рабочей группе позволять Вам выбирать файл или папку. Если Вы выбираете a .webloc файл, URL, содержавший в .webloc файл извлекается и хранится как строковый тип в предпочтительных данных. Если Вы выбираете файл, который не является a .webloc файл, a file://- основанный URL создается к выбранному файлу, и этот URL сохранен как строка в предпочтительных данных.

Вот демонстрационное определение для предпочтительного ключа чей pfm_type url.

<key>pfm_name</key>

<string>help source</string>

<key>pfm_type</key>

<string>url</string>

<key>pfm_default</key>

<string>http://help.apple.com</string>

<key>pfm_title</key>

<string>Web Help URL</string>

<key>pfm_description</key>

<string>Web-based help url.</string>

<key>pfm_targets</key>

<array>

    <string>user</string>

    <string>user-managed</string>

</array>