Ключи какао

Какао и Касание Какао являются средами, используемыми для определения базируемых приложений Objective C, работающих в OS X и iOS соответственно. Ключи, связанные со средами Какао, предоставляют поддержку для Интерфейсных файлов пера Разработчика и предоставляют поддержку для других бывших обращенным к пользователю функций, продаваемых Вашим пакетом.

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

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

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

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

Ключ

Имя XCode

Сводка

Платформы

GKGameCenterBadgingDisabled

Ни один

Указывает, под маркой ли Ваше приложение. Посмотрите GKGameCenterBadgingDisabled для подробных данных.

iOS 7.0 и позже

GKShowChallengeBanners

Ни один

Указывает, показаны ли баннеры в приложении. Посмотрите подробные данные GKShowChallengeBannersfor.

iOS 7.0 и позже

NSAppleScriptEnabled

«Scriptable»

Указывает, включают ли AppleScript. Посмотрите NSAppleScriptEnabled для подробных данных.

OS X

NSBluetoothPeripheralUsageDescription

“Конфиденциальность - периферийное описание использования Bluetooth”

Указывает причину использования Bluetooth. Посмотрите NSBluetoothPeripheralUsageDescription для подробных данных.

iOS 6.0 и позже

NSCalendarsUsageDescription

“Конфиденциальность - календарное описание использования”

Указывает причину доступа к календарям пользователя. Посмотрите NSCalendarsUsageDescription для подробных данных.

iOS 6.0 и позже

NSCameraUsageDescription

“Конфиденциальность - описание использования камеры”

Указывает причину доступа к камере устройства. Посмотрите NSLocationUsageDescription для подробных данных.

iOS 7.0 и позже

NSContactsUsageDescription

“Конфиденциальность - связывается с описанием использования”

Указывает причину доступа к контактам пользователя. Посмотрите NSContactsUsageDescription для подробных данных.

iOS 6.0 и позже, OS X v10.8 и позже

NSDockTilePlugIn

” Путь Плагина Мозаики прикрепления”

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

OS X

NSHumanReadableCopyright

“(Человекочитаемое) авторское право”

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

OS X

NSJavaNeeded

“JAVA-приложение какао”

Указывает, требует ли программа рабочего Java VM. Посмотрите NSJavaNeeded для подробных данных.

OS X

NSJavaPath

“Пути к классам Java”

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

OS X

NSJavaRoot

“Корневой каталог Java”

Корневой каталог, содержащий классы Java. Посмотрите NSJavaRoot для подробных данных.

OS X

NSLocationAlwaysUsageDescription

Ни один

Указывает причину доступа к информации о расположении пользователя. Посмотрите NSLocationAlwaysUsageDescription для подробных данных.

iOS 8.0 и позже, OS X v10.10 и позже

NSLocationUsageDescription

“Конфиденциальность - описание использования расположения”

Указывает причину доступа к информации о расположении пользователя. Посмотрите NSLocationUsageDescription для подробных данных.

iOS 6.0 и позже, OS X v10.9 и позже

NSLocationWhenInUseUsageDescription

Ни один

Указывает причину доступа к информации о расположении пользователя. Посмотрите NSLocationWhenInUseUsageDescription для подробных данных.

iOS 8.0 и позже, OS X v10.10 и позже

NSMainNibFile

“Основное базовое имя файла пера”

Имя основного файла пера приложения. Посмотрите NSMainNibFile для подробных данных.

iOS, OS X

NSMicrophoneUsageDescription

“Конфиденциальность - описание использования микрофона”

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

iOS 7.0 и позже

NSMotionUsageDescription

“Конфиденциальность - описание использования движения”

Указывает причину доступа к акселерометру устройства. Посмотрите NSMotionUsageDescription для подробных данных.

iOS 7.0 и позже

NSPersistentStoreTypeKey

“Базовые Данные персистентный тип хранилища”

Тип Базовых Данных персистентное хранилище связался с персистентным типом документа. Посмотрите NSPersistentStoreTypeKey для подробных данных.

OS X

NSPhotoLibraryUsageDescription

“Конфиденциальность - фото описание использования библиотеки”

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

iOS 6.0 и позже

NSPrefPaneIconFile

“Предпочтительный файл значка Области”

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

OS X

NSPrefPaneIconLabel

