介紹

捆綁是macOS和iOS中用于封裝代碼和資源的基礎(chǔ)技術(shù)。軟件包通過為所需資源提供已知位置來簡化開發(fā)人員體驗，同時減少創(chuàng)建復(fù)合二進制文件的需要。相反，捆綁包使用目錄和文件來提供更自然的組織類型，也可以在開發(fā)和部署過程中輕松修改。

為了支持bundle，Cocoa和Core Foundation都提供了用于訪問bundle的內(nèi)容的編程接口。由于捆綁包使用有組織的結(jié)構(gòu)，因此所有開發(fā)人員都了解捆綁的基本組織原則很重要。本文檔為您提供了解軟件包的工作原理以及開發(fā)過程中如何使用它們來訪問資源文件的基礎(chǔ)。

本文檔的組織

本文檔包含以下章節(jié)：

關(guān)于Bundles介紹了bundle和packages的概念，以及系統(tǒng)如何使用它們。
捆綁結(jié)構(gòu)描述了標(biāo)準(zhǔn)捆綁類型的結(jié)構(gòu)和內(nèi)容。
訪問Bundle的內(nèi)容顯示如何使用Cocoa和Core Foundation界面來獲取有關(guān)bundle及其內(nèi)容的信息。
文檔包描述了文檔包（與捆綁松散相關(guān)）以及如何使用它們的概念。

雖然本文檔中的信息適用于所有類型的軟件包，但如果您使用更專門的軟件包（如框架和插件），則還應(yīng)參考以下文檔：

框架編程指南提供了有關(guān)創(chuàng)建和使用自定義框架的詳細(xì)信息。
代碼加載編程主題提供有關(guān)使用Objective-C語言編寫插件的信息。
插件提供了有關(guān)使用C語言編寫插件的信息。

關(guān)于捆綁

捆綁是在MacOS和iOS中提供軟件的便捷方式。捆綁包為終端用戶提供簡化的界面，同時為開發(fā)提供支持。本章介紹捆綁包，并討論他們在macOS和iOS中的作用。

軟件包和軟件包

雖然捆綁包和包裹有時被稱為可互換的，但它們實際上代表著非常不同的概念：

包是Finder向用戶呈現(xiàn)的任何目錄，就像它是單個文件一樣。
捆綁包是具有標(biāo)準(zhǔn)化層次結(jié)構(gòu)的目錄，其中包含可執(zhí)行代碼和該代碼使用的資源。
軟件包提供了使MacOS易于使用的基本抽象之一。如果您查看計算機上的應(yīng)用程序或插件，您實際查看的是一個目錄。軟件包目錄中是使應(yīng)用程序或插件運行所需的代碼和資源文件。然而，當(dāng)您與包目錄進行交互時，F(xiàn)inder將其視為單個文件。此行為可防止臨時用戶進行可能會對軟件包內(nèi)容產(chǎn)生不利影響的更改。例如，它阻止用戶重新排列或刪除可能阻止應(yīng)用程序正常運行的資源或代碼模塊。

注意：即使軟件包默認(rèn)為不透明文件，用戶仍然可以查看和修改其內(nèi)容。在包目錄的上下文菜單中是“顯示包內(nèi)容”命令。選擇此命令將顯示一個新的Finder窗口，設(shè)置為包目錄的頂層。用戶可以使用此窗口來導(dǎo)航包的目錄結(jié)構(gòu)，并進行更改，就像它是常規(guī)目錄層次結(jié)構(gòu)一樣。
而軟件包可以改善用戶體驗，捆綁更適合幫助開發(fā)人員打包他們的代碼，并幫助操作系統(tǒng)訪問該代碼。軟件包定義用于組織與您的軟件相關(guān)聯(lián)的代碼和資源的基本結(jié)構(gòu)。這種結(jié)構(gòu)的存在也有助于促進諸如本地化之類的重要特征。 bundle的確切結(jié)構(gòu)取決于您是創(chuàng)建應(yīng)用程序，框架還是插件。它還取決于其他因素，如目標(biāo)平臺和插件的類型。

捆綁包和包有時被認(rèn)為是可互換的原因是許多類型的包也是包。例如，應(yīng)用程序和可加載的軟件包是軟件包，因為它們通常被系統(tǒng)視為不透明目錄。但是并不是所有的bundle都是包，反之亦然。

系統(tǒng)如何識別捆綁包和包

如果滿足以下任一條件，則Finder將目錄作為包：

該目錄有一個已知的文件擴展名：.app，.bundle，.framework，.plugin，.kext等。
該目錄具有一些其他應(yīng)用程序聲明代表包類型的擴展名;請參閱文檔包。
該目錄的包的位設(shè)置。
指定包的首選方法是給包目錄一個已知的文件擴展名。在大多數(shù)情況下，Xcode通過提供適用正確擴展名的模板來為您提供幫助。所有你需要做的是創(chuàng)建一個適合類型的Xcode項目。

大多數(shù)捆綁包也是包。例如，應(yīng)用程序和插件通常由Finder顯示為單個文件。但是，對于所有捆綁類型都不是這樣。特別地，框架是一種捆綁，它被視為單個單元，用于鏈接和運行時使用，但框架目錄是透明的，以便開發(fā)人員可以查看頭文件及其包含的其他資源。

關(guān)于Bundle顯示名稱

顯示名稱給用戶一些控制包和包在Finder中的顯示，而不會破壞依賴它們的客戶端。而用戶可以自由重命名文件，重命名應(yīng)用程序或框架可能導(dǎo)致相關(guān)代碼模塊通過名稱引用應(yīng)用程序或框架中斷。因此，當(dāng)用戶更改包的名稱時，更改只是表面的。 Finder不是在文件系統(tǒng)中更改包名稱，而是將一個單獨的字符串（稱為顯示名稱）與捆綁包相關(guān)聯(lián)，并顯示該字符串。

