表 A-2 CFBundleDocumentTypes字典的關鍵字
關鍵字類型描述CFBundleTypeExtensionsArray該關鍵字包含瞭一組映射到這個類型的文件擴展名。為瞭打開具有任何擴展名的文檔,可以用單個星號“*”。該關鍵字是必須的。CFBundleTypeIconFileString該關鍵字指定瞭系統顯示該類文檔時使用的圖標文件名,該圖標文件名的擴展名是可選的。如果沒有擴展名,系統會根據平臺指定一個(例如,Mac OS 9中的.icons)。CFBundleTypeNameString該關鍵字包含瞭這種文檔類型的抽象名稱。通過在適當的InforPlist.strings文件中包含該關鍵字,可以實現對它的本地化。CFBundleTypeOSTypesArray該關鍵字包含瞭一組映射到這個類型的四字母長的類型代碼。為瞭打開所有類型的文檔,可以把它設為“****”。該關鍵字是必須的。CFBundleTypeRoleString該關鍵字定義瞭那些與文檔類型有關的應用程序的角色。它的值可以是Editer,Viewer,Printer,Shell或None。有關這些值的詳細描述可以參見“ 文檔的配置”。該關鍵字是必須的。NSDocumentClassString該關鍵字描述瞭被用來實例化文檔的NSDocument子類。僅供Cocoa應用程序使用。NSExportableAsArray該關鍵字描述瞭一組可以輸出的文檔類型。僅供Cocoa應用程序使用。
CFBundleExecutable
CFBundleExecutable 標識瞭束的可執行主文件的名稱。對於一個應用程序來說,就是該應用程序的可執行文件。對於一個可加載束,它是一個可以被束動態加載的二進制文件。對於一個框架,它是一個共享庫。Project Builder會自動把該關鍵字加入到合適項目的Info.plist文件中。
對於框架,考慮到啟動效率的原因,可執行文件名需要和框架名同名。該可執行文件名不應該包含可用於多種平臺的擴展名。
註意
您必須在束的Info.plist文件中包含一個有效的CFBundleExecutable關鍵字。即使當用戶重命名應用程序或束的目錄時,Mac OS X也可以使用這個關鍵字來定位可執行文件和共享庫。
CFBundleGetInfoHTML
CFBundleGetInfoHTML關鍵字含有會在束的信息窗口中顯示的HTML字符串。如果您希望在信息窗口中有更強的表現力,可以使用這個鍵值對來替代純文本的CFBundleGetInfoString。通過把它加入到合適的.lproj目錄中的InfoPlist.strings文件中,您也可以本地化該字符串。
如果CFBundleGetInfoString和CFBundleGetInfoHTML同時存在的話,系統會選擇使用CFBundleGetInfoHTML。
CFBundleGetInfoString
CFBundleGetInfoString關鍵字含有會在束的信息窗口中顯示的純文本字符串(這裡的字符串也就是Mac OS 9中的長字符串)。該關鍵字的格式應該遵照Mac OS 9中的長字符串,例如:“2.2.1, ? Great Software, Inc, 1999”。通過把它加入到合適的.lproj目錄中的InfoPlist.strings文件中,您也可以本地化該字符串。
如果存在CFBundleGetInfoHTML的話,系統不會選擇使用該關鍵字。
CFBundleHelpBookFolder
CFBundleHelpBookFolder關鍵字含有該束的幫助文件的文件夾名字。幫助通常被本地化成一種指定的語言,所以該關鍵字指向的文件夾應該是所選擇語言的.lproj目錄中的文件夾。
CFBundleHelpBookName
CFBundleHelpBookName指定瞭您的應用程序的幫助主頁。該關鍵字指定的幫助頁面名可以和HTML文件名不同。在幫助文件META標簽的CONTENT屬性中指定瞭幫助頁面名。
CFBundleIconFile
CFBundleIconFile關鍵字指定瞭包含該束圖標的文件。您給出的文件名不需要包含“.icns”擴展名。Finder會在該束的“Resource”文件夾內尋找圖標文件。
如果您的束使用瞭自定義的圖標,那您就必須指定該屬性。假如您沒有指定,Finder(和其他應用程序)會使用缺省的圖標來顯示您的束。
CFBundleIdentifier
CFBundleIdentifier關鍵字指定瞭束的一個唯一的標識字符串。該標識符采用瞭類似Java包的命名方式,例如com.apple.myapp。該束標識符可以在運行時定位束。預置系統使用這個字符串來唯一地標識每個應用程序。
CFBundleInfoDictionaryVersion
CFBundleInfoDictionaryVersion關鍵字指定瞭屬性列表結構的當前版本號。該關鍵字的存在使得可以支持Info.plist格式將來的版本。在您建立一個束時,Project Builder會自動產生該關鍵字。
CFBundleName
CFBundleName指定瞭該束的簡稱。簡稱應該小於16個字符並且適合在菜單和“關於”中顯示。通過把它加入到適當的.lproj子文件夾下的InfoPlist.strings文件中,該關鍵字可以被本地化。如果您本地化瞭該關鍵字,那您也應該提供一個CFBundleDisplayName關鍵字的本地化版本。
CFBundlePackageType
CFBundlePackageType關鍵字指定瞭束的類型,類似於Mac OS 9的文件類型代碼。該關鍵字的值包含一個四個字母長的代碼。應用程序的代碼是‘APPL’;框架的代碼是‘FMWK’;可裝載束的代碼是‘BND’。如果您需要,您也可以為可裝載束選擇其他特殊的類型代碼。
CFBundleShortVersionString
CFBundleShortVersionString關鍵字指定瞭束的版本號。一般包含該束的主、次版本號。這個字符串的格式通常是“n.n.n”(n表示某個數字)。第一個數字是束的主要版本號,另兩個是次要版本號。該關鍵字的值會被顯示在Cocoa應用程序的關於對話框中。
該關鍵字不同於CFBundleVersion,它指定瞭一個特殊的創建號。而CFBundleShortVersionString的值描述瞭一種更加正式的並且不隨每一次創建而改變的版本號。
CFBundleSignature
CFBundleSignature關鍵字指定瞭束的創建者,類似於Mac OS 9中的文件創建者代碼。該關鍵字的值包含四字母長的代碼,用來確定每一個束。
CFBundleURLTypes
CFBundleURLTypes關鍵字包含瞭一組描述瞭應用程序所支持的URL協議的字典。它的用途類似於CFBundleDocumentTypes的作用,但它描述瞭URL協議而不是文檔類型。每一個字典條目對應一個單獨的URL協議。表A-3列出瞭在每一個字典條目中使用的關鍵字。
表A-3 CFBundleURLTypes字典的關鍵字
關鍵字類型描述CFBundleTypeRoleString該關鍵字定義瞭那些與URL類型有關的應用程序的角色(即該應用程序與某種文檔類型的關系)。它的值可以是Editer,Viewer,Printer,Shell或None。有關這些值的詳細描述可以參見“ 文檔的配置”。該關鍵字是必須的。CFBundleURLIconFileString該關鍵字包含瞭被用於這種URL類型的圖標文件名(不包括擴展名)字符串。CFBundleURLNameString該關鍵字包含瞭這種URL類型的抽象名稱字符串。為瞭確保唯一性,建議您使用Java包方式的命名法則。這個名字作為一個關鍵字也會在InfoPlist.strings文件中出現,用來提供該類型名的可讀性版本。CFBundleURLSchemesArray該關鍵字包含瞭一組可被這種類型處理的URL協議。例如:http,ftp等。CFBundleVersion
CFBundleVersion關鍵字指定瞭一個字符串用來標識創建號。該關鍵字的值通常隨每一次創建而改變,並且會被顯示在Cocoa"關於"對話框中的擴號裡。
為瞭指定一個發佈版的束的版本信息,可以使用CFBundleShortVersionString關鍵字。參見“CFBundleShortVersionString”。
摘自 雲懷空-abel