CFPreferences Plist файлы

Дисковые файлы списка свойств, используемые CFPreferences, всегда были частной подробностью реализации, но в предыдущих выпусках, непосредственно изменение их главным образом работало (хотя существуют некоторые потенциальные проблемы потери данных для приложений, делающих так, даже в предыдущих системах). В 10,8 и позже, процесс агента CFPreferences (cfprefsd) будет кэшировать информацию от этих файлов и асинхронно писать в них. Это означает, что непосредственно изменение plist файлы вряд ли будет иметь ожидаемые результаты (новые настройки будут не обязательно считаны и могут даже быть перезаписаны). Необходимо использовать NSUserDefaults или APIs CFPreferences или значения по умолчанию (1) команда, для взаимодействия с предпочтительной системой.

CFPreferencesAppSynchronize () и автоматическая синхронизация

CFPreferences теперь использует автоматическую систему синхронизации для домена текущего приложения, который всегда использовал NSUserDefaults. Кроме того, автоматическая синхронизация теперь неблокирует в большинстве случаев. Необходимо полагать, что любые вызовы к CFPreferencesAppSynchronize () тщательно видят, действительно необходимы ли они, поскольку можно избежать блокировать IO путем удаления их.

CFPreferences euid/uid обработка

До OS X Lion CFPreferences (и поэтому NSUserDefaults) изменил бы владельца plist файлов, которые это записало в uid/gid приложения, пишущего в предпочтения. У Льва, для приложений, соединенных против Льва или позже, файл будет принадлежать euid/egid вместо этого. Можно временно вернуться к старому поведению для тестирования путем установки __ CFPREFERENCES_USE_OLD_UID_BEHAVIOR в ненулевое значение в среде. Это прежде всего повлияет на приложения с привилегированными инструментами помощника, пишущими в предпочтения непривилегированных приложений, такие как Прикрепление или родительский процесс.

Расстановка переносов CFString

CFString теперь включает средство для определения местоположения потенциальных дефисных точек в слове. Когда автоматическая разбивка слова для переноса включена, это предназначается для использования текстовых механизмов расположения, таких как NSTypesetter. Расстановка переносов зависит в большой степени от языка текста, который будет написан через дефис, и CFStringGetHyphenationLocationBeforeIndex () требует, чтобы это было указано как CFLocale. Данные расстановки переносов являются доступными только для определенных языков, в настоящее время английскими (США и Великобритания), французский, немецкий, итальянский, испанский, нидерландский и русский язык, несмотря на то, что этот список может быть расширен в будущем. Определение во время выполнения того, доступны ли данные расстановки переносов для данного языка, может быть сделано с помощью CFStringIsHyphenationAvailableForLocale ().

Функции, связанные со средством расстановки переносов, следующие:

CFIndex CFStringGetHyphenationLocationBeforeIndex(CFStringRef string, CFIndex location, CFRange limitRange,

                                      CFOptionFlags options, CFLocaleRef locale, UTF32Char *character);

Boolean CFStringIsHyphenationAvailableForLocale(CFLocaleRef locale);

Для использования CFStringGetHyphenationLocationBeforeIndex () клиент должен передать в строке, содержащей текст, предназначенный, чтобы быть написанным через дефис, расположение, перед которым дефисная точка должна быть найдена, диапазон, ограничивающий часть текста, который будет исследован, и локаль. Возвращаемое значение будет индексом в строке, где является надлежащим вставить дефис или CFNotFound, если ни один не найден, который является и перед указанным расположением и в ограничивающем диапазоне. Могут быть случаи на определенных языках, на которых символ кроме стандартного дефиса используется для указания расстановки переносов, и символьный параметр предназначается для возврата предложенного символа ссылкой; клиенты могут передать NULL для этого параметра, если они не интересуются этой информацией.

CFStringGetFileSystemRepresentation

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

CFStringCapitalize

Логика капитализации улучшена для поддержки диграфа, «IJ», с голландской локалью.

База данных CoreFoundation Unicode

База данных CoreFoundation Unicode обновляется к версии 6.0.

kCFCompareForcedOrdering и kCFCompareNumerically с CFStringCompareWithOptionsAndLocale ()

