Parmi les nouvelles fonctionnalités annoncées dans Xcode 8 , on peut voir
"Création automatique de la documentation d'aide rapide":
Est-ce la fin de la documentation du code manuel comme nous pouvons l'apprendre dans cet article de NSHipster ?
Quelqu'un peut-il décrire les avantages et les inconvénients de cette nouvelle fonctionnalité? Remplace-t-il des outils comme Jazzy ?
Je n'ai pas pu trouver plus d'informations sur la nouvelle fonctionnalité.
Réponses:
Cela fait référence à la fonctionnalité Xcode 8 (et versions ultérieures), où vous pouvez sélectionner une méthode comme celle-ci:
func foo(bar: Int) -> String { ... }
... puis appuyez sur ⌘+ option+ /(ou choisissez «Structure» »« Ajouter de la documentation »dans le menu« Éditeur »de Xcode) et il générera le modèle de commentaires suivant pour vous:
/// <#Description#>
///
/// - parameter bar: <#bar description#>
///
/// - returns: <#return value description#>
Cela facilite simplement la rédaction de la documentation pour l'aide rapide.
Notez que bien que ce comportement ait un peu changé au fil du temps, Xcode peut être particulier sur l'emplacement du curseur lorsque vous essayez de le faire. Par exemple, le curseur doit être quelque part dans le nom de la fonction, foodans mon exemple ci-dessus, pour que cela fonctionne. Ou double-cliquez simplement sur le nom de la fonction, puis appuyez sur ⌘+ option+/
@IBActionméthodes. Mais cela fonctionne à la fois avec Objective-C et Swift. Si vous rencontrez toujours des problèmes et que vous avez essayé la procédure boiteuse habituelle de redémarrage de Xcode et / ou de redémarrage de votre machine, vous voudrez peut-être simplement publier un rapport de bogue sur ce logiciel bêta.
sudo /usr/libexec/xpccachectldans Terminal et redémarrer votre Mac avant qu'il ou toute autre extension Xcode ne le fasse. travail. Consultez les notes de mise à jour de Xcode 8.
Ceci est probablement lié au fait que TOUTES les touches de raccourci avec un '/' ne fonctionnent pas dans la version actuelle de XCode 8, si votre clavier nécessite d'appuyer sur shift pour l'obtenir.
C'est-à-dire que sur le clavier allemand, le '/' est shift + 7, appuyer sur alt + cmd + shift-7 ne fait rien. Si vous attribuez ie cmd + shift + opt + d, cela fonctionne très bien.
Le raccourci '///', qui malheureusement ne fonctionne pas non plus pour le moment, est probablement dû à l'ancien plugin XCode VVDocumenter, qui utilisait exactement ce raccourci.
Grande fonctionnalité, QA moche du côté Apple.