Start Developing iOS Apps Today系列(十三)

Start Developing iOS Apps Today系列以後續

十3、查找信息

      開發應用程序時,您會但願先前瞭解或不瞭解的信息都隨手可查。其實無需離開 Xcode,您便能得到所需的一切信息。 html

      Xcode 附帶了大量不一樣類型的系列文稿,包括通用指南和概念指南、框架和類參考資料,以及重點幫助文章。訪問此類文稿的方式多種多樣,如按住右鍵點按 Xcode 的各個區域來了解其使用方式、打開主項目窗口中的「Quick Help」面板來得到上下文相關的代碼幫助,或者在「Documentation」窗口中進行搜索來查找指南和完整的 API 參考。 ios

image: ../Art/finding_info_2x.png

經過關聯幫助文章來得到 Xcode 指導

      若要在使用 Xcode 時得到幫助,請閱讀幫助文章。幫助文章會說明如何完成常見的任務,如建立新類、在 Interface Builder 中設置自定類,以及使用 Auto Layout 解決問題。 編程

      根據您嘗試執行的操做內容,能夠按住 Control 鍵點按 Xcode 中的 UI 元素來訪問某些幫助文章。查找關聯菜單中上一次輸入的內容(此圖像中爲「Project Navigator Help」)。 app

image: ../Art/contextualHelp.pdf

      若是查找的是通用幫助,或者任務相關的元素不支持按住 Control 鍵點按來訪問信息,那麼您還能夠在「Xcode Help」菜單中搜索關聯幫助。 框架

image: ../Art/helpMenu_2x.png

使用指南來得到通用概述和概念概述

      請閱讀概念指南中的相關章節,瞭解新技術或深刻理解框架中不一樣的類之間配合工做的方式。大多數 Cocoa 框架和技術都有相應的編程指南,如《SpriteKit Programming Guide》(Sprite Kit 編程指南)、《Programming with Objective-C》(使用 Objective-C 編程),以及《Location and Maps Programming Guide》(位置和地圖編程指南)。 編輯器

      在 Xcode 中,可使用文稿顯示窗口來查看此類文稿,訪問方法是選取「Help」>「Documentation and API Reference」(Option–Command–問號)。只需鍵入技術名稱便可,如「Sprite Kit」。 ide

image: ../Art/findingSpriteKit_2x.png

      結果將有序顯示,對您寫代碼最有幫助的內容排在前列。也就是說 API 參考條目將首先被列出,接着是 SDK 和「工具」指南。 工具

      若是彈出式列表中沒有顯示合適的結果,請選取「Show All Results」以顯示可供過濾的完整結果。 ui

image: ../Art/showAllResults_2x.png

使用 API 參考來得到類信息

      閱讀完指南,瞭解了技術的方方面面,並開始應用該技術編寫代碼時,您就會發現還須要進一步瞭解各個類能作些什麼,或者須要掌握如何正確地調用特定方法。API 參考文稿提供了這些信息。 spa

      例如,要了解前面教程中使用的NSString類的更多信息,只需在文稿顯示窗口的搜索欄中鍵入類的名稱便可。

image: ../Art/searchForClass_2x.png

      最常點選的內容一般是所需內容;按下 Return 鍵進行選擇,而後就能夠看見該類的 API 參考。

image: ../Art/nsstringClassRef_2x.png

      API 參考文稿可以讓您快速訪問各個類的相關信息,包括類所提供的方法列表、父類,以及所採用的協議。點按「More related items」,查看關於類的通用信息。

image: ../Art/nsstringInfo_2x.png

      「Related Items」彈出式窗口還會顯示相關指南的列表。例如,對於NSString來講,若是您更想要了解概念概述,而不是深究參考資料,請閱讀《String Programming Guide》(String 編程指南)。

      除了描述特定的方法或屬性以外,API 參考文稿還會概述類能夠執行的全部任務。

image: ../Art/nsstringTasks_2x.png

使用 Quick Help 來得到關聯的源代碼信息

      在源代碼編輯器中寫代碼時,可在「Quick Help」面板中輕鬆訪問 API 參考文稿(選取「View」>「Utilities」>「Show Quick Help Inspector」)。「Quick Help」面板會在您寫代碼的過程當中不斷更新,顯示當前正在鍵入的符號的相關信息。

image: ../Art/quickHelp_2x.png

      另外,您能夠在源代碼編輯器中按住 Option 鍵點按符號,從而顯示帶有「Quick Help」信息的彈出式窗口。

image: ../Art/optClickPopup_2x.png

      經過「Quick Help」面板或彈出式窗口,您能夠在單獨的文稿顯示窗口中打開 API 參考,還能夠查看包含所點按符號的聲明的原始頭文件。

經過示例代碼來查看實際用法

      除了書面文稿,您還能夠訪問示例代碼資源庫。不管什麼時候在文稿顯示窗口中閱讀快速幫助或指南和參考,都有一些條目會顯示給定技術或類的相關示例代碼項目。

image: ../Art/quickHelp_2x.png

      點按任何一個示例代碼條目均可以在 Xcode 中下載並打開項目,以便您檢查代碼。

      除了在整個項目中進行代碼註釋以外,某些較大的代碼示例還有附加文稿。例如,Sprite Kit Adventure 項目附加了《code:Explained Adventure》(代碼:解釋冒險)文稿。

image: ../Art/codeExplained_2x.png
相關文章
相關標籤/搜索