Xcode 8 स्वतः-जनित त्वरित सहायता दस्तावेज


85

Xcode 8 में घोषित नई सुविधाओं में , हम देख सकते हैं

"ऑटो-जेनरेट क्विक हेल्प डॉक्यूमेंटेशन":

यहाँ छवि विवरण दर्ज करें

क्या यह मैनुअल कोड प्रलेखन का अंत है जैसे हम NSHipster के इस लेख से सीख सकते हैं ?

क्या कोई इस नई सुविधा के पेशेवरों और विपक्षों को रेखांकित कर सकता है? क्या यह जैज़ी जैसे टूल को रिप्लेस करता है ?

मुझे नई सुविधा के बारे में अधिक जानकारी नहीं मिली।


@ रब: कोई भी विचार कि मैं Xcode 8 btata को स्थापित करने के दर्द के बिना कैसे समुद्र को देख सकता हूं और इसे ठीक से अनइंस्टॉल कर सकता हूं (मेरी नौकरी के मैक पर इसे स्थापित करने के लिए अधिकृत नहीं है)
H4Hugo

यह कुछ WWDC 2016 वीडियो में प्रदर्शित किया गया है।
रोब


2
आप वीडियो में 37:00 पर एक डेमो देख सकते हैं - हालांकि मैं वास्तव में काम करने के लिए इसे प्राप्त नहीं कर सकता हूं! मैंने स्विफ्ट और ओब्जे-सी के साथ और एक फ़ंक्शन के विभिन्न भागों के साथ चयन करने की कोशिश की है।
कन्फ्यूज्ड वोरलोन

जवाबों:


203

यह एक्सकोड 8 (और बाद में) सुविधा को संदर्भित करता है, जहां आप इस तरह से एक विधि का चयन कर सकते हैं:

func foo(bar: Int) -> String { ... }

... और फिर + option+ दबाएं /(या "संरचना" »" Xcode के "संपादक" मेनू से "प्रलेखन जोड़ें) चुनें और यह आपके लिए निम्नलिखित टिप्पणियों का खाका तैयार करेगा:

/// <#Description#>
///
/// - parameter bar: <#bar description#>
///
/// - returns: <#return value description#>

यह सिर्फ त्वरित मदद के लिए प्रलेखन के लेखन की सुविधा देता है।


ध्यान दें, जबकि यह व्यवहार समय के साथ थोड़ा बदल गया है, एक्सकोड विशेष रूप से हो सकता है कि जब आप ऐसा करने का प्रयास करते हैं तो कर्सर कहाँ होना चाहिए। उदाहरण के लिए, कर्सर को फ़ंक्शन नाम में कहीं होना चाहिए, fooमेरे उपरोक्त उदाहरण में, इसके लिए काम करना है। या फ़ंक्शन के नाम पर सिर्फ डबल क्लिक करें और फिर + option+ दबाएँ/


1
क्या आप इसे काम कर सकते हैं? मैं नहीं कर सकता। यदि आप; जब आप कमांड का उपयोग करते हैं तो आप क्या चुन रहे हैं? मैंने हर विकल्प के बारे में कोशिश की है ...
कन्फ्यूज्ड वोरलोन

2
मैंने अपना कर्सर कहीं विधि के नाम पर रखा और फिर कमांड + विकल्प + "/" (साथ ही "संपादक" - "संरचना" - "प्रलेखन जोड़ें") को Xcode 8 में दबाया और यह ठीक काम करता है। अभी तक मैंने जो एकमात्र समस्या का सामना किया है, वह यह है कि यह @IBActionविधियों में उलझा हुआ लगता है । लेकिन यह ऑब्जेक्टिव-सी और स्विफ्ट दोनों के साथ काम करता है। यदि आपको अभी भी समस्या हो रही है और Xcode को फिर से शुरू करने और / या अपनी मशीन को रिबूट करने की सामान्य लंगड़ा प्रक्रिया की कोशिश की है, तो आप बस इस बीटा सॉफ़्टवेयर पर एक बग रिपोर्ट पोस्ट करना चाह सकते हैं।
रोब

2
मैंने सिर्फ एक रिबूट की कोशिश की, लेकिन अभी भी कोई खुशी नहीं है। मैंने एक बग रिपोर्ट प्रस्तुत की है।
कन्फ्यूज्ड वोरलोन

5
यह वास्तव में Xcode 8 बीटा 1 के रूप में काम कर रहा है, लेकिन यदि आप El Capitan का उपयोग कर रहे हैं, तो आपको Xcode लॉन्च करने की आवश्यकता है, इसे आवश्यक सिस्टम घटक स्थापित करने दें, और फिर sudo /usr/libexec/xpccachectlटर्मिनल में दौड़ें और अपने मैक को इसके या किसी अन्य Xcode एक्सटेंशन से पहले पुनः आरंभ करेंगे। काम। Xcode 8 रिलीज़ नोट देखें।
क्रिस हैनसन

1
मुझे लगता है कि यह छिटपुट रूप से काम करता है। कभी-कभी यह महान काम करता है और अन्य समय बिल्कुल नहीं। और न ही मैंने ऐसा क्यों खोजा है। सच कहूं, जब यह काम करता है, तो मुझे उन चीजों का पता चलता है जो इसे स्वत: उत्पन्न करती हैं बल्कि विरल (विवरण में विधि का नाम?)। आप में से उन लोगों के लिए कि यह बिना किसी समस्या के काम करता है, भयानक। हम में से कुछ के लिए, यह छिटपुट है या बस काम नहीं करता है।
लॉयड सार्जेंट

7

यह इस तथ्य से संबंधित है कि सभी हॉटकीज वर्तमान XCode 8 बिल्ड में काम नहीं करते हैं, यदि आपके कीबोर्ड को इसे प्राप्त करने के लिए शिफ्ट प्रेस करने की आवश्यकता होती है।

यानी जर्मन कीबोर्ड पर '/' Shift + 7 होता है, alt + cmd + shift-7 दबाकर कोई काम नहीं करता है। यदि आप cmd + shift + opt + d असाइन करते हैं, तो यह ठीक काम करता है।

शॉर्टकट '///', जो दुर्भाग्य से अभी भी काम नहीं करता है, संभवतः पुराने XCode प्लगइन VVDocumenter के कारण है, जो वास्तव में इस शॉर्टकट का उपयोग करता है।

महान सुविधा, एप्पल पक्ष पर घटिया क्यूए।


Xcode 8 बीटा में यह बग था लेकिन यह जारी किए गए संस्करण में तय किया गया है।
एरिक आया

8A218a जारी किया गया संस्करण है - और टिप्पणी शॉर्टकट मेरे लिए फिर से काम करता है (दांव में नहीं)।
एरिक आया

क्या आप एक कीबोर्ड लेआउट पर हैं, जहाँ आपको शिफ्ट का उपयोग किए बिना '/' मिलता है?
क्लॉस बस

हां, मेरे पास दो कीबोर्ड हैं, एक फ्रेंच Azerty एक "/" के ऊपर ":" और एक अमेरिकी Qwerty एक। दोनों कमेंट शॉर्टकट के लिए ठीक काम करते हैं।
एरिक आया

खैर, यह मेरे (अमेरिकी कीबोर्ड) के लिए आंतरायिक है।
लॉयड सार्जेंट
हमारी साइट का प्रयोग करके, आप स्वीकार करते हैं कि आपने हमारी Cookie Policy और निजता नीति को पढ़ और समझा लिया है।
Licensed under cc by-sa 3.0 with attribution required.