Info.plist 用於向 iOS 提供關於 App、bundle 或 framework 的重要資訊,它指定了諸如應用應如何啟動、如何本地化、應用名稱、顯示圖示等等。Info.plist 檔案實際上是蘋果預定義 schema 的 XML 檔案。
為了建構裝置相關的健,需在健的後面加上 ~iphone 或 ~ipad。
常用欄位:
1. 取得版本資訊:
NSDictionary*infoDic = [[NSBundle mainBundle] infoDictionary];
NSString *localVersion = [infoDic objectForKey:@"CFBundleShortVersionString"];
2. 應用支援 http 網路請求:在 Info.plist 中加入 NSAppTransportSecurity 類型 Dictionary,並在其下加入 NSAllowsArbitraryLoads 類型 Boolean,值設為 YES。注意類型 NSAppTransportSecurity 為 Dictionary、NSAllowsArbitraryLoads 為 Boolean,複製貼上時不要多空格,否則容易導致 segment fault。
控制應用的名稱:
表 A-1 控制應用的名稱
欄位 / 類型 / 是否必須 / 摘要
CFBundleName / String / Yes / bundle 的簡稱,指定你的應用名稱
CFBundleDisplayName / String / No / 本地化的 bundle 名,可透過 InfoPlist.strings 檔案為每個語言指定合適的值
CFBundleDisplayName
指定一個字串值來標識 bundle 的顯示名稱,Finder 與其他用戶介面元件會把它顯示給使用者。這個名稱可與檔案系統中的 bundle 名不同。透過把欄位加入適當的 .lproj 子目錄中的 InfoPlist.strings 檔案,即可實現本地化。若需本地化此欄位,也應提供 CFBundleName 的本地化版本。
指定 bundle 的簡稱,應小於 16 個字符並適合在菜單與「關於」中顯示。透過把它加入適當的 .lproj 子文件夾下的 InfoPlist.strings 檔案,可被本地化。若本地化了此欄位,也應提供 CFBundleDisplayName 的本地化版本。
應用標識+應用版本:
表 A-2 應用標識+應用版本
欄位 / 類型 / 是否必須 / 摘要
CFBundleIdentifier / String / YES / bundle 的唯一標識字串,格式類似 Java 包命名,例如 com.apple.myapp
CFBundleShortVersionString / String / YES / 指定你在 App Store 上看到的版本號,每次發布須遞增
CFBundleVersion / String / YES / 可執行檔的創建號,每次發布時可遞增
指定 bundle 的唯一標識字串,採用類似 Java 包的命名方式,例如 com.apple.myapp。系統用這個字串唯一標識每個應用程式。它從你在 iOS Provisioning Portal 建立的 App ID 取得,App ID 包含 Team ID 與 Bundle ID 兩部分。
指定 bundle 的版本號,一般包含主、次版本號,格式通常為「n.n.n」,第一個數字是主要版本號,另兩個是次要版本號。該欄位的值會顯示在 Cocoa 應用程式的關於對話框中。它不同於 CFBundleVersion,描述一種更正式、且不隨每次創建而改變的版本號。
CFBundleVersion
指定一個字串用來標識創建號,其值通常隨每次創建而改變,會顯示在 Cocoa「關於」對話框的括號裡。若需指定發布版的版本資訊,可使用 CFBundleShortVersionString。
取得用戶權限資訊:
用來訪問用戶資訊的 Reason strings,iOS 6 中需從用戶取得授權的資料(Calendars、Contacts、Location、Photos、Reminders)。
表 A-3 取得用戶權限資訊
欄位 / 類型 / 是否必須 / 摘要
NSCalendarsUsageDescription / String / No / 應用首次訪問日曆時彈出框中顯示的文字
NSContactsUsageDescription / String / No / 應用首次訪問通訊錄時彈出框中顯示的文字
NSPhotoLibraryUsageDescription / String / No / 同上,照片
NSRemindersUsageDescription / String / No / 同上,備忘錄
NSLocationUsageDescription / String / No / 同上,位置資訊
應用圖示:
表 A-4 應用圖示
欄位 / 類型 / 是否必須 / 摘要
CFBundleIconFile / String / No / 圖示檔案的檔名(3.2 版本被廢棄)
UIPrerendered Icon / Boolean / No / 告訴 iOS 是否為應用圖示添加光照效果
CFBundleIconFiles / Array / No / 處理 iPad 與 retina 螢幕出現時所需圖示數量增長的問題,值為字串數組(5.0 版本被廢棄)
CFBundleIcons / NSDictionary / No / iOS 5.0 增加,可指定 Newsstand 圖示與普通應用的圖示
指定包含 bundle 圖示的檔案,給出的檔名不需包含「.icns」擴展名,Finder 會在 bundle 的「Resource」文件夾內尋找。若使用自定義圖示,就必須指定此屬性;否則 Finder(及其他應用)會使用缺省圖示。
控制應用初始化啟動:
表 A-5 控制應用初始化啟動
欄位 / 類型 / 是否必須 / 摘要
UILaunchImageFile / String / No / 啟動圖片
NSMainNibFile / String / No / 應用程式的主 nib 檔名,若用 NIB 則很重要,指定啟動時建立初始化視窗與相關物件的 NIB 檔
UIMainStoryboardFile / String / No / 若用 Storyboard 則很重要,指定啟動時建立初始介面的 storyboard 檔
包含應用程式主 nib 檔名(不含 .nib 擴展名)的字串。nib 檔作為 Interface Builder 的存檔檔,含有用戶介面的詳細描述及物件間關聯。應用程式啟動時主 nib 檔會被自動裝載,Mac OS X 會尋找與應用程式名相匹配的 nib 檔。
用戶介面:
表 A-6 用戶介面
欄位 / 類型 / 是否必須 / 摘要
UISupportedInterfaceOrientations / Array / No / 應用支援的螢幕方向數組
UIInterfaceOrientation / String / No / 若應用僅支援一個方向,應設定此欄位,保證啟動時狀態欄在正確方向
UIStatusBarStyle / String / No / 設定應用啟動時狀態欄的初始風格
UIStatusBarHidden / BOOL / No / 表示應用啟動時狀態欄是否隱藏
UIStatusBarTintParameters / NSDictionary / No / 狀態欄可進行一些美化
UISupportedInterfaceOrientations 可用選項:
UIInterfaceOrientationPortrait:Home 鍵在下方的豎屏模式
UIInterfaceOrientationPortraitUpsideDown:Home 鍵在上方的豎屏模式
UIInterfaceOrientationLandscapeLeft:Home 鍵在左方的橫屏模式
UIInterfaceOrientationLandscapeRight:Home 鍵在右方的橫屏模式
UIStatusBarStyle 枚舉值:UIStatusBarStyleDefault、UIStatusBarStyleBlackTranslucent、UIStatusBarStyleBlackOpaque。
UIStatusBarTintParameters 在 iOS 6 中可美化狀態欄,該字典有四個鍵:Style(導航條 barStyle)、Translucent(導航條 translucent)、TintColor(導航條修飾顏色)、groundImage(導航條背景圖片檔名)。
應用控制:
表 A-7 應用控制
欄位 / 類型 / 是否必須 / 摘要
UIRequiredDeviceCapabilities / Array/Dictionary / No / 指定設備必須要有的特性或必須不能有的特性
UIBackgroundModes / Array / No / 應用在後台運行時需要,數組包含所有後台模式
MKDirectionsApplicationSupportedModes / Array / No / iOS 6 新增,為特定區域與交通模式指定路由資訊
UIDeviceFamily / Number/Array / No / Xcode 自動添加,表示應用支援哪些設備
UIAppFonts / Array / No / 為應用添加非標準字體
UIApplicationExitsOnSuspend / Boolean / No / 設為 true 時應用直接中斷而非切換到後台
UIFileSharingEnabled / Boolean / No / 設為 true 時可讓使用者用 iTunes 文件共享從 document 目錄傳入或傳出檔案
UINewsstandApp / Boolean / No / 若應用為 Newsstand 類型,應設為 true
UIRequiresPersistentWiFi / Boolean / No / 設為 true 時,只要應用打開,網路連接就不會因閒置關閉
UISupportedExternalAccessoryProtocols / Array / No / 指定與附加硬體設備通訊的協議
UIBackgroundModes 可選值:audio(播放或錄製音頻)、location(後台訪問位置)、voip(IP 語音)、newsstand-content(後台下載並處理內容)、external-accessory(與外部設備通訊)、bluetooth-central(用 CoreBluetooth 與外部設備通訊)。
高級視圖控制:
表 A-8 高級視圖控制
欄位 / 類型 / 是否必須 / 摘要
UIViewEdgeAntialiasing / Boolean / No / 預設視圖由 iOS 渲染系統繪製,不含反鋸齒功能,因為不用反鋸齒運行更快
UIViewGroupOpacity / Boolean / No / 設定視圖透明度時,其所有子視圖會渲染成同樣的透明度
Core OS(以下為系統自動修改,無需手動修改):
表 A-9 Core OS
欄位 / 類型 / 是否必須 / 摘要
LSRequiresIPhoneOS / Boolean / No / iOS 應用運行在設備上必須,值必須為 true
CFBundlePackageType / String / No / 標識 bundle 類型的四字母代碼
CFBundleInfoDictionaryVersion / String / Yes / Info.plist 格式的版本資訊
CFBundleExecutable / String / Yes / bundle 的可執行檔名
CFBundleSignature / String / Yes / 標識創建者的四字母代碼(與 Mac 有關,和 iOS 無特別關係)
指定 bundle 的類型,類似 Mac OS 9 的檔案類型代碼,值為四字母長的代碼。應用程式的代碼是 'APPL',框架是 'FMWK',可裝載 bundle 是 'BND'。
CFBundleInfoDictionaryVersion
指定屬性列表結構的當前版本號,使得可支援 Info.plist 格式未來的版本。建立 bundle 時 Project Builder 會自動產生此欄位。
CFBundleExecutable
標識 bundle 的可執行主檔案名稱。對應用程式而言就是可執行檔;對可加載 bundle 而言是可被動態加載的二進制檔;對框架而言是共享庫。對於框架,考慮啟動效率,可執行檔名需與框架名同名,且不應包含可用於多種平台的擴展名。
必須在 bundle 的 Info.plist 中包含有效的 CFBundleExecutable 欄位,即使使用者重命名了目錄,Mac OS X 也能用它定位可執行檔與共享庫。
CFBundleSignature
指定 bundle 的創建者,類似 Mac OS 9 中的檔案創建者代碼,值為四字母長的代碼,用來確定每一個 bundle。
本地化:
表 A-10 本地化
欄位 / 類型 / 是否必須 / 摘要
CFBundleLocalizations / Array / No / 系統透過查找應用提供的 .lproj 目錄決定支援哪些語言地區,值為字串數組,每個值代表支援的地區
CFBundleDevelopmentRegion / String / No / 當使用者請求的區域沒有資源時,用來表示預設的本地化區域
自定義 URL 和文檔類型:
表 A-11 自定義 URL 和文檔類型
欄位 / 類型 / 是否必須 / 摘要
CFBundleURLTypes / Array / No / 描述 bundle 支援的 URL 協議的字典組,可指定應用支援的 URL 數組
CFBundleDocumentTypes / Array / No / 描述 bundle 支援的文檔類型的字典組,可指定應用可處理的文檔類型
UIImportedTypeDeclarations / Array / No / 為允許應用打開不屬於它的類型,需導入那個 UTI
表 A-11-1 CFBundleURLTypes 字典的欄位:
CFBundleTypeRole / String / 定義與 URL 類型有關的應用角色,值可以是 Editor、Viewer、Printer、Shell 或 None(必須)
CFBundleURLIconFile / String / 指定對這種 URL 所使用的圖示的檔名
CFBundleURLName / String / 這種 URL 類型的抽象名稱,建議用 Java 包命名法確保唯一
CFBundleURLSchemes / Array / 可被這種類型處理的 URL 協議,如 http、ftp 等
表 A-11-2 CFBundleDocumentTypes 字典的欄位:
CFBundleTypeExtensions / Array / 映射到這個類型的檔案擴展名,可用單星號「*」打開任意擴展名(必須)
CFBundleTypeIconFile / String / 系統顯示該類文檔時使用的圖示檔名,擴展名可選
CFBundleTypeName / String / 這種文檔類型的抽象名稱,可透過 InfoPlist.strings 本地化
CFBundleTypeOSTypes / Array / 映射到這個類型的四字母長的類型代碼,可設為「****」打開所有類型(必須)
CFBundleTypeRole / String / 定義與文檔類型有關的應用角色(必須)
NSDocumentClass / String / 用來實例化文檔的 NSDocument 子類(僅供 Cocoa 應用)
NSExportableAs / Array / 描述一組可輸出的文檔類型(僅供 Cocoa 應用)
使用 iCloud:
表 A-12 使用 iCloud
欄位 / 類型 / 是否必須 / 摘要
NSUbiquitousDisplaySet / String / No / iCloud 用它表示應用的檔案存儲,可想象成 iCloud 中存放應用檔案的目錄
Bundle 核心欄位:
Mac OS X 為描述 bundle 的資訊提供了一組核心欄位,集成開發環境會賦予這些欄位缺省值。
表 A-13 標準欄位概要
欄位 / 類型 / 是否必須 / 摘要
CFBundleDevelopmentRegion / String / No / bundle 的地區,通常對應於作者的母語
CFBundleGetInfoString / String / No / 用來在 Finder 的 Get Info 面板中顯示的字串
CFBundleHelpBookFolder / String / No / 含有 bundle 幫助檔案的文件夾名字
CFBundleHelpBookName / String / No / bundle 的幫助啟動時顯示的幫助檔名
指定一個字串值來標識 bundle 的地區,通常對應於作者的母語。若找不到使用者首選的地區或語言的資源,系統最後會使用該值。
含有會在 bundle 資訊窗口中顯示的純文本字串,格式應遵照 Mac OS 9 中的長字串,例如「2.2.1, © Great Software, Inc, 1999」。可透過合適的 .lproj 目錄中的 InfoPlist.strings 本地化。若同時存在 CFBundleGetInfoHTML,系統會優先使用後者。
含有 bundle 幫助檔案的文件夾名字。幫助通常被本地化成指定語言,所以該欄位指向的文件夾應是所選語言的 .lproj 目錄中的文件夾。
指定應用程式的幫助主頁。該欄位指定的幫助頁面名可與 HTML 檔名不同,在幫助檔案 META 標籤的 CONTENT 屬性中指定。
應用程式特定的欄位:
表 A-14 應用程式特定的欄位
欄位 / 類型 / 是否必須 / 摘要
CFAppleHelpAnchor / String / No / bundle 的初始 HTML 幫助檔
NSAppleScriptEnabled / String / No / 指定是否支援 AppleScript
NSHumanReadableCopyright / String / Yes / 顯示在對話框中的版權資訊
NSMainNibFile / String / Yes / 應用程式的主 nib 檔名
NSPrincipalClass / String / Yes / bundle 的主類名
NSServices / Array / No / 描述應用程式提供服務的字典組
NSHumanReadableCopyright 含有 bundle 的版權資訊字串,可在「關於」對話框中顯示,通常需要本地化,因此常出現在 InfoPlist.strings 中。
NSPrincipalClass 定義 bundle 的主類名稱,對應用程式而言缺省就是應用程式名。
NSServices 包含一組字典,詳細說明應用程式提供的服務。表 A-14-1 列出用來指定服務的欄位:NSPortName(監聽器為接受外部服務請求提供的端口名)、NSMessage(調用服務的實例方法名)、NSSendTypes(服務可讀取的資料類型)、NSReturnTypes(服務可返回的資料類型)、NSMenuItem(加入 Services 菜單的文本)、NSKeyEquivalent(請求服務菜單命令的快捷鍵)、NSUserData(選擇值)、NSTimeout(等待響應的毫秒數)。
啟動服務欄位:
啟動服務欄位規定了 Mac OS X 中的應用程式如何被啟動,適用於 CFM 與 Mach-O 可執行檔。表 A-15 列出啟動服務欄位:LSBackgroundOnly(是否僅在後台運行)、LSPrefersCarbon(是否優先運行在 Carbon 環境)、LSPrefersClassic(是否優先運行在 Classic 環境)、LSRequiresCarbon(是否必須運行在 Carbon 環境)、LSRequiresClassic(是否必須運行在 Classic 環境)、LSUIElement(是否為用戶介面組件,不出現在 Dock 或強制退出窗口)。
LSUIElement 若設為「1」,啟動服務會把應用程式作為用戶介面組件運行,不出現在 Dock 或強制退出窗口。Dock 與登錄窗口便是兩個用戶介面組件應用程式。
應用程式包欄位:
應用程式打包的目的是把應用打包成一個自我包含的實體,並對使用者隱藏其內容。開發者可在 Info.plist 中指定一些可由使用者維護的項目,Finder 會把這些項目顯示在 bundle 的資訊面板中,允許使用者瀏覽、刪除或添加。
表 A-16-1 應用程式打包欄位:APInstallerURL(指向希望安裝的檔案的 URL 路徑,必須)、APFiles(描述可被安裝的檔案或目錄的字典組,必須)。APFiles 的每個字典條目可包含 APFileDescriptionKey(顯示在 Finder 資訊窗口的簡短描述)、APDisplayedAsContainer(是否作為目錄圖示顯示)、APFileDestinationPath(安裝組件的相對路徑)、APFileName(檔案或目錄名稱)、APFileSourcePath(指向應用程式包中組件的路徑)、APInstallAction(操縱組件的動作:Copy 或 Open)。
UIFileSharingEnabled 應用程式支援 iTunes 共享文件夾 值為 boolean YES 共享;NO 不共享
這個欄位在欄位編輯器中的名稱為:Application supports iTunes file sharing
整理自:https://www.cnblogs.com/adamleung/p/3494651.html 與 https://blog.csdn.net/swj6125/article/details/9791109
轉載請標明出處。如有問題歡迎指正,本人也是參考前人文章總結的,可能與最新 Xcode 有些出入!