顯示名稱僅供用戶使用。您永遠(yuǎn)不會使用顯示名稱來打開或訪問代碼中的目錄，但是在向用戶顯示目錄的名稱時，請使用它們。默認(rèn)情況下，捆綁包的顯示名稱與捆綁包名稱本身相同。但是，在以下情況下，系統(tǒng)可能會更改默認(rèn)顯示名稱：

如果捆綁包是應(yīng)用程序，則Finder在大多數(shù)情況下隱藏.app擴展名。
如果軟件包支持本地化顯示名稱（并且用戶尚未明確更改軟件包名稱），則Finder將顯示與用戶當(dāng)前語言設(shè)置相匹配的名稱。
盡管Finder大部分時間都會為應(yīng)用程序隱藏.app擴展名，但它可能會顯示它以防止混淆。例如，如果用戶更改應(yīng)用程序的名稱，并且新名稱包含另一個文件擴展名，則Finder將顯示.app。擴展，以清楚該捆綁是一個應(yīng)用程序。例如，如果要將.mov擴展名添加到Chess應(yīng)用程序，F(xiàn)inder將顯示Chess.mov.app以防止用戶考慮Chess.mov是QuickTime文件。

有關(guān)顯示名稱和指定本地化捆綁包名稱的詳細(xì)信息，請參閱文件系統(tǒng)概述。

捆綁的優(yōu)點

軟件包為開發(fā)人員提供以下優(yōu)勢：

因為bundle是文件系統(tǒng)中的目錄層次結(jié)構(gòu)，所以bundle只包含文件。因此，您可以使用所有相同的基于文件的界面打開包資源，以便打開其他類型的文件。
捆綁包目錄結(jié)構(gòu)可以輕松支持多個本地化。您可以輕松添加新的本地化資源或刪除不需要的資源。

軟件包可以駐留在許多不同格式的卷上，包括諸如HFS，HFS +和AFP之類的多種叉格式，以及UFS，SMB和NFS等單叉格式。
用戶可以通過在Finder中拖動它們來安裝，重新定位和刪除軟件包。
捆綁包也是包，因此被視為不透明文件，不太容易受到意外的用戶修改，例如關(guān)鍵資源的刪除，修改或重命名。
捆綁可以支持多種芯片架構(gòu)（PowerPC，Intel）和不同的地址空間要求（32位/ 64位）。它還可以支持包含專門的可執(zhí)行文件（例如，針對特定向量指令集優(yōu)化的庫）。
大多數(shù)（但不是全部）可執(zhí)行代碼可以捆綁。應(yīng)用程序，框架（共享庫）和插件都支持捆綁包模型。靜態(tài)庫，動態(tài)庫，shell腳本和UNIX命令行工具不使用bundle結(jié)構(gòu)。
捆綁的應(yīng)用程序可以直接從服務(wù)器運行。不需要在本地系統(tǒng)上安裝特殊的共享庫，擴展和資源。

捆綁類型

雖然所有捆綁包都支持相同的基本功能，但是您可以定義和創(chuàng)建定義其預(yù)期用途的捆綁包的方式有所不同：

應(yīng)用程序 - 應(yīng)用程序包管理與可啟動進程關(guān)聯(lián)的代碼和資源。該捆綁的確切結(jié)構(gòu)取決于您定位的平臺（iOS或MacOS）。有關(guān)應(yīng)用程序包的結(jié)構(gòu)的信息，請參閱應(yīng)用程序包。
框架 - 框架包管理動態(tài)共享庫及其相關(guān)資源，如頭文件。應(yīng)用程序可以鏈接一個或多個框架，以利用它們包含的代碼。有關(guān)框架包的結(jié)構(gòu)的信息，請參閱框架包的解剖。
插件 - macOS支持許多系統(tǒng)功能的插件。插件是一種應(yīng)用程序動態(tài)加載自定義代碼模塊的方法。以下列表列出了您可能想要開發(fā)的插件的一些關(guān)鍵類型：
自定義插件是為您自己定義的插件;請參閱可卸載捆綁的解剖。
Image Unit插件為Core Image技術(shù)添加了自定義的圖像處理行為;請參閱圖像單元教程。
Interface Builder插件包含要與Interface Builder的庫窗口集成的自定義對象。
首選項窗格插件定義要集成到“系統(tǒng)偏好設(shè)置”應(yīng)用程序中的自定義首選項;請參閱“優(yōu)先窗格編程指南”。
Quartz Composer插件定義了Quartz Composer應(yīng)用程序的自定義修補程序;請參閱Quartz Composer自定義修補程序編程指南。
Quick Look插件支持使用Quick Look顯示自定義文檔類型;請參閱快速編程指南。
Spotlight插件支持自定義文檔類型的索引，以便用戶可以搜索這些文檔;請參閱Spotlight導(dǎo)入器編程指南。
WebKit插件擴展了通用Web瀏覽器支持的內(nèi)容類型。
窗口小部件將新的基于HTML的應(yīng)用程序添加到儀表板。
雖然文檔格式可以利用捆綁結(jié)構(gòu)來組織其內(nèi)容，但文檔通常不被認(rèn)為是最純粹的捆綁包。實現(xiàn)為目錄并被視為不透明類型的文檔被認(rèn)為是文檔包，而不管其內(nèi)部格式如何。有關(guān)文檔包的詳細(xì)信息，請參閱文檔包。

創(chuàng)建捆綁包

在大多數(shù)情況下，您不會手動創(chuàng)建軟件包或軟件包。當(dāng)您創(chuàng)建新的Xcode項目（或向現(xiàn)有項目添加目標(biāo)）時，Xcode會在需要時自動創(chuàng)建所需的bundle結(jié)構(gòu)。例如，應(yīng)用程序，框架和可加載bundle目標(biāo)都具有關(guān)聯(lián)的bundle結(jié)構(gòu)。當(dāng)您構(gòu)建任何這些目標(biāo)時，Xcode會為您自動創(chuàng)建相應(yīng)的軟件包。

