Базовые ключи основы

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

Базовые ключи Foundation используют префикс CF отличать их от других ключей. Для получения дополнительной информации о Базовой Основе, посмотрите Базовую Ссылку Платформы Основы.

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

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

Табличная 1  Сводка ключей Core Foundation

Ключ

Имя XCode

Сводка

Платформы

CFAppleHelpAnchor

«Файл справки»

Начальный файл справки HTML пакета. Посмотрите CFAppleHelpAnchor для подробных данных.

OS X

CFBundleAllowMixedLocalizations

“Локализованные ресурсы могут быть смешаны”

Используемый инструментами Foundation для получения локализованных ресурсов от платформ. Посмотрите CFBundleAllowMixedLocalizations для подробных данных.

iOS, OS X

CFBundleDevelopmentRegion

“Собственная область разработки локализации”

(Рекомендуемый) язык по умолчанию и область для пакета, как язык ID. Посмотрите CFBundleDevelopmentRegion для подробных данных.

iOS, OS X

CFBundleDisplayName

“Пакет выводит на экран имя”

(Рекомендуемый, Локализуемый) подлинное имя пакета. Посмотрите CFBundleDisplayName для подробных данных.

iOS, OS X

CFBundleDocumentTypes

«Типы документов»

Массив словарей, описывающих типы документов, поддерживается пакетом. Посмотрите CFBundleDocumentTypes для подробных данных.

iOS, OS X

CFBundleExecutable

«Исполняемый файл»

(Рекомендуемое) Имя исполняемого файла пакета. Посмотрите CFBundleExecutable для подробных данных.

iOS, OS X

CFBundleHelpBookFolder

“Имя каталога Книги справки”

Имя папки, содержащей файлы справки пакета. Посмотрите CFBundleHelpBookFolder для подробных данных.

OS X

CFBundleHelpBookName

“Идентификатор Книги справки”

Имя файла справки для отображения, когда Средство просмотра Справки запускается для пакета. Посмотрите CFBundleHelpBookName для подробных данных.

OS X

CFBundleIconFile

«Файл значка»

Устаревший способ указать значок приложения. Используйте ключи CFBundleIcons или CFBundleIconFiles вместо этого. Посмотрите CFBundleIconFile для подробных данных.

iOS, OS X

CFBundleIconFiles

«Файлы значков»

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

См. также CFBundleIcons как альтернативу этому ключу.

iOS 3.2 и позже

CFBundleIcons

Ни один

Имена файлов файлов образа значка пакета. Посмотрите CFBundleIconFiles для подробных данных.

iOS 5.0 и позже

CFBundleIdentifier

“Идентификатор пакета”

(Рекомендуемый) строку идентификатора, указывающую тип приложения пакета. Строка должна быть в обратном формате DNS с помощью только Романский алфавит в верхнем и нижнем регистре (A–Z, a–z), точка (“”.), и дефис (“-”). Посмотрите CFBundleIdentifier для подробных данных.

iOS, OS X

CFBundleInfoDictionaryVersion

“Версия InfoDictionary”

(Рекомендуемая) Информация о версии для Info.plist формат. Посмотрите CFBundleInfoDictionaryVersion для подробных данных.

iOS, OS X

CFBundleLocalizations

«Локализации»

Содержит информацию о локализации для приложения, обрабатывающего его собственные локализованные ресурсы. Посмотрите CFBundleLocalizations для подробных данных.

iOS, OS X

CFBundleName

“Имя пакета”

(Рекомендуемый, Локализуемый) короткое имя дисплея пакета. Посмотрите CFBundleName для подробных данных.

iOS, OS X

CFBundlePackageType

“Свяжите код Типа OS”

Четыре алфавитных кода, идентифицирующие тип пакета. Посмотрите CFBundlePackageType для подробных данных.

iOS, OS X

CFBundleShortVersionString

“Строка версий комплекта, короткая”

(Локализуемый) строка номера релизной версии для пакета. Посмотрите CFBundleShortVersionString для подробных данных.

iOS, OS X

CFBundleSignature

“Свяжите создателя код Типа OS”

Четыре алфавитных кода, идентифицирующие создателя пакета. Посмотрите CFBundleSignature для подробных данных.

iOS, OS X

CFBundleSpokenName

«Доступность связывает имя”

Разговорное имя приложения. Посмотрите CFBundleSpokenName для подробных данных.

iOS, OS X

CFBundleURLTypes

“Типы URL”

Массив словарей, описывающих схемы URL, поддерживается пакетом. Посмотрите CFBundleURLTypes для подробных данных.

iOS, OS X

CFBundleVersion

«Версия комплекта»

(Рекомендуемый) строку номера версии сборки для пакета. Посмотрите CFBundleVersion для подробных данных.

iOS, OS X

CFPlugInDynamicRegistration

“Плагин должен быть зарегистрирован динамично”

Если ДА, зарегистрируйте плагин динамично; иначе, зарегистрируйте его статически. Посмотрите CFPlugInDynamicRegistration для подробных данных.

OS X

CFPlugInDynamicRegistrationFunction

Сменное динамическое регистрационное имя функции”

Имя пользовательской, динамической регистрационной функции. Посмотрите CFPlugInDynamicRegisterFunction для подробных данных.

OS X

CFPlugInFactories

“Сменные интерфейсы фабрики”

Для статической регистрации этот словарь содержит список UUIDs с соответствием имен функций. Посмотрите CFPlugInFactories для подробных данных.

OS X

CFPlugInTypes

“Сменные типы”

Для статической регистрации, списка UUIDs CFPlugInTypes для подробных данных.

OS X

CFPlugInUnloadFunction

“Плагин разгружает имя функции”

Имя пользовательской функции для вызова, когда пора разгрузить сменный код из памяти. Посмотрите CFPlugInUnloadFunction для подробных данных.

OS X

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 перечисляет ключи, поддерживающиеся в этих словарях.

Табличные 2  Ключи для словарей определения типа

Ключ

Имя XCode

Ввести

Описание

Платформы

CFBundleTypeExtensions

“Расширения документа”

Array

Этот ключ содержит массив строк. Каждая строка содержит расширение файла (минус ведущий период) для отображения на этот тип документа. Для открытия документов с любым расширением укажите расширение с единственной звездочкой “*”. (В OS X v10.4, этот ключ проигнорирован если LSItemContentTypes ключ присутствует.) Осуждаемый в OS X v10.5.

OS X

CFBundleTypeIconFile

“Имя файла значка”

String

Этот ключ содержит строку с именем файла значка (.icns) связаться с этим типом документа OS X. Для получения дополнительной информации об указании значков документа, посмотрите Значки документа.

OS X

CFBundleTypeIconFiles

Ни один

Array

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

iOS

CFBundleTypeMIMETypes

“Документ типы MIME”

Array

Содержит массив строк. Каждая строка содержит имя типа MIME, которое Вы хотите отобразить на этот тип документа. (В OS X v10.4, этот ключ проигнорирован если LSItemContentTypes ключ присутствует.) Осуждаемый в OS X v10.5.

OS X

CFBundleTypeName

“Имя типа документа”

String

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

iOS, OS X

CFBundleTypeOSTypes

“Документ типы OS”

Array

Этот ключ содержит массив строк. Каждая строка содержит код типа с четырьмя буквами, отображающийся на этот тип документа. Для открытия документов любого типа включайте четыре символа звездочки (****) как код типа. Эти коды эквивалентны устаревшим кодам типа, используемым Mac OS 9. (В OS X v10.4, этот ключ проигнорирован если LSItemContentTypes ключ присутствует.) Осуждаемый в OS X v10.5.

OS X

CFBundleTypeRole

«Роль»

String

Этот ключ указывает роль приложения относительно типа. Значение может быть Editor, Viewer, Shell, или None. Этот ключ требуется.

OS X

LSItemContentTypes

“Тип контента документа UTIs”

Array

Этот ключ содержит массив строк. Каждая строка содержит UTI определение поддерживаемого типа файла. Строка UTI должна быть разъяснена явно, в противоположность использованию одной из констант, определенных Launch Services. Например, для поддержки файлов PNG Вы включали бы строку “public.png“в массиве. При использовании этого ключа также добавьте NSExportableTypes ключ с надлежащими записями. В OS X v10.5 и позже, этот ключ (когда существующий) имеет приоритет по этим ключам идентификатора типа: CFBundleTypeExtensions, CFBundleTypeMIMETypes, CFBundleTypeOSTypes.

iOS, OS X

LSHandlerRank

“Разряд обработчика”

String

