讀古今文學網 > iOS編程基礎:Swift、Xcode和Cocoa入門指南 > 第8章 文檔 >

第8章 文檔

知識分為兩類。一類是我們要掌握的學科知識,

另一類是要知道在哪裡可以找到有關知識的信息。

——Samuel Johnson,《Boswell's Life of Johnson》

iOS編程再重要也不如流暢、清晰的文檔重要。Cocoa中有大量的內建類,其中有很多方法、屬性和其他詳細信息。雖然也有一些瑕疵,但Apple的文檔卻是權威的官方指南,因為你無法直接瞭解框架的內部機理,這樣文檔就成為你在使用這個龐大的框架時瞭解其行為的幫手。

安裝在機器上的Xcode文檔劃分為多個文檔集(或庫)。你不能只安裝文檔集;你需要訂閱它,這樣當Apple發佈文檔更新時,你就可以獲得更新後的版本了。

初次安裝Xcode時,文檔集並不會安裝到計算機上;在文檔窗口(8.1節將會介紹)中查看文檔需要聯網,這樣才能查看Apple網站的在線文檔。這種方式很不方便;你需要在自己的計算機上保存一份文檔副本。

因此,安裝後應該立即啟動Xcode,讓其下載並安裝初始文檔集。可以在某種程度上控制並監控這個過程,就在首選項窗口的下載窗格中(位於文檔下);還可以指定是否要自動安裝更新,抑或時不時地手工單擊Check and Install Now。還可以在這裡指定安裝哪些文檔集;我認為iOS 9文檔集與Xcode 7文檔集是你進行iOS開發時所需的全部文檔,不過安裝OS X 10.11文檔集也沒問題。初次安裝文檔集時,你需要提供計算機的管理員密碼。文檔集安裝在主目錄下的Library/Developer/Shared/Documentation/DocSets目錄中。