Когда эти два числовых значения равны, мы не смогли вызвать упорядочивание для различий в цифровых символах. Кроме того, в некоторых случаях мы не приводили к идеальным результатам (т.е. 001 <01). Мы оцениваем упорядочивание на основе числа цифр, вовлеченных в числовое значение.

Распределенная поставка уведомления

Если Вы хотите, чтобы отправленное распределенное уведомление было сразу получено, уверены, что Вы передаете флаг поведения приостановки CFNotificationSuspensionBehaviorDeliverImmediately при регистрации для уведомления или использовании флага kCFNotificationDeliverImmediately при регистрации. Ошибки в выпусках OS X до 10,7 означали, что иногда распределенное уведомление поставить через временно отстраненным наблюдателям и не должным образом поставить в очередь, даже когда не использовались те флаги.

CFCalendar

Алгоритмы CFCalendar имеют несколько различий, в зависимости от которых OS версия SDK Вы создаете свое приложение против. CFCalendarGetRangeOfUnit () может привести к существенно различным результатам для OS X 10.4, OS X 10.5 и OS X 10.6/10.7. CFCalendarGetOrdinalityOfUnit () может привести к существенно различным результатам для прееOS X 10.6 и OS X 10.6/10.7. CFCalendarComposeAbsoluteTime () может привести к различным результатам на OS X 10.7, чем ранее при работе с Недельными модулями.

Но конечно, большинство алгоритмов может привести к различным результатам между версиями ОС, поскольку ошибки исправлены, или изменения внесены, или в Основе или в CoreFoundation или в библиотеках ниже их. Различиями, отмеченными в предыдущем абзаце, являются значительные.

В CFCalendar существует 3 новых Связанных с неделей константы модуля/компонента:

kCFCalendarUnitWeekOfMonth, kCFCalendarUnitWeekOfYear, kCFCalendarUnitYearForWeekOfYear

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

Для многих операций нет никакого различия в значении между kCFCalendarUnitWeekOfMonth и kCFCalendarUnitWeekOfYear, но для некоторых, которые существует различие. Очевидно, получение ordinality недели с месяцем будет обычно давать различный ответ, чем ordinality недели в течение года. kCFCalendarUnitWeek константа официально еще не осуждается, но ее использованию в новом коде обескураживают. Это имеет поведение или как kCFCalendarUnitWeekOfMonth или как kCFCalendarUnitWeekOfYear, в зависимости от обстоятельств, для предоставления его, поведение как он имело до OS X 10.7.

CFURL

Мы добавили много новых ключей свойства ресурса.

Функции CFURLCreateBookmarkDataFromFile () и CFURLWriteBookmarkDataToFile () были представлены iOS 5.0. Они были ранее представлены OS X 10.6.

CFURLEnumerator

CFURLEnumeratorGetSourceDidChange () теперь осуждается.

kCFURLEnumeratorIncludeDirectoriesPreOrder и kCFURLEnumeratorIncludeDirectoriesPostOrder опции для рекурсивных перечислителей каталога были добавлены.

CFFileSecurity

CFFileSecurity является новым типом объекта, представленным для замены Файлового менеджера Углерода объект FSFileSecurity. CFFileSecurityRef и FSFileSecurityRef являются тем же типом объекта (т.е. у них есть тот же идентификатор типа, и конкретная реализация является тем же).

CFError

Мы добавили ключи kCFErrorFilePathKey userInfo словаря и kCFErrorURLKey.

Новый CFRunLoop API

Существует две новых функции для создания CFRunLoopObservers и CFRunLoopTimers, соответственно, которые берут Блок для выполнения, а не указатель функции и аргументы context:

CFRunLoopObserverRef CFRunLoopObserverCreateWithHandler(CFAllocatorRef allocator, CFOptionFlags activities, Boolean repeats,

                                CFIndex order, void (^block)(CFRunLoopObserverRef observer, CFRunLoopActivity activity))

CFRunLoopTimerRef CFRunLoopTimerCreateWithHandler(CFAllocatorRef allocator, CFAbsoluteTime fireDate, CFTimeInterval interval,

                                CFOptionFlags flags, CFIndex order, void (^block)(CFRunLoopTimerRef timer))