Определяет, как Launch Services оценивает это приложение среди приложений, объявляющих себя редакторы или средства просмотра файлов этого типа. Возможные значения: Owner (это приложение является создателем файлов этого типа), Alternate (это приложение является вторичным средством просмотра файлов этого типа), None (это приложение никогда не должно использоваться для открытия файлов этого типа, но это принимает отбрасывания файлов этого типа), Default (значение по умолчанию; это приложение не принимает отбрасывания файлов этого типа). Launch Services использует значение LSHandlerRank определить приложение для использования для открытия файлов этого типа. Порядок очередности: Owner, Alternate, None. Этот ключ доступен в OS X v10.5 и позже.

iOS, OS X

LSTypeIsPackage

“Документ является пакетом или пакетом”

Boolean

Указывает, распределяется ли документ как пакет. Если установлено в истину, каталог пакета обрабатывается как файл. (В OS X v10.4 и позже, этот ключ проигнорирован если LSItemContentTypes ключ присутствует.)

OS X

NSDocumentClass

“Какао класс NSDocument”

String

Этот ключ указывает имя NSDocument подкласс раньше инстанцировал экземпляров этого документа. Этот ключ используется приложениями Какао только.

OS X

NSUbiquitousDocumentUserActivityType

Ни один

String

Этот ключ указывает тип действия NSUserActivity объект связался с этим документом.

iOS, OS X

NSExportableAs

“Экспортный как имена типа документа”

Array

Этот ключ указывает массив строк. Каждая строка содержит имя другого типа документа, т.е. значения a CFBundleTypeName свойство. Это значение представляет другой формат данных, в который этот документ может экспортировать свое содержание. Этот ключ используется приложениями Какао только. Осуждаемый в OS X v10.5.

OS X

NSExportableTypes

Ни один

Array

Этот ключ указывает, что массив представляет в виде строки. Каждая строка должна содержать UTI определение поддерживаемого типа файла, в который этот документ может экспортировать свое содержание. Каждая строка UTI должна быть разъяснена явно, в противоположность использованию одной из констант, определенных Launch Services. Например, для поддержки файлов PNG Вы включали бы строку “public.png“в массиве. Этот ключ используется приложениями Какао только. Доступный в OS X v10.5 и позже.

OS X

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

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

Роли документа

Приложение может взять одну из следующих ролей для любого данного типа документа:

  • Редактор. Приложение может считать, управлять и сохранить тип.

  • Средство просмотра. Приложение может считать и представить данные того типа.

  • Shell. Приложение предоставляет услуги среды выполнения для других процессов — например, средство просмотра апплета Java. Имя документа является именем размещенного процесса (вместо имени приложения), и новый процесс создается для каждого открытого документа.

  • Ни один. Приложение не понимает данные, но просто объявляет информацию о типе (например, Средство поиска, объявляя значок для шрифтов).

Роль, которую Вы выбираете, применяется ко всем конкретным форматам, связанным с типом Буфера обмена или документом. Например, приложение Safari связывает себя как средство просмотра для документов с «.html», «.htm», “shtml или «jhtml» расширения файла. Каждое из этих расширений представляет конкретный тип документа, попадающего в полную категорию документов HTML. Этот тот же документ может также поддерживать типы MIME и устаревшие 4-байтовые типы OS.

Значки документа

В iOS, CFBundleTypeIconFiles ключ содержит массив строк с именами файлов образа для использования для значка документа. Таблица 3 перечисляет размеры значков, которые можно включать для каждого типа устройства. Можно назвать файлы образа, однако, Вы хотите только имена файлов в Вашем Info.plist файл должен соответствовать имена файлов ресурса изображения точно. (Для iPhone и iPod touch, применимая область Вашего значка фактически намного меньше.) Для получения дополнительной информации о том, как создать эти значки, см. Инструкции по Интерфейсу пользователя iOS.

Табличные 3  размеры Значка документа для iOS

Устройство

Размеры

iPad

64 x 64 пикселя

320 x 320 пикселей

iPhone и iPod touch

22 x 29 пикселей

44 x 58 пикселей (высокое разрешение)

В OS X, CFBundleTypeIconFile ключ содержит имя файла ресурсов значка со значком документа. Файл ресурсов значка содержит повторные изображения, каждый представляющий тот же значок документа в различных разрешениях. При исключении расширения файла система ищет файл с расширением .icns. Можно создать файлы ресурсов значка с помощью приложения Композитора Значка, идущего с Инструментами XCode.