注意：某些Xcode目標(biāo)（例如shell工具和靜態(tài)庫）不會導(dǎo)致創(chuàng)建捆綁包或包。這是正常的，不需要為這些目標(biāo)類型專門創(chuàng)建軟件包。為這些目標(biāo)生成的生成的二進制文件旨在按原樣使用。
如果您使用make文件（而不是Xcode）來構(gòu)建項目，那么創(chuàng)建bundle并不奇怪。捆綁包只是文件系統(tǒng)中具有明確定義結(jié)構(gòu)的目錄，并將特定文件擴展名添加到捆綁包目錄名稱的末尾。只要您創(chuàng)建頂級捆綁包目錄并適當(dāng)?shù)貥?gòu)建您的捆綁包的內(nèi)容，就可以使用編程支持訪問這些內(nèi)容來訪問捆綁包。有關(guān)如何組織捆綁包目錄的更多信息，請參閱捆綁結(jié)構(gòu)。

程序化支持訪問捆綁包

引用捆綁包或本身捆綁的程序可以利用Cocoa和Core Foundation中的接口訪問捆綁包的內(nèi)容。使用這些接口，您可以找到捆綁資源，獲取有關(guān)捆綁包配置的信息，并加載可執(zhí)行代碼。在Objective-C應(yīng)用程序中，您可以使用NSBundle類來獲取和管理包信息。對于基于C的應(yīng)用程序，可以使用與CFBundleRef opaque類型相關(guān)聯(lián)的函數(shù)來管理捆綁包。

注意：與許多其他Core Foundation和Cocoa類型不同，NSBundle和CFBundleRef不是自由的橋接數(shù)據(jù)類型，不能互換使用。但是，您可以從任一對象中提取捆綁路徑信息，并使用它來創(chuàng)建另一個對象。
有關(guān)如何使用Cocoa和Core Foundation中的程序化支持訪問軟件包的信息，請參閱訪問軟件包的內(nèi)容。

使用捆綁包的指南

軟件包是MacOS和iOS軟件的首選組織機制。捆綁結(jié)構(gòu)允許您將可執(zhí)行代碼和資源分組在一個地方并以有組織的方式支持該代碼。以下指南提供了有關(guān)如何使用軟件包的一些額外建議：

始終在您的包中包含信息屬性列表（Info.plist）文件。確保包含推薦使用的捆綁類型的密鑰。有關(guān)可以包含在此文件中的所有密鑰的列表，請參閱運行時配置指南。
如果應(yīng)用程序無法在沒有特定資源文件的情況下運行，請將該文件包含在應(yīng)用程序包中。應(yīng)用程序應(yīng)始終包含他們需要操作的所有圖像，字符串文件，本地化資源和插件。非關(guān)鍵資源應(yīng)盡可能類似地存儲在應(yīng)用程序包中，但如果需要，可以將其放在bundle外部。有關(guān)應(yīng)用程序捆綁結(jié)構(gòu)的更多信息，請參閱應(yīng)用程序包。
如果您計劃從捆綁包中加載C ++代碼，則可能需要將計劃加載的符號標(biāo)記為extern“C”。 NSBundle和Core Foundation CFBundleRef函數(shù)都不知道C ++名稱的修改約定，所以以這種方式標(biāo)記您的符號可以使以后更容易識別它們。
您不能使用NSBundle類來加載代碼片段管理器（CFM）代碼。如果需要加載基于CFM的代碼，則必須使用CFBundleRef或CFPlugInRef不透明類型的函數(shù)。您可以使用這種技術(shù)從Mach-O可執(zhí)行文件加載基于CFM的插件。
您應(yīng)該始終使用NSBundle類（與CFBundleRef opaque類型相關(guān)聯(lián)的函數(shù)）來加載包含Java代碼的任何包。
在加載包含Objective-C代碼的捆綁包時，您可以在macOS v10.5及更高版本中使用NSBundle類或與CFBundleRef opaque類型相關(guān)聯(lián)的函數(shù)，但每種類型的行為都有差異。如果您使用Core Foundation函數(shù)來加載插件或其他可加載的bundle（而不是框架或動態(tài)共享庫），那么這些函數(shù)將私有加載并立即綁定它的符號;如果您使用NSBundle，則該捆綁包將在全局加載，其符號將被懶惰綁定。另外，使用NSBundle類加載的bundle會導(dǎo)致生成NSBundleDidLoadNotification通知，而使用Core Foundation函數(shù)加載的bundle不會生成。

捆綁結(jié)構(gòu)

捆綁結(jié)構(gòu)可以根據(jù)捆綁類型和目標(biāo)平臺而有所不同。以下部分描述了macOS和iOS中最常用的捆綁結(jié)構(gòu)。

注意：雖然捆綁是一種打包可執(zhí)行代碼的方法，但它們不是唯一支持的方法。 UNIX shell腳本和命令行工具不使用bundle結(jié)構(gòu)，也不使用靜態(tài)和動態(tài)共享庫。

應(yīng)用程序包

應(yīng)用程序包是開發(fā)人員創(chuàng)建的最常見的捆綁類型之一。應(yīng)用程序包存儲應(yīng)用程序成功運行所需的所有內(nèi)容。雖然應(yīng)用程序包的特定結(jié)構(gòu)取決于您正在開發(fā)的平臺，但在兩個平臺上使用捆綁包的方式都相同。本章介紹了iOS和MacOS中應(yīng)用程序包的結(jié)構(gòu)。

什么文件進入應(yīng)用程序包？

表2-1總結(jié)了您可能在應(yīng)用程序包中找到的文件類型。這些文件的確切位置因平臺而異，一些資源根本不受支持。有關(guān)示例和更詳細(xì)的信息，請參閱本章中特定于平臺的軟件包部分。