“Метка значка Preference Pane”

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

OS X

NSPrincipalClass

“Основной класс”

Имя основного класса пакета. Посмотрите NSPrincipalClass для подробных данных.

OS X

NSRemindersUsageDescription

“Конфиденциальность - описание использования напоминаний”

Указывает причину доступа к напоминаниям пользователя. Посмотрите NSRemindersUsageDescription для подробных данных.

iOS 6.0 и позже

NSServices

«Службы»

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

OS X

NSSupportsAutomaticTermination

Ни один

Указывает, может ли приложение быть уничтожено для предъявления претензий в отношении памяти. Посмотрите NSSupportsAutomaticTermination для подробных данных.

OS X v10.7 и позже

NSSupportsSuddenTermination

Ни один

Указывает, может ли приложение быть уничтожено, чтобы допускать быстрее завершение работы или выйти из системы операции. Посмотрите NSSupportsSuddenTermination для подробных данных.

OS X

NSUbiquitousContainer

Ни один

Указывает настройки Drive iCloud для каждого контейнера. Посмотрите NSUbiquitousContainers для подробных данных.

iOS, OS X

NSUbiquitousContainerIsDocumentScopePublic

Ни один

Указывает, должен ли Диск iCloud совместно использовать содержание этого контейнера. Посмотрите NSUbiquitousContainerIsDocumentScopePublic для подробных данных.

iOS, OS X

NSUbiquitousContainerName

Ни один

Указывает имя, которое Диск iCloud выводит на экран для Вашего контейнера. Посмотрите NSUbiquitousContainerName для подробных данных.

iOS, OS X

NSUbiquitousContainerSupportedFolderLevels

Ни один

Указывает максимальное количество уровней папки в каталоге Documents Вашего контейнера. Посмотрите NSUbiquitousContainerSupportedFolderLevels для подробных данных.

iOS, OS X

NSUbiquitousDisplaySet

Ни один

Указывает мобильные данные документа, которые может просмотреть приложение. Посмотрите NSUbiquitousDisplaySet для подробных данных.

iOS, OS X

NSUserActivityTypes

Ни один

Указывает пользовательские типы действия что поддержки приложений. Посмотрите NSUserActivityTypes для подробных данных.

iOS, OS X

NSUserNotificationAlertStyle

Ни один

Указывает, должен ли стиль уведомления быть banner, alert, или none. Значение по умолчанию banner, который является рекомендуемым стилем. Посмотрите NSUserNotificationAlertStyle для подробных данных.

OS X

UTExportedTypeDeclarations

“Экспортируемый тип UTIs”

Массив словарей, указывающих основанные на UTI поддерживаемые типы (и принадлежавший) приложением. Посмотрите UTExportedTypeDeclarations для подробных данных.

iOS 5.0 и позже, OS X v10.7 и позже

UTImportedTypeDeclarations

“Импортированный тип UTIs”

Массив словарей, указывающих основанные на UTI поддерживаемые типы (но не принадлежавший) приложением. Посмотрите UTImportedTypeDeclarations для подробных данных.

iOS, OS X

GKGameCenterBadgingDisabled

GKGameCenterBadgingDisabled (Boolean - iOS). Этот ключ определяет, добавляются ли значки к базируемому значку приложения Вашего поворота. Установите значение этого ключа к YES выбирать из применения идентификационных знаков. Значения по умолчанию к NO.

GKShowChallengeBanners

GKShowChallengeBanners (Boolean - iOS). Этот ключ определяет, выведены ли баннеры проблемы на экран в приложении. Установите значение этого ключа к YES показать баннеры проблемы в приложении. Установите значение в NO подавить связанные с проблемой баннеры.

NSAppleScriptEnabled

NSAppleScriptEnabled (Boolean или String - OS X). Этот ключ идентифицирует, scriptable ли приложение. Установите значение этого ключа к true (когда введено как Boolean) или «YES» (когда введено как String) если Ваши поддержки приложений AppleScript.

NSBluetoothPeripheralUsageDescription

NSBluetoothPeripheralUsageDescription (String - iOS), описывает причину, что приложение использует Bluetooth. Когда системные приглашения пользователь для разрешения использования эта строка выведена на экран как часть диалогового окна.

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

NSCalendarsUsageDescription

NSCalendarsUsageDescription (String - iOS), описывает причину, что приложение получает доступ к календарям пользователя. Когда системные приглашения пользователь для предоставления доступа эта строка выведена на экран как часть диалогового окна.

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

NSCameraUsageDescription

NSCameraUsageDescription (String - iOS), описывает причину, что приложение получает доступ к камере устройства. Когда системные приглашения пользователь для предоставления доступа эта строка выведена на экран как часть диалогового окна.

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

NSContactsUsageDescription

NSContactsUsageDescription (String - iOS), описывает причину, что приложение получает доступ к контактам пользователя. Когда системные приглашения пользователь для предоставления доступа эта строка выведена на экран как часть диалогового окна.

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

NSDockTilePlugIn

NSDockTilePlugIn (String - OS X). Этот ключ содержит имя сменного пакета с .docktileplugin расширение файла и нахождение в приложении Contents/PlugIns каталог. Пакет должен содержать плагин мозаики Прикрепления для приложения. Для получения информации о создании плагина мозаики Прикрепления см. Руководство по программированию Мозаики Прикрепления.

NSHumanReadableCopyright

NSHumanReadableCopyright (String - OS X). Этот ключ содержит строку с уведомлением об авторском праве для пакета; например, © 2008, My Company. Можно загрузить эту строку и вывести на экран ее в диалоговом окне About. Этот ключ может быть локализован включением его в Вашем InfoPlist.strings файлы. Этот ключ заменяет устаревшее CFBundleGetInfoString ключ.

NSJavaNeeded

NSJavaNeeded (Boolean или String - OS X). Этот ключ указывает, должен ли Java VM быть загружен и запущен до выполнения кода пакета. Этот ключ требуется только для приложений Java Какао сказать системе запускать среду Java. Если Вы пишете чистое приложение Java, не включайте этот ключ.

Можно также указать строковый тип со значением «YES» вместо булева значения при желании.

Осуждаемый в OS X v10.5.

NSJavaPath

NSJavaPath (Array - OS X). Этот ключ содержит массив путей. Каждый точки контура к классу Java. Путь может быть или абсолютным путем или относительным путем от расположения, указанного ключом NSJavaRoot. Среда разработки (или, в частности, ее jamfiles) автоматически поддерживает значения в массиве.

Осуждаемый в OS X v10.5.

NSJavaRoot

NSJavaRoot (String - OS X). Этот ключ содержит строку, идентифицирующую каталог. Этот каталог представляет корневой каталог файлов класса Java приложения.

NSLocationAlwaysUsageDescription

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

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

Этот ключ поддерживается в iOS 8.0 и позже. Если Ваш Info.plist файл включает и этот ключ и NSLocationUsageDescription ключ, система использует этот ключ и игнорирует NSLocationUsageDescription ключ.

NSLocationUsageDescription

NSLocationUsageDescription (String - iOS), описывает причину, почему приложение получает доступ к информации о расположении пользователя. Когда системные приглашения пользователь для предоставления доступа эта строка выведена на экран как часть предупредительной панели.

Этот ключ поддерживается в iOS 6.0 и позже и проигнорирован в iOS 8 и позже. В iOS 8 необходимо использовать ключ NSLocationAlwaysUsageDescription или NSLocationWhenInUseUsageDescription вместо этого.

NSLocationWhenInUseUsageDescription

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

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

Этот ключ поддерживается в iOS 8.0 и позже. Если Ваш Info.plist файл включает и этот ключ и NSLocationUsageDescription ключ, система использует этот ключ и игнорирует NSLocationUsageDescription ключ.

NSMainNibFile

NSMainNibFile (String - iOS, OS X). Этот ключ содержит строку с именем основного файла пера приложения (минус .nib расширение). Файл пера является Интерфейсным архивом Разработчика, содержащим описание пользовательского интерфейса вместе с любыми соединениями между объектами того интерфейса. Когда приложение запускается, основной файл пера автоматически загружается.

Этот ключ является взаимоисключающим с ключом UIMainStoryboardFile. Необходимо включать один из ключей в Вашем Info.plist файл, но не оба.

NSMicrophoneUsageDescription

NSMicrophoneUsageDescription (String - iOS), описывает причину, что приложение получает доступ к микрофону устройства. Когда системные приглашения пользователь для предоставления доступа эта строка выведена на экран как часть диалогового окна.

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

