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

Xcode 中 Info.plist 欄位完整詳解

編輯:iOS 開發基礎

     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 的本地化版本。

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 / 可執行檔的創建號,每次發布時可遞增

CFBundleIdentifier

指定 bundle 的唯一標識字串,採用類似 Java 包的命名方式,例如 com.apple.myapp。系統用這個字串唯一標識每個應用程式。它從你在 iOS Provisioning Portal 建立的 App ID 取得,App ID 包含 Team ID 與 Bundle ID 兩部分。

CFBundleShortVersionString

指定 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 圖示與普通應用的圖示

CFBundleIconFile

指定包含 bundle 圖示的檔案,給出的檔名不需包含「.icns」擴展名,Finder 會在 bundle 的「Resource」文件夾內尋找。若使用自定義圖示,就必須指定此屬性;否則 Finder(及其他應用)會使用缺省圖示。

控制應用初始化啟動:


表 A-5 控制應用初始化啟動

欄位 / 類型 / 是否必須 / 摘要

UILaunchImageFile / String / No / 啟動圖片

NSMainNibFile / String / No / 應用程式的主 nib 檔名,若用 NIB 則很重要,指定啟動時建立初始化視窗與相關物件的 NIB 檔

UIMainStoryboardFile / String / No / 若用 Storyboard 則很重要,指定啟動時建立初始介面的 storyboard 檔

NSMainNibFile

包含應用程式主 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 無特別關係)

CFBundlePackageType

指定 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 的幫助啟動時顯示的幫助檔名

CFBundleDevelopmentRegion

指定一個字串值來標識 bundle 的地區,通常對應於作者的母語。若找不到使用者首選的地區或語言的資源,系統最後會使用該值。

CFBundleGetInfoString

含有會在 bundle 資訊窗口中顯示的純文本字串,格式應遵照 Mac OS 9 中的長字串,例如「2.2.1, © Great Software, Inc, 1999」。可透過合適的 .lproj 目錄中的 InfoPlist.strings 本地化。若同時存在 CFBundleGetInfoHTML,系統會優先使用後者。

CFBundleHelpBookFolder

含有 bundle 幫助檔案的文件夾名字。幫助通常被本地化成指定語言,所以該欄位指向的文件夾應是所選語言的 .lproj 目錄中的文件夾。

CFBundleHelpBookName

指定應用程式的幫助主頁。該欄位指定的幫助頁面名可與 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 有些出入!

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