表2-1應(yīng)用程序包中的文件類型
文件
描述
Info.plist文件
（必需）信息屬性列表文件是包含應(yīng)用程序配置信息的結(jié)構(gòu)化文件。系統(tǒng)依賴于此文件的存在來識別有關(guān)您的應(yīng)用程序和任何相關(guān)文件的相關(guān)信息。
可執(zhí)行文件
（必需）每個應(yīng)用程序必須具有可執(zhí)行文件。該文件包含應(yīng)用程序的主入口點和靜態(tài)鏈接到應(yīng)用程序目標(biāo)的任何代碼。
資源文件
資源是存在于應(yīng)用程序的可執(zhí)行文件之外的數(shù)據(jù)文件。資源通常由圖像，圖標(biāo)，聲音，nib文件，字符串文件，配置文件和數(shù)據(jù)文件（等）組成。大多數(shù)資源文件可以針對特定語言或區(qū)域進行本地化，也可以由所有本地化共享。
資源文件在捆綁包目錄結(jié)構(gòu)中的放置取決于您是開發(fā)iOS或Mac應(yīng)用程序。

其他支持文件

Mac應(yīng)用程序可以嵌入其他高級資源，如私有框架，插件，文檔模板以及其他自定義數(shù)據(jù)資源，這些資源是應(yīng)用程序的一部分。盡管您可以在iOS應(yīng)用程序包中包含自定義數(shù)據(jù)資源，但不能包括自定義框架或插件。
雖然應(yīng)用程序包中的大部分資源是可選的，但并不總是如此。例如，iOS應(yīng)用程序通常需要額外的圖像資源來應(yīng)用程序的圖標(biāo)和默認(rèn)屏幕。盡管未明確要求，但大多數(shù)Mac應(yīng)用程序都包含一個自定義圖標(biāo)，而不是系統(tǒng)提供的默認(rèn)圖標(biāo)。

iOS應(yīng)用程序包的解剖

Xcode提供的項目模板可以為您的iPhone或iPad應(yīng)用程序設(shè)置捆綁包所需的大部分工作。但是，了解捆綁結(jié)構(gòu)可以幫助您確定應(yīng)該放置自己的自定義文件的位置。 iOS應(yīng)用程序的捆綁結(jié)構(gòu)更符合移動設(shè)備的需求。它使用相對平坦的結(jié)構(gòu)，幾乎沒有外部目錄，以節(jié)省磁盤空間并簡化對文件的訪問。

iOS應(yīng)用程序捆綁結(jié)構(gòu)

典型的iOS應(yīng)用程序包包含應(yīng)用程序可執(zhí)行文件和應(yīng)用程序使用的任何資源（例如，應(yīng)用程序圖標(biāo)，其他映像和本地化內(nèi)容）在頂級捆綁包目錄中。 清單2-1顯示了一個名為MyApp的簡單iPhone應(yīng)用程序的結(jié)構(gòu)。 子目錄中唯一需要進行本地化的文件; 但是，您可以在自己的應(yīng)用程序中創(chuàng)建其他子目錄來組織資源和其他相關(guān)文件。

清單2-1 iOS應(yīng)用程序的捆綁結(jié)構(gòu)

MyApp.app
   MyApp
   MyAppIcon.png
   MySearchIcon.png
   Info.plist
   Default.png
   MainWindow.nib
   Settings.bundle
   MySettingsIcon.png
   iTunesArtwork
   en.lproj
      MyImage.png
   fr.lproj
      MyImage.png

表2-2所示的應(yīng)用程序的內(nèi)容如表2-2所示。 雖然應(yīng)用程序本身僅用于演示目的，但其中包含的許多文件代表了iOS在掃描應(yīng)用程序包時查找的特定文件。 您自己的軟件包將包含部分或全部這些文件，具體取決于您支持的功能。

表2-2典型的iOS應(yīng)用程序包的內(nèi)容

文件
描述
MyApp
（必需）包含應(yīng)用程序代碼的可執(zhí)行文件。該文件的名稱與您的應(yīng)用程序名稱相同。減去.app擴展名。
應(yīng)用程序圖標(biāo)（MyAppIcon.png，MySearchIcon.png和MySettingsIcon.png）
（必需/推薦）應(yīng)用程序圖標(biāo)在特定時間用于表示應(yīng)用程序。例如，不同大小的應(yīng)用程序圖標(biāo)將顯示在主屏幕，搜索結(jié)果和設(shè)置應(yīng)用程序中。并不是所有的圖標(biāo)都是必需的，但大多數(shù)都是推薦的。有關(guān)應(yīng)用程序圖標(biāo)的信息，請參閱應(yīng)用程序圖標(biāo)和啟動映像。
Info.plist
（必需）此文件包含應(yīng)用程序的配置信息，例如其包ID，版本號和顯示名稱。有關(guān)詳細(xì)信息，請參閱信息屬性列表文件。
啟動圖像（Default.png）
（推薦）一個或多個圖像，以特定方向顯示應(yīng)用程序的初始界面。系統(tǒng)使用所提供的啟動映像之一作為臨時背景，直到您的應(yīng)用程序加載其窗口和用戶界面。如果您的應(yīng)用程序不提供任何啟動映像，則應(yīng)用程序啟動時將顯示黑色背景。有關(guān)應(yīng)用程序圖標(biāo)的信息，請參閱應(yīng)用程序圖標(biāo)和啟動映像。
MainWindow.nib
（推薦）應(yīng)用程序的主要nib文件包含在應(yīng)用程序啟動時加載的默認(rèn)界面對象。通常，此nib文件包含應(yīng)用程序的主窗口對象和應(yīng)用程序委托對象的實例。然后，其他接口對象將從其他nib文件加載或由應(yīng)用程序以編程方式創(chuàng)建。 （可以通過向Info.plist文件中的NSMainNibFile鍵分配不同的值來更改主nib文件的名稱。有關(guān)詳細(xì)信息，請參閱信息屬性列表文件。）
Settings.bundle
“設(shè)置”包是一種特殊類型的插件，其中包含要添加到“設(shè)置”應(yīng)用程序的任何特定于應(yīng)用程序的首選項。此軟件包包含屬性列表和其他資源文件，以配置和顯示您的首選項。
自定義資源文件
非本地化資源放置在頂級目錄中，本地化資源放置在應(yīng)用程序包的特定語言的子目錄中。資源包括nib文件，圖像，聲音文件，配置文件，字符串文件以及您的應(yīng)用程序所需的任何其他自定義數(shù)據(jù)文件。有關(guān)資源的更多信息，請參閱iOS應(yīng)用程序中的資源。
注意：iOS應(yīng)用程序包不能包含名為“資源”的自定義文件夾。
iOS應(yīng)用程序應(yīng)該國際化，并為其支持的每種語言提供一個language.lproj文件夾。除了提供應(yīng)用程序的自定義資源的本地化版本之外，還可以通過在特定于語言的項目目錄中放置具有相同名稱的文件來本地化啟動映像。但是，即使您提供本地化版本，應(yīng)始終在應(yīng)用程序包的頂層包含這些文件的默認(rèn)版本。默認(rèn)版本用于特定本地化不可用的情況。有關(guān)本地化資源的更多信息，請參閱捆綁包中的本地化資源。