NSMotionUsageDescription

NSMotionUsageDescription (String - iOS), описывает причину, что приложение получает доступ к акселерометру устройства. Когда системные приглашения пользователь для предоставления доступа эта строка выведена на экран как часть диалогового окна.

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

NSPersistentStoreTypeKey

NSPersistentStoreTypeKey (String - OS X). Этот ключ содержит строку, указывающую тип Базовых Данных персистентное хранилище, связанное с типом документа (см. CFBundleDocumentTypes).

NSPhotoLibraryUsageDescription

NSPhotoLibraryUsageDescription (String - iOS), описывает причину, что приложение получает доступ к фото библиотеке пользователя. Когда системные приглашения пользователь для предоставления доступа эта строка выведена на экран как часть диалогового окна.

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

NSPrefPaneIconFile

NSPrefPaneIconFile (String - OS X). Этот ключ содержит строку с именем файла образа (включая расширение) содержащий предпочтительный значок области. Этот ключ должен только использоваться предпочтительными пакетами области. Файл образа должен содержать значок 32 на 32 пикселя в размере. Если этот ключ опущен, приложение Установок системы ищет файл образа с помощью CFBundleIconFile ключ вместо этого.

NSPrefPaneIconLabel

NSPrefPaneIconLabel (String - OS X). Этот ключ содержит строку с именем предпочтительной области. Эта строка выведена на экран ниже предпочтительного значка области в приложении Установок системы. Можно разделить длинные имена на две строки включением символа новой строки (‘\n’) в строке. Если этот ключ опущен, приложение Установок системы завоевывает репутацию от CFBundleName ключ.

Этот ключ может быть локализован и включен в InfoPlist.strings файлы пакета.

NSPrincipalClass

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

NSRemindersUsageDescription

NSRemindersUsageDescription (String - iOS), описывает причину, что приложение получает доступ к напоминаниям пользователя. Когда системные приглашения пользователь для предоставления доступа эта строка выведена на экран как часть диалогового окна.

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

NSServices

NSServices (Array - OS X). Этот ключ содержит массив словарей, указывающих услуги, предоставленные приложением. Таблица 2 перечисляет ключи для указания службы:

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

Ключ

Имя XCode

Ввести

Описание

Платформы

NSPortName

“Входящее имя порта услуг”

String

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

OS X

NSMessage

“Имя метода экземпляра”

String

Этот ключ указывает имя метода экземпляра вызвать для службы. В Objective C метод экземпляра должен иметь форму messageName:userData:error:. В Java метод экземпляра должен иметь форму messageName(NSPasteBoard,String).

OS X

NSSendFileTypes

Ни один

Array

Этот ключ указывает массив строк. Каждая строка должна содержать UTI определение поддерживаемого типа файла. Только типы UTI позволяются; типы области монтажа не разрешены. Для указания типов области монтажа продолжайте использовать NSSendTypes ключ.

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

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

OS X

NSSendTypes

“Отправьте Типы”

Array

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

В OS X v10.5 и ранее, требуется этот ключ. В OS X v10.6 и позже, необходимо использовать NSSendFileTypes ключ вместо этого.

OS X

NSServiceDescription

Ни один

String

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

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

Доступный в OS X v10.6 и позже.

OS X

NSRequiredContext

Ни один

Dictionary или Array

Этот ключ указывает словарь с условиями, при которых Ваша служба сделана доступной для пользователя. Также можно указать массив словарей, каждый из которых содержит ряд условий для включения службы.

Посмотрите обсуждение после этой таблицы для получения информации об указании значения этого ключа. Доступный в OS X v10.6 и позже.

OS X

NSRestricted

Ни один

Boolean

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

Значение по умолчанию для этого ключа false. Доступный в OS X v10.7 и позже.

OS X

NSReturnTypes

“Возвратите Типы”

Array

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

OS X

NSMenuItem

«Меню»

Dictionary

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

В OS X v10.5 и ранее, пункты меню должны быть уникальными. Можно гарантировать уникальное имя путем объединения имени приложения с названием команды и разделения их символом наклонной черты “/”. Это эффективно создает подменю для Ваших служб. Например, Mail/Send появился бы в меню Services, когда Отправляет меню под названием Почта с элементом под названием.

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

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

