日本人のための SwiftFormat【概要編】 - iOSエンジニアのつぶやき

SwiftFormatとは？

SwiftFormat は MacOS または Linux で Swift コードを再フォーマットするためにコマンドラインツールです。

なぜ使うのか？

プロジェクトをチームで行う際にコーディングスタイルを統一することで、コードの見やすさや・追いやすさが向上しますが、これらを認識のあっていないチームで行うとコードのフォーマットの違いを指摘・修正を手動でオペレーションすることにコストがかかります。これらの作業を SwiftFormat で自動化することで開発者はコードの動作に集中できるようになります。

どうやって使うのか？

現在は下記の4通りの方法があるみたいです。

コマンドラインツールとして手動で実行するか他のツールチェインの一部として使用する
Source Editor Extension として Xcode の [Editor] > [SwiftFormat] メニューから呼び出す
Xcode プロジェクトのビルドフェーズ(Run Script?)として、Cmd-R or Cmd-Bを押すたびに実行されるようにする
Git のプリコミットフックとして、チェックインする前に変更したファイルで実行するようにする

【実装編】では 3.の RunScript での実装 + CocoaPods での導入を検討しているのでそれらについて少し触れます。

Xcode ビルドフェーズで導入する

今回はチームで共有する際に最もシンプルで簡単な Xcode ビルドフェーズ で導入したいと思います。もし他の方法で実現したい場合は公式のレポジトリを確認してください。

※ このスクリプトを追加すると、作業中のソースファイルが上書きされます。スクリプトをメインターゲットではなくテストターゲットに追加すると、ユニットテストを実行する時にのみ呼び出され、アプリをビルドするたびに呼び出されないようにすることができるようになるみたいです。

または、通常のビルドの一部として lintモードで SwiftFormat を実行し、手動でフォーマットパスを実行するか、頻度の低いビルドターゲット(テストなど) の一部として実行することを検討した方がいいみたいです。

SwiftFormat Lint モード
- SwiftFormat はリンターではなくフォーマッターとして設計されているため、どこが問題なのかを伝えるのではなくて、コードを実際に修正するように設計されている。実際にコードを変更することが望ましくない状況でコードがフォーマットされていることを確認したい時の場合に lintモードが役立つ
- SiwftFormat をリンターとして実行する時に、--lint コマンドラインオプションを使用できる

CocoaPods での導入

SwiftFormat CLI を Podfile に追加する

次の行を Podfile に追加して pod install で SwiftFormat のバイナリをプロジェクトディレクトリに追加する。下記の実行によってビルド済みのコマンドラインアプリのみがインストールされて、SwiftFormat の Framework のソースコードはインストールされなくなります。