信息屬性列表文件

每個iOS應(yīng)用程序必須具有包含應(yīng)用程序配置信息的信息屬性列表（Info.plist）文件。當(dāng)您創(chuàng)建一個新的iOS應(yīng)用程序項目時，Xcode會自動創(chuàng)建此文件，并為您設(shè)置某些關(guān)鍵屬性的值。表2-3列出了您應(yīng)該明確設(shè)置的其他一些鍵。 （Xcode在默認(rèn)情況下遮蓋實際的鍵名稱，所以Xcode顯示的字符串也列在括號中，可以通過在編輯器中單擊信息屬性列表鍵并選擇顯示來查看所有鍵的真實密鑰名稱來自上下文菜單中的原始鍵/值。）

表2-3 Info.plist文件所需的密鑰

鍵
值
CFBundleDisplayName（Bundle顯示名稱）
捆綁顯示名稱是顯示在應(yīng)用程序圖標(biāo)下面的名稱。對于所有支持的語言，此值應(yīng)本地化。
CFBundleIdentifier（Bundle標(biāo)識符）
捆綁標(biāo)識符字符串將您的應(yīng)用程序標(biāo)識到系統(tǒng)。此字符串必須是僅包含字母數(shù)字（A-Z，a-z，0-9），連字符（ - ）和句點（。）字符的統(tǒng)一類型標(biāo)識符（UTI）。字符串也應(yīng)該是反向DNS格式。例如，如果您的公司的域名是Ajax.com，并且您創(chuàng)建一個名為Hello的應(yīng)用程序，則可以將com.Ajax.Hello字符串分配為應(yīng)用程序的包標(biāo)識符。
捆綁標(biāo)識符用于驗證應(yīng)用簽名。
CFBundleVersion（Bundle版）
bundle版本字符串指定包的版本號。該值是單調(diào)增加的字符串，由一個或多個周期分隔的整數(shù)組成。此值無法本地化。
CFBundleIconFiles
包含用于應(yīng)用程序各種圖標(biāo)的圖像的文件名的字符串?dāng)?shù)組。雖然在技術(shù)上不需要，但強烈建議您使用它。
iOS 3.2及更高版本支持此鍵。
LSRequiresIPhoneOS（應(yīng)用程序需要iOS環(huán)境）
一個布爾值，指示捆綁只能在iOS上運行。 Xcode自動添加此鍵并將其值設(shè)置為true。您不應(yīng)該更改此鍵的值。
UIRequiredDeviceCapabilities
告訴iTunes和App Store的一個關(guān)鍵知道應(yīng)用程序需要運行哪些設(shè)備相關(guān)功能。 iTunes和移動App Store使用此列表來阻止客戶在不支持列出的功能的設(shè)備上安裝應(yīng)用程序。
該鍵的值是數(shù)組或字典。如果使用陣列，則給定鍵的存在表示需要相應(yīng)的功能。如果您使用字典，則必須為每個鍵指定布爾值，以指示該功能是否必需。在這兩種情況下，不包括鍵表示不需要該功能。
有關(guān)要包含在字典中的鍵的列表，請參閱信息屬性列表鍵參考。 iOS 3.0及更高版本支持此鍵。
除了上表中的鍵之外，表2-4列出了iOS應(yīng)用程序通常使用的一些鍵。雖然這些鍵不是必需的，但大多數(shù)提供了一種在啟動時調(diào)整應(yīng)用程序配置的方法。提供這些密鑰可以幫助確保系統(tǒng)適當(dāng)?shù)爻尸F(xiàn)您的應(yīng)用程序。

表2-4 Info.plist文件中通常包含的鍵

