SDK とは?
ソフトウェア開発キット(SDK)は、特定のプラットフォームやサービス向けに開発するためのリソースをまとめたものです。通常、言語別のライブラリ、ドキュメント、サンプル、開発ツールを含みます。
SDK の仕組み
SDK は、サービスやプラットフォームの契約仕様を、各言語に自然な関数、型、モデル、ツールとして提供します。転送の詳細のラップ、リクエストのシリアライズ、オプションの検証、認証ヘルパーの提供、レスポンスの予測可能なオブジェクトへの変換などを行う場合があります。インターフェースそのものである API とは異なり、SDK は、特定のエコシステムでそのインターフェースを使うために保守されている実装の一つです。開発チームは SDK をアプリケーション層に組み込み、基盤となるサービスのセマンティクスを維持しながら、統合用コードを削減します。
要点
- SDK のリリースバージョンは、アプリケーションとは独立して API の変更に追従できます。互換性のあるバージョン範囲を固定し、変更履歴を確認すると、予期しないインターフェースの変更を防ぐのに役立ちます。
- 自動生成された SDK は、機械可読の API スキーマを忠実に反映することが多い一方、手書きの SDK は、より高水準のワークフローを提供する場合があります。使い勝手や更新頻度は異なります。
- SDK を使っても、ネットワーク障害がなくなるわけではありません。呼び出し側では引き続き、適切なタイムアウト、再試行ルール、冪等性の処理、非同期ジョブの結果の検証が必要です。
SDK が重要になる場面
SDK が対応する言語の API で、反復的な低水準のリクエスト処理や認証コードを置き換えられる場合は、SDK をインストールします。古い SDK には現在の機能や動作が含まれていない場合があるため、バージョンとプラットフォームの互換性を確認してください。