Ключевая сводка

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

CFAppleHelpAnchor

CFAppleHelpAnchor (String - OS X), идентифицирует имя начального файла справки HTML пакета, минус .html или .htm расширение. Если справка не локализуется, непосредственно под, этот файл должен быть расположен в локализованных каталогах ресурса пакета или Resources каталог.

CFBundleAllowMixedLocalizations

CFBundleAllowMixedLocalizations (Boolean - iOS, OS X), указывает, поддерживает ли пакет извлечение локализованных строк от платформ. Этот ключ используется прежде всего инструментами Foundation, соединяющимися с другими системными платформами и хотящими получить локализованные ресурсы от тех платформ.

CFBundleDevelopmentRegion

CFBundleDevelopmentRegion (String - iOS, OS X), указывает язык по умолчанию и область для пакета, как язык ID. Например, английский язык для Соединенного Королевства имеет язык ID en-UK. Система использует это значение, если это не может определить местоположение ресурса для предпочтительного языка пользователя.

Для получения дополнительной информации посмотрите Язык IDs в Руководстве по Интернационализации и Локализации. Для получения дополнительной информации о том, как пакет находит локализованные ресурсы, посмотрите Образец Поиска Пакета в Руководстве по программированию Пакета.

CFBundleDisplayName

CFBundleDisplayName (String - iOS, OS X), указывает имя дисплея пакета. Если Вы поддерживаете локализованные имена для своего пакета, включаете этот ключ и Ваш информационный файл списка свойств и в InfoPlist.strings файлы Ваших подкаталогов языка. При локализации этого ключа необходимо также включать локализованную версию CFBundleName ключ.

Если Вы не намереваетесь локализовать свой пакет, не включайте этот ключ в Вашем Info.plist файл. Включение этого ключа не влияет на дисплей имени пакета, но действительно подвергается потере производительности для поиска локализованных версий этого ключа.

Прежде, чем вывести на экран локализованное имя для Вашего пакета, Средство поиска сравнивает значение этого ключа против подлинного имени Вашего пакета в файловой системе. Если два имени соответствуют, доходы Средства поиска для отображения локализованного имени от надлежащего InfoPlist.strings файл Вашего пакета. Если имена не соответствуют, Средство поиска выводит на экран имя файловой системы.

Для получения дополнительной информации об именах дисплея в OS X, см. Руководство по программированию Файловой системы.

CFBundleDocumentTypes

CFBundleDocumentTypes (Array - iOS, OS X), содержит массив словарей, связывающих одни или более типов документов с Вашим приложением. Каждый словарь вызывают словарем определения типа и содержит ключи, используемые для определения типа документа. Таблица 2 перечисляет ключи, поддерживающиеся в этих словарях.

Путем Вы указываете файлы значков в OS X, и iOS отличается из-за поддерживаемых форматов файлов на каждой платформе. В iOS каждый файл ресурсов значка обычно является файлом PNG, содержащим только одно изображение. Поэтому необходимо указать различные файлы образа для различных размеров значков. Однако при указании значков в OS X, Вы используете файл значка (с расширением .icns), который способен к хранению значка в нескольких различных разрешениях.

Этот ключ поддерживается в iOS 3.2 и позже и все версии OS X. Для получения дальнейшей информации о UTIs, см. Универсальный Обзор Идентификаторов типов.

CFBundleExecutable

CFBundleExecutable (String - iOS, OS X), идентифицирует имя основного исполняемого файла пакета. Для приложения это - исполнимая программа приложения. Для загружаемого пакета это - двоичный файл, который будет загружен динамично пакетом. Для платформы это - совместно используемая библиотека для платформы. XCode автоматически добавляет этот ключ к информационному файлу списка свойств надлежащих проектов.

Для платформ значение этого ключа требуется, чтобы совпасть с именем платформы, минус .framework расширение. Если ключи не являются тем же, целевая система может подвергнуться некоторым потерям производительности запуска. Значение не должно включать расширение на имени.

CFBundleHelpBookFolder

CFBundleHelpBookFolder (String - OS X), идентифицирует папку, содержащую файлы справки пакета. Справка обычно локализуется на определенный язык, таким образом, папка, указанная этим ключом, представляет имя папки в .lproj каталог для выбранного языка.

CFBundleHelpBookName

CFBundleHelpBookName (String - OS X), идентифицирует основную страницу справки для Вашего приложения. Этот ключ идентифицирует имя страницы справки, которая может не соответствовать имени файла HTML. Имя страницы справки указано в CONTENT атрибут файла справки META тег.

CFBundleIconFile

CFBundleIconFile (String - iOS, OS X), идентифицирует файл, содержащий значок для пакета. Имя файла, которое Вы указываете, не должно включать расширение, несмотря на то, что это может. Система ищет файл значка в основном каталоге ресурсов пакета.

Если Ваше приложение Mac использует пользовательский значок, необходимо указать это свойство. Если Вы не указываете это свойство, система (и другие приложения) выводят на экран Ваш пакет со значком по умолчанию.

CFBundleIconFiles

