| /* |
| * Copyright (c) 2008-2009 Brent Fulgham <bfulgham@gmail.org>. All rights reserved. |
| * |
| * This source code is a modified version of the CoreFoundation sources released by Apple Inc. under |
| * the terms of the APSL version 2.0 (see below). |
| * |
| * For information about changes from the original Apple source release can be found by reviewing the |
| * source control system for the project at https://sourceforge.net/svn/?group_id=246198. |
| * |
| * The original license information is as follows: |
| * |
| * Copyright (c) 2008 Apple Inc. All rights reserved. |
| * |
| * @APPLE_LICENSE_HEADER_START@ |
| * |
| * This file contains Original Code and/or Modifications of Original Code |
| * as defined in and that are subject to the Apple Public Source License |
| * Version 2.0 (the 'License'). You may not use this file except in |
| * compliance with the License. Please obtain a copy of the License at |
| * http://www.opensource.apple.com/apsl/ and read it before using this |
| * file. |
| * |
| * The Original Code and all software distributed under the License are |
| * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER |
| * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, |
| * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, |
| * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. |
| * Please see the License for the specific language governing rights and |
| * limitations under the License. |
| * |
| * @APPLE_LICENSE_HEADER_END@ |
| */ |
| /* CFBundlePriv.h |
| Copyright (c) 1999-2007, Apple Inc. All rights reserved. |
| */ |
| |
| #if !defined(__COREFOUNDATION_CFBUNDLEPRIV__) |
| #define __COREFOUNDATION_CFBUNDLEPRIV__ 1 |
| |
| #include <CoreFoundation/CFBase.h> |
| #include <CoreFoundation/CFArray.h> |
| #include <CoreFoundation/CFBundle.h> |
| #include <CoreFoundation/CFDictionary.h> |
| #include <CoreFoundation/CFString.h> |
| #include <CoreFoundation/CFURL.h> |
| |
| CF_EXTERN_C_BEGIN |
| |
| /* Finder stuff */ |
| CF_EXPORT |
| const CFStringRef _kCFBundlePackageTypeKey; |
| CF_EXPORT |
| const CFStringRef _kCFBundleSignatureKey; |
| CF_EXPORT |
| const CFStringRef _kCFBundleIconFileKey; |
| CF_EXPORT |
| const CFStringRef _kCFBundleDocumentTypesKey; |
| CF_EXPORT |
| const CFStringRef _kCFBundleURLTypesKey; |
| |
| /* Localizable Finder stuff */ |
| CF_EXPORT |
| const CFStringRef _kCFBundleDisplayNameKey; |
| CF_EXPORT |
| const CFStringRef _kCFBundleShortVersionStringKey; |
| CF_EXPORT |
| const CFStringRef _kCFBundleGetInfoStringKey; |
| CF_EXPORT |
| const CFStringRef _kCFBundleGetInfoHTMLKey; |
| |
| /* Sub-keys for CFBundleDocumentTypes dictionaries */ |
| CF_EXPORT |
| const CFStringRef _kCFBundleTypeNameKey; |
| CF_EXPORT |
| const CFStringRef _kCFBundleTypeRoleKey; |
| CF_EXPORT |
| const CFStringRef _kCFBundleTypeIconFileKey; |
| CF_EXPORT |
| const CFStringRef _kCFBundleTypeOSTypesKey; |
| CF_EXPORT |
| const CFStringRef _kCFBundleTypeExtensionsKey; |
| CF_EXPORT |
| const CFStringRef _kCFBundleTypeMIMETypesKey; |
| |
| /* Sub-keys for CFBundleURLTypes dictionaries */ |
| CF_EXPORT |
| const CFStringRef _kCFBundleURLNameKey; |
| CF_EXPORT |
| const CFStringRef _kCFBundleURLIconFileKey; |
| CF_EXPORT |
| const CFStringRef _kCFBundleURLSchemesKey; |
| |
| /* Compatibility key names */ |
| CF_EXPORT |
| const CFStringRef _kCFBundleOldExecutableKey; |
| CF_EXPORT |
| const CFStringRef _kCFBundleOldInfoDictionaryVersionKey; |
| CF_EXPORT |
| const CFStringRef _kCFBundleOldNameKey; |
| CF_EXPORT |
| const CFStringRef _kCFBundleOldIconFileKey; |
| CF_EXPORT |
| const CFStringRef _kCFBundleOldDocumentTypesKey; |
| CF_EXPORT |
| const CFStringRef _kCFBundleOldShortVersionStringKey; |
| |
| /* Compatibility CFBundleDocumentTypes key names */ |
| CF_EXPORT |
| const CFStringRef _kCFBundleOldTypeNameKey; |
| CF_EXPORT |
| const CFStringRef _kCFBundleOldTypeRoleKey; |
| CF_EXPORT |
| const CFStringRef _kCFBundleOldTypeIconFileKey; |
| CF_EXPORT |
| const CFStringRef _kCFBundleOldTypeExtensions1Key; |
| CF_EXPORT |
| const CFStringRef _kCFBundleOldTypeExtensions2Key; |
| CF_EXPORT |
| const CFStringRef _kCFBundleOldTypeOSTypesKey; |
| |
| |
| /* Functions for examining directories that may "look like" bundles */ |
| |
| CF_EXPORT |
| CFURLRef _CFBundleCopyBundleURLForExecutableURL(CFURLRef url); |
| |
| CF_EXPORT |
| Boolean _CFBundleURLLooksLikeBundle(CFURLRef url); |
| |
| CF_EXPORT |
| CFBundleRef _CFBundleCreateIfLooksLikeBundle(CFAllocatorRef allocator, CFURLRef url); |
| |
| CF_EXPORT |
| CFBundleRef _CFBundleGetMainBundleIfLooksLikeBundle(void); |
| |
| CF_EXPORT |
| Boolean _CFBundleMainBundleInfoDictionaryComesFromResourceFork(void); |
| |
| CF_EXPORT |
| CFBundleRef _CFBundleCreateWithExecutableURLIfLooksLikeBundle(CFAllocatorRef allocator, CFURLRef url); |
| |
| CF_EXPORT |
| CFURLRef _CFBundleCopyMainBundleExecutableURL(Boolean *looksLikeBundle); |
| |
| CF_EXPORT |
| CFBundleRef _CFBundleGetExistingBundleWithBundleURL(CFURLRef bundleURL); |
| |
| /* Functions for examining the structure of a bundle */ |
| |
| CF_EXPORT |
| CFURLRef _CFBundleCopyResourceForkURL(CFBundleRef bundle); |
| |
| CF_EXPORT |
| CFURLRef _CFBundleCopyInfoPlistURL(CFBundleRef bundle); |
| |
| |
| /* Functions for working without a bundle instance */ |
| |
| CF_EXPORT |
| CFURLRef _CFBundleCopyExecutableURLInDirectory(CFURLRef url); |
| |
| CF_EXPORT |
| CFURLRef _CFBundleCopyOtherExecutableURLInDirectory(CFURLRef url); |
| |
| |
| /* Functions for dealing with localizations */ |
| |
| CF_EXPORT |
| void _CFBundleGetLanguageAndRegionCodes(SInt32 *languageCode, SInt32 *regionCode); |
| // may return -1 for either one if no code can be found |
| |
| CF_EXPORT |
| Boolean CFBundleGetLocalizationInfoForLocalization(CFStringRef localizationName, SInt32 *languageCode, SInt32 *regionCode, SInt32 *scriptCode, CFStringEncoding *stringEncoding); |
| /* Gets the appropriate language and region codes, and the default */ |
| /* script code and encoding, for the localization specified. */ |
| /* Pass NULL for the localizationName to get these values for the */ |
| /* single most preferred localization in the current context. */ |
| /* May give -1 if there is no language or region code for a particular */ |
| /* localization. Returns false if CFBundle has no information about */ |
| /* the given localization. */ |
| |
| CF_EXPORT |
| CFStringRef CFBundleCopyLocalizationForLocalizationInfo(SInt32 languageCode, SInt32 regionCode, SInt32 scriptCode, CFStringEncoding stringEncoding); |
| /* Returns the default localization for the combination of codes */ |
| /* specified. Pass in -1 for language, region code, or script code, or */ |
| /* 0xFFFF for stringEncoding, if you do not wish to specify one of these. */ |
| |
| CF_EXPORT |
| void _CFBundleSetDefaultLocalization(CFStringRef localizationName); |
| |
| |
| /* Functions for dealing specifically with CFM executables */ |
| |
| CF_EXPORT |
| void *_CFBundleGetCFMFunctionPointerForName(CFBundleRef bundle, CFStringRef funcName); |
| |
| CF_EXPORT |
| void _CFBundleGetCFMFunctionPointersForNames(CFBundleRef bundle, CFArrayRef functionNames, void *ftbl[]); |
| |
| CF_EXPORT |
| void _CFBundleSetCFMConnectionID(CFBundleRef bundle, void *connectionID); |
| |
| |
| /* Miscellaneous functions */ |
| |
| CF_EXPORT |
| CFStringRef _CFBundleCopyFileTypeForFileURL(CFURLRef url); |
| |
| CF_EXPORT |
| CFStringRef _CFBundleCopyFileTypeForFileData(CFDataRef data); |
| |
| CF_EXPORT |
| Boolean _CFBundleGetHasChanged(CFBundleRef bundle); |
| |
| CF_EXPORT |
| void _CFBundleFlushCaches(void); |
| |
| CF_EXPORT |
| void _CFBundleFlushCachesForURL(CFURLRef url); |
| |
| CF_EXPORT |
| void _CFBundleFlushBundleCaches(CFBundleRef bundle); // The previous two functions flush cached resource paths; this one also flushes bundle-specific caches such as the info dictionary and strings files |
| |
| CF_EXPORT |
| void _CFBundleSetStringsFilesShared(CFBundleRef bundle, Boolean flag); |
| |
| CF_EXPORT |
| Boolean _CFBundleGetStringsFilesShared(CFBundleRef bundle); |
| |
| |
| /* Functions deprecated as SPI */ |
| |
| CF_EXPORT |
| CFDictionaryRef _CFBundleGetLocalInfoDictionary(CFBundleRef bundle); // deprecated in favor of CFBundleGetLocalInfoDictionary |
| |
| CF_EXPORT |
| CFPropertyListRef _CFBundleGetValueForInfoKey(CFBundleRef bundle, CFStringRef key); // deprecated in favor of CFBundleGetValueForInfoDictionaryKey |
| |
| CF_EXPORT |
| Boolean _CFBundleGetPackageInfoInDirectory(CFAllocatorRef alloc, CFURLRef url, UInt32 *packageType, UInt32 *packageCreator); // deprecated in favor of CFBundleGetPackageInfoInDirectory |
| |
| CF_EXPORT |
| CFDictionaryRef _CFBundleCopyInfoDictionaryInResourceFork(CFURLRef url); // CFBundleCopyInfoDictionaryForURL is usually preferred; for the main bundle, however, no special call is necessary, since the info dictionary will automatically be available whether the app is bundled or not |
| |
| CF_EXPORT |
| CFURLRef _CFBundleCopyPrivateFrameworksURL(CFBundleRef bundle); // deprecated in favor of CFBundleCopyPrivateFrameworksURL |
| |
| CF_EXPORT |
| CFURLRef _CFBundleCopySharedFrameworksURL(CFBundleRef bundle); // deprecated in favor of CFBundleCopySharedFrameworksURL |
| |
| CF_EXPORT |
| CFURLRef _CFBundleCopySharedSupportURL(CFBundleRef bundle); // deprecated in favor of CFBundleCopySharedSupportURL |
| |
| CF_EXPORT |
| CFURLRef _CFBundleCopyBuiltInPlugInsURL(CFBundleRef bundle); // deprecated in favor of CFBundleCopyBuiltInPlugInsURL |
| |
| CF_EXPORT |
| CFArrayRef _CFBundleCopyBundleRegionsArray(CFBundleRef bundle); // deprecated in favor of CFBundleCopyBundleLocalizations |
| |
| CF_EXPORT |
| CFURLRef _CFBundleCopyResourceURLForLanguage(CFBundleRef bundle, CFStringRef resourceName, CFStringRef resourceType, CFStringRef subDirName, CFStringRef language); // deprecated in favor of CFBundleCopyResourceURLForLocalization |
| |
| CF_EXPORT |
| CFArrayRef _CFBundleCopyResourceURLsOfTypeForLanguage(CFBundleRef bundle, CFStringRef resourceType, CFStringRef subDirName, CFStringRef language); // deprecated in favor of CFBundleCopyResourceURLsOfTypeForLocalization |
| |
| CF_EXPORT |
| CFBundleRefNum _CFBundleOpenBundleResourceFork(CFBundleRef bundle); // deprecated in favor of CFBundleOpenBundleResourceMap |
| |
| CF_EXPORT |
| void _CFBundleCloseBundleResourceFork(CFBundleRef bundle); // deprecated in favor of CFBundleCloseBundleResourceMap |
| |
| CF_EXTERN_C_END |
| |
| #endif /* ! __COREFOUNDATION_CFBUNDLEPRIV__ */ |
| |
