Info.plist 是每個 iOS App、Bundle 或 Framework 都不可或缺的設定檔,它向系統說明這個 App 該如何啟動、如何進行本地化、對外顯示的名稱與圖標,以及其他一大堆關鍵資訊。簡單來說,它就是一份遵循 Apple 預定結構的 XML 設定檔,是 App 與系統溝通的身分證。
還有一個實用的小技巧:當你想為特定裝置提供專屬設定時,只要在欄位名稱後面加上 ~iphone 或 ~ipad 後綴即可,系統會自動判斷並套用對應的值。
想在程式碼中取得 App 的版本資訊,可以透過主 Bundle 的資訊字典來讀取:
NSDictionary *infoDic = [[NSBundle mainBundle] infoDictionary]; NSString *localVersion = [infoDic objectForKey:@"CFBundleShortVersionString"];
從 iOS 9 開始,App Transport Security(ATS)預設會阻擋所有明文 HTTP 連線。若你的 App 需要存取 HTTP 資源,可在 Info.plist 中新增一個型別為 Dictionary 的 NSAppTransportSecurity,並在其下加入一個型別為 Boolean、值設為 YES 的 NSAllowsArbitraryLoads。
這裡要特別提醒:複製貼上時千萬注意不要多打空格。NSAppTransportSecurity 必須是 Dictionary、NSAllowsArbitraryLoads 必須是 Boolean,若直接從網頁複製,常常會莫名其妙多出一個空格,導致 App 閃退(segment fault)。
CFBundleName(String,必填):Bundle 的簡稱,用來指定 App 的名稱,建議少於 16 個字元,適合顯示於選單與「關於」頁面,可透過各語言的 InfoPlist.strings 進行本地化。
CFBundleDisplayName(String,選填):Bundle 的本地化顯示名稱。Finder 與各種使用者介面元件會將它顯示給使用者,這個名稱可以與檔案系統中的 Bundle 名稱不同。若要本地化,請在對應的 .lproj 子目錄中的 InfoPlist.strings 裡指定;同時也別忘了提供 CFBundleName 的本地化版本。
CFBundleIdentifier(String,必填):Bundle 的唯一識別字串,命名方式類似 Java 的套件名稱,例如 com.apple.myapp。系統靠它在執行期定位 Bundle,並用它唯一標識每一支 App。它通常取自你在 iOS Provisioning Portal 建立的 App ID,而 App ID 由 Team ID 與 Bundle ID 兩部分組成。
CFBundleShortVersionString(String,必填):對外正式發布的版本號,格式通常為「n.n.n」,第一個數字是主版本,其餘為次版本。這就是你在 App Store 上看到的版本號,每次上架都必須遞增。它描述的是一種正式、不隨每次編譯而變動的版本。
CFBundleVersion(String,必填):建置編號(build number),代表可執行檔的建置序號,通常每次編譯打包時遞增,會顯示在「關於」頁面的括號內。若你需要標示正式發布版本,請以 CFBundleShortVersionString 為準。
從 iOS 6 起,存取日曆、聯絡人、位置、照片、提醒等敏感資料前,系統會跳出提示框向使用者請求授權。你可以在 Info.plist 中為這些用途設定說明文字,該文字會顯示在授權提示框裡:
NSCalendarsUsageDescription:App 首次存取日曆時顯示的用途說明。
NSContactsUsageDescription:App 首次存取通訊錄時顯示的用途說明。
NSPhotoLibraryUsageDescription:存取照片時的用途說明。
NSRemindersUsageDescription:存取提醒事項時的用途說明。
NSLocationUsageDescription:存取位置資訊時的用途說明。
這些欄位都是 String 型別且非必填,但良好實作會清楚說明「為什麼需要這個權限」,以提高使用者授權意願。
CFBundleIconFile(String,選填):圖標檔案的名稱,可省略副檔名,系統會在 Resources 目錄尋找。此欄位自 3.2 版起被棄用。
UIPrerenderedIcon(Boolean,選填):自第一版 iOS SDK 便存在,用來告訴系統是否要為你的圖標加上 iOS 預設的光照效果。
CFBundleIconFiles(Array,選填):為因應 iPad 與 Retina 螢幕出現而增加的圖標需求所設計,值為字串陣列,自 5.0 版起被棄用。
CFBundleIcons(NSDictionary,選填):iOS 5.0 新增,可讓開發者分別指定 Newsstand 圖標與一般 App 圖標。
UILaunchImageFile(String,選填):啟動圖片。
NSMainNibFile(String,選填):主 nib 檔案名稱。若你使用 NIB,這是相當重要的一個鍵,它指定 App 啟動時用來建立初始視窗與相關物件的 NIB 檔。
UIMainStoryboardFile(String,選填):若你使用 Storyboard,這就是關鍵欄位,它指定 App 啟動時建立初始界面的 Storyboard 檔。
UISupportedInterfaceOrientations(Array,選填):一個陣列,列出 App 支援的所有螢幕方向,可選值包含:
UIInterfaceOrientationPortrait(Home 鍵在下方)、UIInterfaceOrientationPortraitUpsideDown(Home 鍵在上方)、UIInterfaceOrientationLandscapeLeft(Home 鍵在左方)、UIInterfaceOrientationLandscapeRight(Home 鍵在右方)。
UIInterfaceOrientation(String,選填):若 App 只支援單一方向,建議設定此鍵,確保啟動時狀態列方向正確,避免啟動後才透過動畫轉向另一個方向。
UIStatusBarStyle(String,選填):設定啟動時狀態列的初始樣式,可選值有 UIStatusBarStyleDefault、UIStatusBarStyleBlackTranslucent、UIStatusBarStyleBlackOpaque。
UIStatusBarHidden(BOOL,選填):控制 App 啟動時狀態列是否隱藏。
UIStatusBarTintParameters(NSDictionary,選填):iOS 6 起可對狀態列進行美化,此字典包含 Style(對應導覽列 barStyle)、Translucent(對應 translucent 屬性)、TintColor(導覽列修飾顏色)與 groundImage(導覽列背景圖檔名)四個鍵。
UIRequiredDeviceCapabilities(Array/Dictionary,選填):指定裝置必須具備或必須不具備的能力。
UIBackgroundModes(Array,選填):當 App 需要在背景執行時使用,陣列中包含所需的背景模式,可選值有 audio(播放或錄製音訊)、location(背景取得位置)、voip(IP 語音)、newsstand-content(背景下載雜誌內容)、external-accessory(與外部配件通訊)、bluetooth-central(使用 CoreBluetooth 與外部裝置通訊)等。
MKDirectionsApplicationSupportedModes(Array,選填):iOS 6 新增,用於為特定區域與交通模式指定 App 的路線資訊。
UIDeviceFamily(Number/Array,選填):由 Xcode 自動加入,表示 App 支援哪些裝置,通常不需手動設定。
UIAppFonts(Array,選填):若需要非系統標準字型,可透過此欄位為 App 加入自訂字型。
UIApplicationExitsOnSuspend(Boolean,選填):設為 true 時,App 會直接結束而非切換到背景。
UIFileSharingEnabled(Boolean,選填):設為 true 後,使用者可透過 iTunes 檔案共享功能,將檔案傳入或傳出 App 的 Documents 目錄。
UINewsstandApp(Boolean,選填):若你的 App 屬於 Newsstand 類型,應設為 true。
UIRequiresPersistentWiFi(Boolean,選填):iOS 預設在裝置閒置 30 分鐘後關閉 Wi-Fi。設為 true 可覆蓋此行為,只要 App 開啟中,網路連線就不會中斷。
UISupportedExternalAccessoryProtocols(Array,選填):指定與外部硬體配件通訊所用的協議。
UIViewEdgeAntialiasing(Boolean,選填):預設情況下,視圖由 iOS 的繪製系統渲染,不開啟反鋸齒,因為關閉反鋸齒能獲得更好的效能。
UIViewGroupOpacity(Boolean,選填):設定後,當你調整視圖透明度時,其所有子視圖會以相同透明度在背後一起渲染。
LSRequiresIPhoneOS(Boolean):App 要在裝置上運行必須為 true。
CFBundlePackageType(String):以四個字母的代碼標識 Bundle 類型,App 為 APPL、Framework 為 FMWK、可載入 Bundle 為 BNDL。
CFBundleInfoDictionaryVersion(String,必填):Info.plist 格式的版本資訊,用來告訴系統目前檔案對應的結構版本,由開發工具自動產生。
CFBundleExecutable(String,必填):Bundle 的主可執行檔名稱。對 App 而言就是應用程式本體;對可載入 Bundle 而言是可動態載入的執行檔;對 Framework 而言則是共享函式庫。即使使用者重新命名 App 目錄,系統仍能靠此欄位定位可執行檔。
CFBundleSignature(String,必填):以四個字母標識建立者的代碼,主要與 Mac 相關,和 iOS 關係不大。
CFBundleLocalizations(Array,選填):系統會透過查找 App 提供的 .lproj 目錄來判斷支援的語言地區,此欄位則以字串陣列明確列出支援的地區。
CFBundleDevelopmentRegion(String,選填):開發時通常使用母語撰寫,此欄位指定當使用者請求的地區沒有對應資源時,所使用的預設本地化地區。
CFBundleURLTypes(Array,選填):一組描述 App 所支援 URL 協議的字典陣列。每個字典對應一種 URL 規則,其中包含 CFBundleTypeRole(App 扮演的角色,如 Editor、Viewer、Shell 等)、CFBundleURLIconFile(該 URL 類型使用的圖標檔名)、CFBundleURLName(唯一的抽象名稱,建議用 Java 套件命名法)、CFBundleURLSchemes(此類型可處理的 URL 協議陣列,如 http、ftp)。
CFBundleDocumentTypes(Array,選填):一組描述 App 支援的文件類型字典。每個字典可包含 CFBundleTypeExtensions(對應的副檔名)、CFBundleTypeIconFile(文件圖標)、CFBundleTypeName(抽象名稱)、CFBundleTypeOSTypes(四字母類型代碼,可設為 **** 以開啟所有類型)、CFBundleTypeRole(角色)、NSDocumentClass(用來實例化文件的 NSDocument 子類,僅供 Cocoa 使用)等欄位。
UIImportedTypeDeclarations(Array,選填):若 App 需要開啟並非自己定義的檔案類型,就必須匯入該 UTI,這時會用到此欄位。
NSUbiquitousDisplaySet(String,選填):iCloud 用它來表示 App 的檔案儲存位置,你可以把它想像成 iCloud 上一個專門存放該 App 檔案的目錄。
除了上述欄位外,還有一些通用核心欄位,例如 CFBundleGetInfoString(在 Finder 的「顯示簡介」面板中顯示的純文字)、CFBundleGetInfoHTML(顯示的 HTML 字串,若兩者同時存在則優先採用 HTML)、CFBundleHelpBookFolder(幫助檔案所在資料夾)與 CFBundleHelpBookName(幫助首頁名稱)。這些欄位大多可透過 .lproj 目錄中的 InfoPlist.strings 進行本地化。
還有幾個常見的應用程式專屬欄位:NSHumanReadableCopyright(顯示於「關於」頁的版權資訊)、NSPrincipalClass(Bundle 主類別名稱,對 App 而言預設就是 App 名稱)、NSAppleScriptEnabled(是否支援 AppleScript)等。掌握這些欄位的含義,你就能從容應對大多數 iOS 開發中的設定需求。