CFXMLParser (Новый начиная с WWDC 2008)

CFXMLParser и CFXMLNode будут официально осуждаться в будущей главной версии OS X. CFXMLParser имеет некоторые недостатки с точки зрения соответствия стандартов и производительности, и клиенты должны переместить свое использование классов CFXMLParser NSXMLParser, NSXMLDocument или другого XML парсинг технологий на OS X.

CoreFoundation API, не доступный в iOS 2.0

OS X APIs в CFUserNotification.h, CFXMLParser.h, CFXMLNode.h и CFStringTokenizer.h не доступен в iOS 2.0. Распределенные уведомления (CFNotificationCenterGetDistributedCenter ()) также не доступны. Иначе, iOS 2.0 содержит API, соответствующий это в OS X 10.5.

CoreFoundation API, не доступный в iOS 3.0

OS X APIs в CFUserNotification.h, CFXMLParser.h и CFXMLNode.h не доступен в iOS 3.0. Распределенные уведомления (CFNotificationCenterGetDistributedCenter ()) также не доступны. Иначе, iOS 3.0 содержит API, соответствующий это в OS X 10.5.

Новый CFCalendarUnit

Новая единица времени по календарю «четверти» (kCFCalendarUnitQuarter) была добавлена к набору CFCalendarUnits (CFCalendar.h).

Новые календари

Четыре новых календарных константы (kCFRepublicOfChinaCalendar, kCFPersianCalendar, kCFIndianCalendar, kCFISO8601Calendar) были добавлены (CFLocale.h). Календарь ISO8601 еще не реализован. Может быть создан китайский календарь, и можно сделать calendrical вычисления с ним, но он не должен использоваться для форматирования, поскольку необходимая базовая функциональность правильно еще не функционирует.

CFDataFind (Новый начиная с семени в ноябре)

CFData теперь имеет функцию, которая будет эффективно искать ее содержание:

    CFRange CFDataFind(CFDataRef theData, CFDataRef dataToFind, CFRange searchRange, CFDataSearchFlags compareOptions);

Семантика почти идентична CFStringFind. Единственной значительной разницей является отсутствие 'нечувствительных к регистру' и 'литеральных' параметров поиска, которые только применимы к строкам.

CFString (Обновленный начиная с WWDC 2008)

Если бы объем памяти, требуемый для хранения результатов преобразования кодирования, превысил бы LONG_MAX, CFStringGetMaximumSizeForEncoding функций () и CFStringGetMaximumSizeOfFileSystemRepresentation () теперь возвратит kCFNotFound.

Примечание использования: При использовании CFStringCreateWithFormat (), и любой другой CFString или NSString форматирование APIs, это недопустимо для передачи меньше упорядоченного (n$) параметры, чем существуют параметры. Например:

    CFStringCreateWithFormat(NULL, NULL, CFSTR("%2$d", arg1, arg2);

Это вызвано тем, что нет никакого пути к CFString, чтобы знать, как пропустить первый параметр для получения до второго. Нет никакого изменения поведения здесь, просто разъяснение.

CFString

Существует теперь 4 новых подставляемых функции для работы с суррогатными символами UTF-16, объявленными в CFString.h. CFStringIsSurrogateHighCharacter () и CFStringIsSurrogateLowCharacter () идентифицируют суррогатные символы. CFStringGetLongCharacterForSurrogatePair () отображает пару высоких и низких суррогатных символов к Скалярному значению Unicode. CFStringGetSurrogatePairForLongCharacter () отображает Значение Счетчика Unicode назад на суррогатную пару.

Существует две новых константы CFStringEncoding: KCFStringEncodingUTF7 и kCFStringEncodingUTF7_IMAP.

Unicode (Новый начиная с WWDC 2008)

База данных CoreFoundation Unicode обновляется к версии 5.1.

CFCharacterSet (Новый начиная с WWDC 2008)

CFCharacterSetCreateWithCharactersInString, CFCharacterSetAddCharactersInString и CFCharacterSetRemoveCharactersInString теперь правильно распознают суррогатный Париж в строке.