OS X

NSKeyEquivalent

“Эквивалентная клавиша меню”

Dictionary

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

OS X

NSUserData

“Пользовательские Данные”

String

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

OS X

NSTimeout

“Значение тайм-аута (в миллисекундах)”

String

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

OS X

В OS X v10.6 и позже, NSRequiredContext ключ может содержать словарь или массив словарей, описывающих условия, при которых служба появляется в меню Services. При указании единственного словаря всем условиям в том словаре нужно удовлетворить для службы для появления. При указании массива словарей всем условиям в только одном из тех словарей нужно удовлетворить для службы для появления. Каждый словарь может содержать один или больше ключей, перечисленных в Таблице 3. Все ключи в словаре являются дополнительными.

Табличное 3  содержание NSRequiredContext словарь

Ключ

Имя XCode

Ввести

Описание

Платформа

NSApplicationIdentifier

Ни один

String или Array

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

OS X

NSTextScript

Ни один

String или Array

Значение этого ключа является строкой или массивом строк, каждая из которых содержит стандартный тег script с четырьмя буквами, такой как Latn или Cyrl. Ваша служба появляется, только если доминирующий сценарий выбранного текста соответствует одно из указанных значений сценария.

OS X

NSTextLanguage

Ни один

String или Array

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

Соответствие выполняется с помощью соответствующей префикс схемы. Например, указывая значение en соответствует текст, полный код BCP 47 которого en-US, en-GB, или en-AU.

OS X

NSWordLimit

Ни один

Number

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

OS X

NSTextContext

Ни один

String или Array

Значение этого ключа является строкой или массивом строк, каждая из которых содержит одно из следующих значений: URL, Date, Address, Email, или FilePath. Служба выведена на экран, только если выделенный текст содержит данные соответствующего типа. Например, если выделенный текст содержал http- если бы значение этого ключа было установлено в, основанная ссылка, служба была бы выведена на экран URL.

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

OS X

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

NSSupportsAutomaticTermination

NSSupportsAutomaticTermination (Boolean - OS X). Этот ключ содержит булевскую переменную, указывающую ли поддержки приложений автоматическое завершение в OS X v10.7 и позже. Автоматическое завершение позволяет приложение, работающее, чтобы быть завершенным автоматически системой, когда применяются определенные условия. Прежде всего приложение может быть завершено, когда оно скрыто или не имеет никаких видимых окон и в настоящее время не используется. Система может завершить такое приложение для предъявления претензий в отношении памяти, используемой приложением.

Приложение может программно отключить и повторно включить автоматическую поддержку завершения с помощью disableAutomaticTermination и enableAutomaticTermination методы NSProcessInfo. Приложение могло бы сделать это для предотвращения быть завершенным во время критической работы.

NSSupportsSuddenTermination

NSSupportsSuddenTermination (Boolean - OS X). Этот ключ содержит булевскую переменную, указывающую, может ли система уничтожить приложение напрямую, чтобы выйти из системы или закрыться более быстро. Вы используете этот ключ, чтобы указать, может ли приложение быть сразу уничтожено после запуска. Приложение может все еще включить или отключить внезапное завершение во время выполнения с помощью методов NSProcessInfo класс. Значение по умолчанию этого ключа NO.

NSUbiquitousContainers

NSUbiquitousContainers (Dictionary - iOS и OS X), Указывает настройки Drive iCloud для каждого контейнера. Ключи этого словаря являются контейнерными идентификаторами для контейнеров iCloud Вашего приложения. Значения являются словарями, содержащими NSUbiquitousContainerIsDocumentScopePublic, NSUbiquitousContainerName и NSUbiquitousContainerSupportedFolderLevels записи для каждого контейнера. Необходимо указать полномочия совместного использования отдельно для каждого контейнера.

NSUbiquitousContainerIsDocumentScopePublic

NSUbiquitousContainerIsDocumentScopePublic (Boolean - iOS и OS X), Указывает, должен ли диск iCloud совместно использовать содержание этого контейнера. Значения по умолчанию к NO.

NSUbiquitousContainerName

NSUbiquitousContainerName (String - iOS и OS X), Указывает имя, которое Диск iCloud выводит на экран для Вашего контейнера. По умолчанию Диск iCloud будет использовать имя пакета, которому принадлежит контейнер.

