はじめよう！Swift OpenAPI Generatorによるスキーマ駆動開発：導入手順と活用のコツ by kamimi / かみみ

OpenAPI Specification活用してますか？HTTP APIのインターフェース定義で仕様の認識合わせにうってつけ。エコシステムも充実しています。

WWDC23ではSwift特化のGenerator、Swift OpenAPI Generatorが発表されました。Swift Package pluginとして提供されたことでコードの生成から利用を、Xcodeを離れることなくスムーズに行えます。

似たコードを何度も書かずに済むという利点の一方、自動生成ならではのコツも存在します。例えばドキュメント生成のためだけなら気にしなくてよかったspecの書き方があります。また現時点の自動生成は未熟な点もありこのGenerator独自の実装方法を知る必要もあります。

本記事ではそんなSwift OpenAPI Generatorの導入手順や活用のコツを実際のコードを交えてご紹介します。