帕拉
帕拉
NSMainNibFile（主要nib文件名）
標(biāo)識應(yīng)用程序主nib文件名稱的字符串。如果要使用除為項目創(chuàng)建的默認(rèn)文件之外的nib文件，請將該nib文件的名稱與此鍵相關(guān)聯(lián)。 nib文件的名稱不應(yīng)包含.nib文件擴展名。
UIStatusBarStyle
一個字符串，用于標(biāo)識應(yīng)用程序啟動時狀態(tài)欄的樣式。該值基于在UIApplication.h頭文件中聲明的UIStatusBarStyle常量。默認(rèn)樣式為UIStatusBarStyleDefault。應(yīng)用程序可以在完成啟動時更改此初始狀態(tài)欄樣式。
如果不指定此鍵，則iOS會顯示默認(rèn)狀態(tài)欄。
UIStatusBarHidden
一個布爾值，用于確定應(yīng)用程序啟動時狀態(tài)欄是否最初被隱藏。將其設(shè)置為true以隱藏狀態(tài)欄。默認(rèn)值為false。
UIInterfaceOrientation
標(biāo)識應(yīng)用程序用戶界面初始方向的字符串。該值基于在UIApplication.h頭文件中聲明的UIInterfaceOrientation常量。默認(rèn)樣式為UIInterfaceOrientationPortrait。
UIPrerenderedIcon
一個布爾值，指示應(yīng)用程序圖標(biāo)是否已經(jīng)包含光澤和斜角效果。默認(rèn)值為false。如果您不希望系統(tǒng)將這些效果添加到您的作品中，請將其設(shè)置為true。
UIRequiresPersistentWiFi
一個布爾值，通知系統(tǒng)應(yīng)用程序使用Wi-Fi網(wǎng)絡(luò)進行通信。在任何時候使用Wi-Fi的應(yīng)用程序都必須將此鍵設(shè)置為true;否則，30分鐘后，設(shè)備將關(guān)閉Wi-Fi連接以節(jié)省電量。設(shè)置此標(biāo)志還允許系統(tǒng)知道當(dāng)Wi-Fi可用但當(dāng)前未被使用時，它應(yīng)顯示網(wǎng)絡(luò)選擇對話框。默認(rèn)值為false。
即使此屬性的值為true，當(dāng)該設(shè)備空閑（即屏幕鎖定）時，此密鑰也不起作用。在此期間，應(yīng)用程序被視為無效，盡管它可能在某種程度上起作用，但沒有Wi-Fi連接。
UILaunchImageFile
包含應(yīng)用程序啟動映像使用的基本文件的字符串。如果不指定此鍵，則基本名稱被假定為字符串Default。
應(yīng)用程序圖標(biāo)和啟動映像

應(yīng)用程序圖標(biāo)和啟動映像是必須存在于每個應(yīng)用程序中的標(biāo)準(zhǔn)圖形。每個應(yīng)用程序必須指定要在設(shè)備的主屏幕和App Store中顯示的圖標(biāo)。并且應(yīng)用程序可以指定用于不同情況的幾個不同的圖標(biāo)。例如，應(yīng)用程序可以提供在顯示搜索結(jié)果時使用的應(yīng)用程序圖標(biāo)的小版本。啟動圖像向用戶提供應(yīng)用程序啟動的視覺反饋。

用于表示圖標(biāo)和啟動圖像的圖像文件必須都位于捆綁包的根級別中。如何將這些映像標(biāo)識到系統(tǒng)可能會有所不同，但是建議的方法來指定應(yīng)用程序圖標(biāo)是使用CFBundleIconFiles鍵。有關(guān)如何在應(yīng)用程序中指定圖標(biāo)和啟動圖像的詳細(xì)信息，請參閱iOS應(yīng)用程序編程指南中的高級應(yīng)用技巧中的這些項目的討論。

注意：除了捆綁軟件頂層的圖標(biāo)和啟動映像之外，還可以在應(yīng)用程序的語言特定項目子目錄中包含啟動映像的本地化版本。有關(guān)在應(yīng)用程序中包含本地化資源的更多信息，請參閱捆綁包中的本地化資源。

iOS應(yīng)用程序中的資源

在iOS應(yīng)用程序中，非本地化資源位于捆綁包目錄的頂層，以及應(yīng)用程序的可執(zhí)行文件和Info.plist文件。大多數(shù)iOS應(yīng)用程序在此級別至少有幾個文件，包括應(yīng)用程序的圖標(biāo)，啟動映像和一個或多個nib文件。盡管您應(yīng)該將大多數(shù)非本地化資源放在此頂級目錄中，但您也可以創(chuàng)建子目錄來組織資源文件。本地化資源必須放置在一個或多個特定于語言的子目錄中，這些子目錄在捆綁軟件的本地化資源中有更詳細(xì)的討論。

清單2-2顯示了一個包含本地化和非本地化資源的虛構(gòu)應(yīng)用程序。非本地化資源包括Hand.png，MainWindow.nib，MyAppViewController.nib以及WaterSounds目錄的內(nèi)容。本地化資源包括en.lproj和jp.lproj目錄中的所有內(nèi)容。

清單2-2具有本地化和非本地化資源的iOS應(yīng)用程序

MyApp.app/
   Info.plist
   MyApp
   Default.png
   Icon.png
   Hand.png
   MainWindow.nib
   MyAppViewController.nib
   WaterSounds/
      Water1.aiff
      Water2.aiff
   en.lproj/
      CustomView.nib
      bird.png
      Bye.txt
      Localizable.strings
   jp.lproj/
      CustomView.nib
      bird.png
      Bye.txt
      Localizable.strings

有關(guān)在應(yīng)用程序包中查找資源文件的信息，請參閱訪問軟件包的內(nèi)容。有關(guān)如何加載資源文件并在程序中使用它們的信息，請參閱資源編程指南。

macOS應(yīng)用程序包解剖

Xcode提供的項目模板可以在開發(fā)過程中設(shè)置Mac應(yīng)用程序包所需的大部分工作。但是，了解捆綁結(jié)構(gòu)可以幫助您確定應(yīng)該放置自己的自定義文件的位置。 macOS軟件包使用高度有組織的結(jié)構(gòu)，使捆綁加載代碼更容易查找軟件包中的資源和其他重要文件。層次性還有助于系統(tǒng)將代碼捆綁包（例如應(yīng)用程序與其他應(yīng)用程序使用的目錄包）區(qū)分開來實現(xiàn)文檔類型。

macOS應(yīng)用程序包的結(jié)構(gòu)

Mac應(yīng)用程序包的基本結(jié)構(gòu)非常簡單。在bundle的頂層是一個名為Contents的目錄。此目錄包含應(yīng)用程序所需的所有資源，包括資源，可執(zhí)行代碼，私有框架，私有插件和支持文件。雖然Contents目錄可能看起來很多，但它將該捆綁包標(biāo)識為現(xiàn)代風(fēng)格的捆綁包，并將其與早期版本的Mac OS中發(fā)現(xiàn)的文檔和舊版捆綁類型分離。