NSUbiquitousContainerSupportedFolderLevels

NSUbiquitousContainerSupportedFolderLevels (String - iOS и OS X), Указывает максимальное количество уровней папки в каталоге Documents Вашего контейнера. Этот ключ может принять три различных значения:

NSUbiquitousDisplaySet

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

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

NSUserActivityTypes

NSUserActivityTypes (Массив строк - iOS и OS X), Указывает пользовательские типы действия что поддержки приложений. Этот ключ допустим в iOS 8 и OS X v10.10 и позже.

NSUserNotificationAlertStyle

NSUserNotificationAlertStyle (String - OS X), указывает стиль уведомления, который должно использовать приложение. Значение по умолчанию, banner, рекомендуется; большинство приложений не должно должно быть использовать alert стиль.

UTExportedTypeDeclarations

UTExportedTypeDeclarations (Array - iOS, OS X), объявляет универсальные идентификаторы типов (UTIs), принадлежавший и экспортируемый приложением. Вы используете этот ключ, чтобы объявить пользовательские форматы данных Вашего приложения и связать их с UTIs. Экспорт списка UTIs является предпочтительным способом зарегистрировать Ваши пользовательские типы файлов; однако, Launch Services распознает этот ключ и его содержание только в OS X v10.5 и позже. Этот ключ проигнорирован на версиях OS X до версии 10.5.

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

Таблица 4  ключи списка свойств UTI

Ключ

Имя XCode

Ввести

Описание

Платформы

UTTypeConformsTo

“Соответствует UTIs”

Array

(Требуемый) Содержит массив строк. Каждая строка идентифицирует UTI, которому соответствует этот тип. Эти ключи представляют родительские категории, которым принадлежит Ваш пользовательский формат файла. Например, тип файла JPEG соответствует public.image и public.data типы. Для списка высокоуровневых типов см. Универсальный Обзор Идентификаторов типов.

iOS, OS X

UTTypeDescription

«Описание»

String

Читаемое пользователем описание этого типа. Строка, связанная с этим ключом, может быть локализована в Вашем пакете InfoPlist.strings файлы.

iOS, OS X

UTTypeIconFile

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

String

Имя ресурса значка пакета для соединения с этим UTI. Необходимо включать этот ключ только для типов, которые экспортирует приложение. Этот файл должен иметь a .icns расширение файла. Можно создать этот файл с помощью приложения Композитора Значка, идущего с Инструментами XCode.

OS X

UTTypeIdentifier

«Идентификатор»

String

(Требуемый) UTI Вы хотите присвоиться к типу. Эта строка использует формат обратного DNS, посредством чего больше универсальных типов на первом месте. Например, пользовательский формат для Вашей компании имел бы форму com.<yourcompany>.<type>.<subtype>.

iOS, OS X

UTTypeReferenceURL

“Ссылочный URL”

String

URL для справочного документа, описывающего этот тип.

OS X

UTTypeSize64IconFile

Ни один

String

Имя файла ресурсов значка на 64 x 64 пикселя (расположенный в пакете приложения) для соединения с этим UTI. Необходимо включать этот ключ только для типов, которые экспортирует приложение.

iOS

UTTypeSize320IconFile

Ни один

String

Имя файла ресурсов значка на 320 x 320 пикселей (расположенный в пакете приложения) для соединения с этим UTI. Необходимо включать этот ключ только для типов, которые экспортирует приложение.

iOS

UTTypeTagSpecification

“Эквивалентные Типы”

Dictionary

(Требуемый) словарь, определяющий одни или более эквивалентных идентификаторов типов. Пары ключ/значение, перечисленные в этом словаре, идентифицируют расширения файла, типы MIME, коды OSType и типы области монтажа, соответствующие этому типу. Например, для указания расширений файла Вы использовали бы ключ public.filename-extension и свяжите его с массивом строк, содержащих фактических внутренних абонентов. Для получения дополнительной информации о ключах для этого словаря, см. Универсальный Обзор Идентификаторов типов.

iOS, OS X

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

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

UTImportedTypeDeclarations

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

Значение для этого ключа является массивом словарей и использует те же ключи в качестве тех для ключа UTExportedTypeDeclarations. Для списка этих ключей посмотрите Таблицу 4.

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