Рекомендуемые ключи

Запись для каждого типа документа должна содержать следующие ключи:

  • CFBundleTypeIconFile

  • CFBundleTypeName

  • CFBundleTypeRole

В дополнение к этим ключам это должно содержать по крайней мере один из следующих ключей:

  • LSItemContentTypes

  • CFBundleTypeExtensions

  • CFBundleTypeMIMETypes

  • CFBundleTypeOSTypes

Если Вы не указываете по крайней мере один из этих ключей, никакие типы документов не связываются со спецификатором имени типа. Можно использовать все три ключа при привязке типа документа, если Вы, так выберите. В OS X v10.4 и позже, если Вы указываете LSItemContentTypes ключ, другие ключи проигнорированы. Можно продолжать включать другие ключи для совместимости с более старыми версиями системы, как бы то ни было.

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), содержит информацию обо всех значках, используемых приложением. Этот ключ позволяет Вам значкам группы на основе их намеченного использования, и укажите многократные файлы значков вместе с определенными ключами для изменения появления тех значков. Этот словарь может содержать следующие ключи:

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

Содержание словаря CFBundlePrimaryIcon

Значение для CFBundlePrimaryIcon ключ является словарем, идентифицирующим значки, связанные с комплектом приложений. Значки в этом словаре используются для представления приложения на домашнем экране устройства и в приложении Настроек. Таблица 4 перечисляет ключи, которые можно включать в этот словарь и их значения.

Табличные 4  ключи для CFBundlePrimaryIcon словарь

Ключ

Значение

Описание

CFBundleIconFiles

Массив строк

(Требуемый) Каждая строка в массиве содержит имя файла значка. Можно включать многократные значки различных размеров для поддержки iPhone, iPad и универсальных приложений.

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

UIPrerenderedIcon

Булевская переменная

Этот ключ указывает, включают ли файлы значков уже эффект сияния. Если Ваши значки уже включают этот эффект, включают ключ и устанавливают его значение в YES препятствовать тому, чтобы система добавила тот же эффект снова. Если Вы не включаете этот ключ или устанавливаете его значение в NO, система применяет эффект сияния к файлам значков, перечисленным в CFBundleIconFiles ключ в этом словаре.

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

Содержание словаря UINewsstandIcon

Значение для UINewsstandIcon ключ является словарем, идентифицирующим значки по умолчанию и параметры стиля для использования для приложений, выведенных на экран в Киоске. Таблица 5 перечисляет ключи, которые можно включать в этот словарь и их значения.

Табличные 5  ключи для UINewsstandIcon словарь

Ключ

Значение

Описание

CFBundleIconFiles

Массив строк

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

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

UINewsstandBindingType

Строка

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

  • UINewsstandBindingTypeMagazine

  • UINewsstandBindingTypeNewspaper

UINewsstandBindingEdge

Строка

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

  • UINewsstandBindingEdgeLeft

  • UINewsstandBindingEdgeRight

  • UINewsstandBindingEdgeBottom

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

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 перечисляет ключи для использования в каждой словарной статье.

Табличные 6  Ключи для словарей CFBundleURLTypes

Ключ

Имя XCode

Ввести

Описание

Платформы

CFBundleTypeRole

“Роль документа”

String

Этот ключ указывает роль приложения относительно типа URL. Значение может быть Editor, Viewer, Shell, или None. Этот ключ требуется.

iOS, OS X

CFBundleURLIconFile

“Имя файла значка документа”

String

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

iOS, OS X

CFBundleURLName

“Идентификатор URL”

String

Этот ключ содержит абстрактное имя для этого типа URL. Это - основной способ относиться к определенному типу. Для обеспечения уникальности рекомендуется использовать идентификатор стиля пакета Java. Это имя также используется в качестве ключа InfoPlist.strings файл для обеспечения человекочитаемой версии имени типа.

iOS, OS X

CFBundleURLSchemes

“Схемы URL”

Array

Этот ключ содержит массив строк, каждая из которых идентифицирует схему URL, обработанную этим типом. Например, указывая схему URL feed делает другие приложения знающими, что это приложение способно к просмотру содержания RSS. Типы схем URL включают http, ftp, mailto, и т.д.

iOS, OS X

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), указывает имя функции для вызова, когда пора разгрузить сменный код из памяти. Эта функция дает плагину возможность очистить любые структуры данных, которые это выделило.

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