Xcode 9.1 のバグを踏んだ話(Playground コメントのレンダリング)

はじめに

  • 弊社では Swift 言語を学ぶ研修用のコンテンツを、 Xcode Playground として用意しています
  • Swift 4 に対応しようと思い、 Xcode 9.1 でコンテンツを開いてみました
  • そこには、バグが潜んでいました…

本来の挙動

  • Playground では、特別なコメントを記述することによりページ間のリンクやリッチな表現が可能となります1
  • 画像では「Render Documentation」がチェックされており、正しくレンダリングされているのがわかります

    playground_rendered.png

Xcode 9.1 のバグ

  • ページを移動すると、「Render Documentation」がチェックされているにもかかわらず、コメントがレンダリングされていません

    playground_ bug.png

対策

  • 現状、ページを移動するごとに「Render Documentation」のチェックを付け直すしかなさそうです2
  • Apple も認識しているようなので、次のバージョンで修正されることを願うばかりです