清單2-3顯示了典型應(yīng)用程序包的高級結(jié)構(gòu)，包括您最可能在Contents目錄中找到的立即文件和目錄。這個結(jié)構(gòu)代表每個Mac應(yīng)用程序的核心。

清單2-3 Mac應(yīng)用程序的基本結(jié)構(gòu)

MyApp.app/
   Contents/
      Info.plist
      MacOS/
      Resources/

表2-5列出了您可能在Contents目錄中找到的一些目錄，以及每個目錄的目的。該列表并不詳盡，但僅代表常用的目錄。

表2-5目錄目錄的子目錄
目錄
描述
MacOS
（必需）包含應(yīng)用程序的獨立可執(zhí)行代碼。通常，此目錄僅包含一個二進制文件，其中包含應(yīng)用程序的主入口點和靜態(tài)鏈接代碼。但是，您也可以將其他獨立的可執(zhí)行文件（如命令行工具）放在此目錄中。
資源
包含所有應(yīng)用程序的資源文件。此目錄的內(nèi)容進一步組織起來以區(qū)分本地化和非本地化資源。有關(guān)此目錄的結(jié)構(gòu)的更多信息，請參閱資源目錄
構(gòu)架
包含可執(zhí)行文件使用的任何私有共享庫和框架。該目錄中的框架是針對應(yīng)用程序進行修訂鎖定的，不能被操作系統(tǒng)可用的任何其他甚至更新的版本所取代。換句話說，包含在該目錄中的框架優(yōu)先于在操作系統(tǒng)的其他部分中發(fā)現(xiàn)的任何其他類似命名的框架。
有關(guān)如何向應(yīng)用程序包添加私有框架的信息，請參閱框架編程指南。
插件
包含可擴展的應(yīng)用程序的基本功能的可加載捆綁包。您可以使用此目錄來包含必須加載到應(yīng)用程序進程空間中以便使用的代碼模塊。您不會使用此目錄來存儲獨立的可執(zhí)行文件。
SharedSupport
包含不影響應(yīng)用程序運行能力的其他非關(guān)鍵資源。您可以使用此目錄來包括應(yīng)用程序期望存在的文檔模板，剪貼畫和教程，但不影響應(yīng)用程序運行的能力。
多年來應(yīng)用程序包已經(jīng)發(fā)展很大，但總體目標(biāo)是一樣的。捆綁組織使應(yīng)用程序更容易找到其資源，同時使用戶更難干擾這些資源。由于Finder將大多數(shù)捆綁包視為不透明實體，因此臨時用戶很難移動或刪除應(yīng)用程序可能需要的資源。

信息屬性列表文件

要使Finder能夠識別應(yīng)用程序包，您需要包含一個信息屬性列表（Info.plist）文件。該文件包含XML屬性列表數(shù)據(jù)，用于標(biāo)識捆綁包的配置。對于最小的包，該文件將包含很少的信息，很可能只是包的名稱和標(biāo)識符。對于更復(fù)雜的軟件包，Info.plist文件包含更多信息。

重要提示：使用區(qū)分大小寫的搜索來定位捆綁資源。因此，您的信息屬性列表文件的名稱必須以資本“I”開頭。
表2-6列出了您應(yīng)該始終包含在Info.plist文件中的鍵。 Xcode在創(chuàng)建新項目時自動提供所有這些鍵。 （Xcode在默認(rèn)情況下遮蓋了實際的鍵名稱，所以Xcode顯示的字符串也列在括號中，您可以通過在編輯器中單擊信息屬性列表鍵并選擇顯示原始密鑰/值來查看所有密鑰的真實密鑰名稱從出現(xiàn)的上下文菜單。）

表2-6 Info.plist文件中的預(yù)期密鑰
鍵
描述
CFBundleName（Bundle name）
捆綁的短名稱。該鍵的值通常是應(yīng)用程序的名稱。創(chuàng)建新項目時，Xcode默認(rèn)設(shè)置此鍵的值。
CFBundleDisplayName（Bundle顯示名稱）
應(yīng)用程序名稱的本地化版本。您通常在InfoPlist.strings每個語言特定資源目錄中的文件中包含此密鑰的本地化值。
CFBundleIdentifier（Bundle標(biāo)識符）
將應(yīng)用程序標(biāo)識到系統(tǒng)的字符串。此字符串必須是僅包含字母數(shù)字（A-Z，a-z，0-9），連字符（ - ）和句點（。）字符的統(tǒng)一類型標(biāo)識符（UTI）。字符串也應(yīng)該是反向DNS格式。例如，如果您的公司的域名是Ajax.com，并且您創(chuàng)建一個名為Hello的應(yīng)用程序，則可以將com.Ajax.Hello字符串分配為應(yīng)用程序的包標(biāo)識符。
捆綁標(biāo)識符用于驗證應(yīng)用簽名。
CFBundleVersion（Bundle版）
指定包的版本號的字符串。該值是單調(diào)增加的字符串，由一個或多個周期分隔的整數(shù)組成。該值可以對應(yīng)于應(yīng)用程序的已發(fā)布版本或未發(fā)行版本。此值無法本地化。
CFBundlePackageType（Bundle OS類型代碼）
這是捆綁的類型。對于應(yīng)用程序，此鍵的值始終為四個字符的字符串APPL。
CFBundleSignature（Bundle創(chuàng)建者操作系統(tǒng)類型代碼）
捆綁的創(chuàng)建者代碼。這是一個特定于包的四個字符的字符串。例如，TextEdit應(yīng)用程序的簽名是ttxt。
CFBundleExecutable（可執(zhí)行文件）
主要可執(zhí)行文件的名稱。這是用戶啟動應(yīng)用程序時執(zhí)行的代碼。 Xcode通常在構(gòu)建時自動設(shè)置此鍵的值。
表2-7列出了您在Info.plist文件中應(yīng)該考慮的鍵。