CFBundleIconFiles (Array - iOS), содержит массив строк, идентифицирующих файлы значков для пакета. (Рекомендуется всегда создать файлы значков с помощью формата PNG.) При указании имен файлов значка, лучше опускать любые расширения файла. Исключение расширения файла позволяет системе автоматически обнаружить с высокой разрешающей способностью (@2x) версии Ваших файлов образа с помощью имени файла образа стандартного разрешения. При включении расширений файла необходимо указать все файлы образа (включая варианты с высокой разрешающей способностью) явно. Система ищет файлы значков в основном каталоге ресурсов пакета. Если настоящее, значения в этом ключе имеют приоритет по значению в ключе CFBundleIconFile.

Этот ключ поддерживается в iOS 3.2 и позже только, и приложение, возможно, по-другому измерило значки для поддержки различных типов устройств и различных разрешений экранов. Другими словами, значок приложения обычно - 57 x 57 пикселей на iPhone или iPod touch, но составляет 72 x 72 пикселя на iPad. Значки в других размерах могут также быть включены. Порядок элементов в этом массиве не имеет значения. Система автоматически выбирает наиболее соответственно размерный значок на основе использования и типа базового устройства.

Для получения информации о том, как создать значки для Ваших приложений, включая информацию о размере для каждого, см. Инструкции по Интерфейсу пользователя iOS.

CFBundleIcons

CFBundleIcons (Dictionary - iOS), содержит информацию обо всех значках, используемых приложением. Этот ключ позволяет Вам значкам группы на основе их намеченного использования, и укажите многократные файлы значков вместе с определенными ключами для изменения появления тех значков. Этот словарь может содержать следующие ключи:

• CFBundlePrimaryIcon — Этот ключ идентифицирует значки для домашнего экрана и приложения Настроек среди других. Значение для этого ключа является словарем, содержание которого описано в Содержании Словаря CFBundlePrimaryIcon.

• UINewsstandIcon — Этот ключ идентифицирует значки по умолчанию для использования для приложений, представленных от Киоска. Значение для этого ключа является словарем, содержание которого описано в Содержании Словаря UINewsstandIcon.

CFBundleIcons ключ поддерживается в iOS 5.0 и позже. Можно объединить этот ключ с ключами CFBundleIconFiles и CFBundleIconFile, но в iOS 5.0 и позже, имеет приоритет этот ключ.

CFBundleIdentifier

CFBundleIdentifier (String - iOS, OS X), однозначно определяет пакет. Каждое отличное приложение или пакет в системе должны иметь уникальный пакет ID. Система использует эту строку для идентификации приложения во многих отношениях. Например, предпочтительная система использует эту строку для идентификации приложения, для которого применяется данное предпочтение; Launch Services использует идентификатор пакета для определения местоположения приложения, способного к открытию определенного файла, с помощью первого приложения, которое это находит с данным идентификатором; в iOS идентификатор пакета используется в проверке подписи приложения.

Строка идентификатора пакета должна быть универсальным идентификатором типа (UTI), содержащим только алфавитно-цифровой (A-Z,a-z,0-9), дефис (-), и период (.) символы. Строка должна также быть в формате обратного DNS. Например, если домен Вашей компании Ajax.com и Вы создаете приложение под названием Привет, Вы могли присвоить строку com.Ajax.Hello как идентификатор пакета Вашего приложения.

CFBundleInfoDictionaryVersion

CFBundleInfoDictionaryVersion (String - iOS, OS X), идентифицирует текущую версию структуры списка свойств. Этот ключ существует для поддержки будущего управления версиями информационного формата файла списка свойств. XCode генерирует этот ключ автоматически, когда Вы создаете пакет, и Вы не должны изменять его вручную. Значение для этого ключа в настоящее время 6.0.

CFBundleLocalizations

CFBundleLocalizations (Array - iOS, OS X), идентифицирует локализации, обработанные вручную Вашим приложением. Если Ваша исполнимая программа является несвязанной или не использует существующий механизм локализации пакета, можно включать этот ключ для указания локализаций, которые действительно обрабатывает приложение.

Каждая запись в массиве этого свойства является строкой, идентифицирующей имя языка или указатель языка ISO поддерживаемой локализации. См. “Язык и Обозначения Локали” в Руководстве по Интернационализации и Локализации в Документации Интернационализации для получения информации о том, как указать указатели языка.

CFBundleName

CFBundleName (String - iOS, OS X), идентифицирует краткое название пакета. Это имя должно быть меньше чем 16 символами долго и подойти для отображения в строке меню и окне Info приложения. Можно включать этот ключ InfoPlist.strings файл надлежащего .lproj подкаталог для обеспечения локализованных значений для него. При локализации этого ключа необходимо также включать ключ CFBundleDisplayName.

CFBundlePackageType

CFBundlePackageType (String - iOS, OS X), идентифицирует тип пакета и походит на Mac OS 9 кодов типа файла. Значение для этого ключа состоит из четырех алфавитных кодов. Код типа для приложений APPL; для платформ это FMWK; для загружаемых пакетов это BNDL. Для загружаемых пакетов можно также выбрать код типа, который является более определенным, чем BNDL если Вы хотите.

