Your First iOS app(14)--Finding Information

Finding Information

查找信息

當你開發app的時候，你會希望在你卡住的時候學到有用的信息。你能在不離開Xcode的情況下得到你需要的所有信息。

Xcode配有一個強大的文檔套件，包含許多不同類型的文檔，包括通用和概念性的指南、框架和類的參考、以及重點幫助文章。你能通過好幾種方式訪問這個文檔，例如在Xcode區域點擊右鍵來學習如何使用它們，打開在主工程窗口的中的Quick Help面板來感知代碼幫助，或者搜索Documentation Window找到所有API的參考。

Use Contextual Help Articles for Xcode Guidance

使用上下文幫助文章得到Xcode指導

當使用Xcode的時候想要獲得幫助，可以查看幫助文章。幫助文章顯示如何完成常見任務，例如創建一個新類、在IB上設置一個自定義類，以及用自動布局解決問題。

這取決于你想做什么，你能通過按住Control鍵點擊Xcode里的UI元素來訪問幫助文章。在上下文菜單中找到最近的條目（在下圖里，是工程導航器幫助）。

如果你正在查找一個元素的一般幫助、或者關于任務相關的信息，但它不支持Control-點擊，你也能在Xcode Help菜單里搜索上下文幫助索引。

Use Guides for General and Conceptual Overviews

使用指南得到一般概念性概述

學習一項新技術或者深入理解框架里的不同類如何協同工作，需要看一下概念指南。大多數的Cocoa框架和技術有與他們有關的編程指南，例如Sprite Kit Programming Guide, Programming with Objective-C, 和 Location and Maps Programming Guide。

想要在Xcode里查看這些文檔，使用文檔查看器窗口，你能通過選擇 Help > “Documentation and API Reference” (Option–Command–Question Mark)來訪問，例如Sprite Kit

結果是按照你編寫代碼的有用程度排序的。這就意味著你將看到API參考條目列在第一，然后是SDK和工具指南。

如果合適的結果沒有出現在彈出列表中，則選擇Show All Results 來顯示一個你過濾的所有結果。

Use API Reference for Class Information

使用API參考來得到類的信息

當你閱讀指南來學習關于技術的不同部分以及你開始使用這些技術來編寫代碼，你或許查找你需要的內容來了解更多關于這個類能做什么，或者你需要學習調用一個特定類的正確方法。這些信息都在API Reference文檔中提供。

舉個例子，要想知道關于你在教程較早時候使用的NSString類的更多信息，只需要在文檔視圖窗口的查找字段里輸入類的名字即可。

Top hit通常使你想要的；按下Return來選擇，你會看到這個類的API 參考。

API參考文檔被定義為讓你能夠快速訪問特定類的信息，包括這個類提供的方法列表，以及信息，例如父類和采用的協議。點擊“更多相關項目（More related items）”來看更多關于類的通用信息。

相關項也顯示相關指南的列表。舉個例子，NSString，你或許想要更多的概念而不是深入研究參考資料，你應該讀String Programming Guide

除了描述一個特定方法或屬性外，API reference 文檔也提供了這個類能執行的所有任務的概述。

Use Quick Help for Contextual Source Code Information

使用快速幫助來得到上下文源代碼信息

當你用源編輯器來編寫代碼的時候，你可以通過Quick Help(choose View > Utilities > Show Quick Help Inspector)面板來輕松訪問API reference 文檔。快速幫助面板在你編寫代碼的時候更新，顯示的是你當前正在鍵入的符號的信息。

或者，你可以按住Option在源代碼編輯器里點擊一個符號來顯示一個彈出窗口用來顯示快速幫助信息。

從快速幫助面板到彈出窗口，你能在單獨的文檔檢查器窗口打開API Reference，或者你能查看在包含在頭文件里的申明文件的yobitticked象征。

Use Sample Code to See Real-World Usage

使用示例代碼來看實際使用

除了書面文檔外，你也能訪問sample code庫。每當你在文檔檢查窗口查看一個快速幫助、或者指南和參考時，你將看到條目顯示給定技術或類的相關示例代碼。

點擊一個示例代碼條目來下載并在Xcode中打開一個工程，這樣你就能研究代碼了。

除了項目中的注釋代碼為外，一些較大的代碼示例也有附件文檔。舉個例子，Sprite Kit Adventure工程通過code:Explained Adventure伴隨一個文檔。

iOS Technologies

Where to Go from Here

Copyright 2014 Apple Inc. All rights reserved. Terms of Use | Privacy Policy | Updated: 2013-10-22