表2-7 Info.plist文件的推薦鍵
鍵
描述
CFBundleDocumentTypes（文檔類型）
應(yīng)用程序支持的文檔類型。這種類型由一系列字典組成，每個字典提供有關(guān)特定文檔類型的信息。
CFBundleShortVersionString（Bundle version string，short）
發(fā)布版本的應(yīng)用程序。該鍵的值是由三個周期分隔的整數(shù)組成的字符串。
LSMinimumSystemVersion（最小系統(tǒng)版本）
運行該應(yīng)用程序所需的最小版本的macOS。該鍵的值為n.n.n形式的字符串，其中每個n是表示所需的macOS的主版本號或次版本號的數(shù)字。例如，值10.1.5將代表macOS v10.1.5。
NSHumanReadableCopyright（版權(quán)（可讀））
申請的版權(quán)聲明。這是一個可讀的字符串，可以通過將密鑰包含在特定于語言的項目目錄中的InfoPlist.strings文件中進行本地化。
NSMainNibFile（主要nib文件名）
啟動應(yīng)用程序時加載的nib文件（不帶.nib文件擴展名）。主要的nib文件是一個Interface Builder存檔，包含啟動時所需的對象（主窗口，應(yīng)用程序委托等）。
NSPrincipalClass（Principal類）
動態(tài)加載的Objective-C代碼的入口點。對于應(yīng)用程序包，這幾乎總是NSApplication類或自定義子類。
您放入Info.plist文件的確切信息取決于您的軟件包的需求，并可根據(jù)需要進行本地化。有關(guān)此文件的更多信息，請參閱運行時配置指南。

資源目錄

資源目錄是您放置所有圖像，聲音，nib文件，字符串資源，圖標(biāo)文件，數(shù)據(jù)文件和配置文件的位置。此目錄的內(nèi)容進一步細(xì)分為您可以存儲本地化和非本地化資源文件的區(qū)域。非本地化資源駐留在Resources目錄本身的頂層或您定義的自定義子目錄中。本地化資源駐留在稱為特定于語言的項目目錄的單獨子目錄中，這些目錄被命名為與特定本地化一致。

查看資源目錄的最佳方式是查看一個例子。清單2-4顯示了一個包含本地化和非本地化資源的虛構(gòu)應(yīng)用程序。非本地化資源包括Hand.tiff，MyApp.icns和WaterSounds目錄的內(nèi)容。本地化資源包括en.lproj和jp.lproj目錄或其子目錄中的所有內(nèi)容。

清單2-4具有本地化和非本地化資源的Mac應(yīng)用程序

MyApp.app/
   Contents/
      Info.plist
      MacOS/
         MyApp
      Resources/
         Hand.tiff
         MyApp.icns
         WaterSounds/
            Water1.aiff
            Water2.aiff
         en.lproj/
            MyApp.nib
            bird.tiff
            Bye.txt
            InfoPlist.strings
            Localizable.strings
            CitySounds/
               city1.aiff
               city2.aiff
         jp.lproj/
            MyApp.nib
            bird.tiff
            Bye.txt
            InfoPlist.strings
            Localizable.strings
            CitySounds/
               city1.aiff
               city2.aiff

您的每個語言特定的項目目錄都應(yīng)包含相同資源文件集的副本，并且所有本地化文件的任何單個資源文件的名稱必須相同。換句話說，只有給定文件的內(nèi)容才能從一個本地化到另一個本地化。當(dāng)您在代碼中請求資源文件時，只能指定所需文件的名稱。捆綁加載代碼使用用戶的當(dāng)前語言偏好來確定要搜索所請求的文件的目錄。

有關(guān)在應(yīng)用程序包中查找資源文件的信息，請參閱訪問軟件包的內(nèi)容。有關(guān)如何加載資源文件并在程序中使用它們的信息，請參閱資源編程指南。

應(yīng)用程序圖標(biāo)文件

您的頂級Resources目錄中的一個特殊資源是您的應(yīng)用程序圖標(biāo)文件。按照慣例，此文件采用包的名稱和.icns的擴展名;圖像格式可以是任何支持的類型，但如果沒有指定擴展名，則系統(tǒng)假定為.icns。

本地化信息屬性列表

因為應(yīng)用程序的Info.plist文件中的某些鍵包含用戶可見的字符串，所以macOS提供了一種用于指定這些字符串的本地化版本的機制。在每個特定于語言的項目目錄中，您可以包括一個指定適當(dāng)本地化的InfoPlist.strings文件。該文件是一個字符串文件（不是屬性列表），其條目由要本地化的Info.plist鍵和適當(dāng)?shù)姆g組成。例如，在TextEdit應(yīng)用程序中，該文件的德語本地化包含以下字符串：

CFBundleDisplayName = "TextEdit";
NSHumanReadableCopyright = "Copyright ? 1995-2009 Apple Inc.\nAlle Rechte vorbehalten.";

創(chuàng)建應(yīng)用程序包

創(chuàng)建應(yīng)用程序包的最簡單的方法是使用Xcode。所有新的應(yīng)用程序項目都包括一個適當(dāng)配置的應(yīng)用程序目標(biāo)，它定義了構(gòu)建應(yīng)用程序包所需的規(guī)則，包括要編譯哪些源文件，哪些資源文件要復(fù)制到該包中，等等。新項目還包括預(yù)配置的Info.plist文件，通常還有幾個其他文件可以幫助您快速入門。您可以使用項目窗口根據(jù)需要添加任何自定義文件，并使用Info或Inspector窗口配置這些文件。例如，您可以使用“信息”窗口為您的包中的資源文件指定自定義位置。

有關(guān)如何在Xcode中配置目標(biāo)的信息，請參閱Xcode Build System Guide。