Все пакеты должны обеспечить этот ключ. Однако, если этот ключ не указан, подпрограммы пакета используют расширение пакета для определения типа, отступая к BNDL введите, если не распознано расширение пакета.

CFBundleShortVersionString

CFBundleShortVersionString (String - iOS, OS X), указывает номер релизной версии пакета, идентифицирующего выпущенную итерацию приложения. Номер релизной версии является строкой, состоявшей из трех разделенных от периода целых чисел. Первое целое число представляет главные версии приложению, такие как версии, реализующие новые опции или существенные изменения. Второе целое число обозначает версии, реализующие менее яркие опции. Третье целое число представляет корректировочные версии.

Значение для этого ключа отличается от значения для CFBundleVersion, идентифицирующего итерацию (выпущенный или невыпущенный) приложения. Этот ключ может быть локализован включением его в Вашем InfoPlist.strings файлы.

CFBundleSignature

CFBundleSignature (String - iOS, OS X), идентифицирует создателя пакета и походит на Mac OS 9 кодов создателя файла. Значение для этого ключа является строкой, содержащей четыре алфавитных кода, которые являются определенными для пакета. Например, подпись для приложения TextEdit ttxt.

CFBundleSpokenName

CFBundleSpokenName (String - iOS, OS X), содержит подходящую замену для имени приложения при выполнении операций синтеза речи по тексту. Включайте этот ключ в Вашем комплекте приложений, когда написание Вашего приложения могло бы быть неправильно произнесено речевой системой. Например, если имя Вашего приложения является «MyApp123», Вы могли бы установить значение этого ключа к “Моему приложению один два три”.

Этот ключ поддерживается в iOS 8 и позже и в OS X v10.10 и позже.

CFBundleURLTypes

CFBundleURLTypes (Array - iOS, OS X), содержит массив словарей, каждый из которых описывает схемы URL (http, ftp, и т.д.) поддерживаемый приложением. Цель этого ключа подобна тому из CFBundleDocumentTypes, но это описывает схемы URL вместо типов документов. Каждая словарная статья соответствует единственной схеме URL. Таблица 6 перечисляет ключи для использования в каждой словарной статье.

CFBundleVersion

CFBundleVersion (String - iOS, OS X), указывает число версии сборки пакета, идентифицирующего итерацию (выпущенный или невыпущенный) пакета. Число версии сборки должно быть строкой, состоявшей из трех неотрицательных, разделенных от периода целых чисел с первым целым числом, являющимся больше, чем нуль. Строка должна только содержать числовой (0-9) и период (.) символы. Начальные нули являются усеченными от каждого целого числа и будут проигнорированы (т.е. 1.02.3 эквивалентно 1.2.3). Этот ключ не локализуем.

CFPlugInDynamicRegistration

CFPlugInDynamicRegistration (String - OS X), указывает ли как нагрузки хоста этот плагин. Если значение YES, узел пытается загрузить этот плагин с помощью своей динамической регистрационной функции. Если значение NO, узел использует статическую информацию о регистрации, включенную в CFPlugInFactories и ключи CFPlugInTypes.

Для получения информации о регистрирующихся плагинах см. “Сменную Регистрацию” в Темах Программирования Плагина.

CFPlugInDynamicRegisterFunction

CFPlugInDynamicRegisterFunction (String - OS X), идентифицирует функцию для использования, динамично регистрируя плагин. Укажите этот ключ, если Вы хотите указать одну из своих собственных функций вместо реализации значение по умолчанию CFPlugInDynamicRegister функция.

Для получения информации о регистрирующихся плагинах см. “Сменную Регистрацию” в Темах Программирования Плагина.

CFPlugInFactories

CFPlugInFactories (Dictionary - OS X), используется для статической сменной регистрации. Это содержит словарь, идентифицирующий интерфейсы, поддерживаемые плагином. Каждый ключ в словаре является универсально уникальным идентификатором (UUID) представление поддерживаемого интерфейса. Значение для ключа является строкой с именем сменной функции фабрики для вызова.

Для получения информации о регистрирующихся плагинах см. “Сменную Регистрацию” в Темах Программирования Плагина.

CFPlugInTypes

CFPlugInTypes (Dictionary - OS X), используется для статической сменной регистрации. Это содержит словарь, идентифицирующий одну или более групп интерфейсов, поддерживаемых плагином. Каждый ключ в словаре является универсально уникальным идентификатором (UUID) представление группы интерфейсов. Значение для ключа является массивом строк, каждая из которых содержит UUID для определенного интерфейса в группе. UUIDs в массиве соответствует записям в словаре CFPlugInFactories.

Для получения информации о регистрирующихся плагинах см. “Сменную Регистрацию” в Темах Программирования Плагина.

CFPlugInUnloadFunction

CFPlugInUnloadFunction (String - OS X), указывает имя функции для вызова, когда пора разгрузить сменный код из памяти. Эта функция дает плагину возможность очистить любые структуры данных, которые это выделило.

Для получения информации о регистрирующихся плагинах см. “Сменную Регистрацию” в Темах Программирования Плагина.