您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iPhone 開發筆記:info.plist 設定檔(二)文件類型與 URL 協定

編輯:iOS 開發綜合

info.plist 中有一大批鍵負責描述「這個程式能處理什麼」。本篇文章整理文件類型對應(CFBundleDocumentTypes)與 URL 協定對應(CFBundleURLTypes),以及 Bundle 自身的識別、版本與圖示相關設定。

CFBundleDocumentTypes 字典的關鍵字

CFBundleDocumentTypes 是一個字典陣列,每個字典定義一種文件類型:

  • CFBundleTypeExtensions(Array,必填):對應此類型的副檔名清單。若想開啟任何副檔名的文件,用單一星號 "*"。
  • CFBundleTypeIconFile(String):系統顯示此類文件時使用的圖示檔名,副檔名可省略;若省略,系統會依平台自行補上(例如 Mac OS 9 的 .icons)。
  • CFBundleTypeName(String):此文件類型的抽象名稱,可透過對應的 InfoPlist.strings 檔做本地化。
  • CFBundleTypeOSTypes(Array,必填):對應此類型的四字母 OSType 代碼清單。若要開啟所有類型,設為 "****"。
  • CFBundleTypeRole(String,必填):應用程式對此文件類型所扮演的角色,可為 Editor、Viewer、Printer、Shell 或 None。
  • NSDocumentClass(String):用來實例化文件的 NSDocument 子類別,僅供 Cocoa 應用程式使用。
  • NSExportableAs(Array):可輸出的文件類型清單,僅供 Cocoa 應用程式使用。

Bundle 通用關鍵字

CFBundleExecutable

標識該束主要可執行檔的名稱。對應用程式來說就是應用程式本身的可執行檔;對可載入束來說,是能被動態載入的二元檔;對框架而言則是一個共享函式庫。Project Builder 會自動把這個鍵加進對應專案的 Info.plist。

對框架特別提醒:基於啟動效能的考量,可執行檔名應與框架同名,且檔名不應帶有多平台用的副檔名。

這個鍵是必填的。即使使用者重新命名了應用程式或其所在目錄,Mac OS X 仍能靠它定位可執行檔與共享函式庫。

CFBundleGetInfoHTML

含有會顯示於束資訊視窗中的 HTML 字串。若希望在資訊視窗裡呈現比純文字更豐富的內容,就用它取代 CFBundleGetInfoString。透過放進對應的 .lproj 目錄下的 InfoPlist.strings 檔,這個字串也能本地化。

當 CFBundleGetInfoString 與 CFBundleGetInfoHTML 同時存在時,系統會採用 HTML 版本。

CFBundleGetInfoString

含有顯示於資訊視窗的純文字字串,格式沿用 Mac OS 9 的「長字串」慣例,例如 "2.2.1, © Great Software, Inc, 1999"。同樣可透過 .lproj 目錄下的 InfoPlist.strings 檔本地化。若 CFBundleGetInfoHTML 已存在,這個鍵會被忽略。

CFBundleHelpBookFolder

該束說明檔案所在資料夾的名稱。說明文件通常會針對特定語言做本地化,因此這個鍵指向的資料夾應位於所選語言的 .lproj 目錄之下。

CFBundleHelpBookName

指定應用程式的說明首頁。這個頁面名稱可以與實際的 HTML 檔名不同——真正的對應關係寫在說明檔 META 標籤的 CONTENT 屬性中。

CFBundleIconFile

指定包含該束圖示的檔案,檔名不需要帶 ".icns" 副檔名。Finder 會在該束的 Resources 資料夾內尋找。若你的束使用自訂圖示,就必須設定這個鍵;否則 Finder 與其他應用程式一律以預設圖示顯示。

CFBundleIdentifier

該束的唯一識別字串,命名風格類似 Java 套件,例如 com.apple.myapp。這個識別碼可在執行期用來定位該束,預置系統也靠它唯一標識每一個應用程式。實務上一旦發布就不要再更改,否則會影響更新與偏好設定的沿用。

CFBundleInfoDictionaryVersion

屬性列表結構的目前版本號。保留這個鍵,是為了讓 Info.plist 格式在未來仍能維持向後相容。建立束時 Project Builder 會自動產生。

CFBundleName

該束的簡稱,建議少於 16 個字元,並且適合在選單與「關於」視窗中顯示。透過放進對應 .lproj 子資料夾的 InfoPlist.strings 檔即可本地化;若你本地化了這個鍵,也應一併提供 CFBundleDisplayName 的本地化版本。

CFBundlePackageType

該束的類型,概念上等同 Mac OS 9 的檔案類型代碼,值為四個字母。應用程式是 'APPL',框架是 'FMWK',可載入束是 'BNDL'。若有需要,也可以為可載入束自訂其他類型代碼。

CFBundleShortVersionString

該束的版本號,一般包含主版本與次版本,格式通常為 "n.n.n"。第一個數字是主版本,其餘為次版本。這個值會顯示在 Cocoa 應用程式的「關於」對話框中。

它與 CFBundleVersion 不同:後者標識的是每一次建置的建置號,而 CFBundleShortVersionString 描述的是一種更正式、不隨每次建置變動的版本。

CFBundleSignature

該束的建立者標識,概念等同 Mac OS 9 的檔案建立者代碼,值為四個字母。

CFBundleURLTypes

一組字典,描述應用程式所支援的 URL 協定。作用與 CFBundleDocumentTypes 類似,只是描述對象從文件類型換成 URL 協定,每個字典條目對應一種協定。

子鍵說明:

  • CFBundleTypeRole(String,必填):應用程式對此 URL 類型所扮演的角色,可為 Editor、Viewer、Printer、Shell 或 None。
  • CFBundleURLIconFile(String):此 URL 類型使用的圖示檔名,不含副檔名。
  • CFBundleURLName(String):此 URL 類型的抽象名稱。為確保唯一性,建議採用 Java 套件式的命名法;這個名字也會作為鍵出現在 InfoPlist.strings 中,用來提供可讀的名稱版本。
  • CFBundleURLSchemes(Array):此類型可處理的 URL 協定清單,例如 http、ftp 等。

CFBundleVersion

標識建置號的字串,通常每次建置都會變動,會顯示在 Cocoa「關於」對話框的括號中。若要指定對外發布的版本資訊,請改用 CFBundleShortVersionString。

小結

這批鍵可以分成兩個方向理解:一類是「我是誰」(CFBundleIdentifier、CFBundleName、CFBundleSignature、CFBundlePackageType、版本與圖示),另一類是「我能處理什麼」(CFBundleDocumentTypes 與 CFBundleURLTypes)。前者影響系統如何辨識與更新你的程式,後者決定當使用者點開一個檔案或一個連結時,系統會不會把你的應用程式列入候選。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved