Stripe のバージョン管理とサポートに関するポリシー
Stripe のバージョン管理とサポートに関するポリシーについてご紹介します。
Stripe API バージョン
2024-09-30.acacia リリース以降、Stripe は、新しい API リリースのプロセスに従い、大きな変更なしに新しい API バージョンをリリースしています。年 2 回、新しいリリース (acacia など) を発行し、最初の API バージョンには対応処理が必要な変更が行われます。
SDK の新しいマイナーバージョンは毎月の API バージョンで提供され、SDK の新しいメジャーバージョンは年 2 回のメジャーリリースで提供されます。
SDK の出荷に対応処理が必要な変更が伴う場合、SDK のメジャーバージョンの更新のほか、毎月の API バージョンの更新が行われることがあります。
新しい API バージョンの予定については、API のアップグレードをご覧ください。
Stripe SDK バージョン
Stripe の SDK バージョン管理ポリシーは、セマンティックバージョニング標準に基づいています。たとえば、バージョン 4.3.2 では、4 が「メジャー」、3 が「マイナー」、2 が「パッチ」を表します。Stripe が新機能やバグ修正のために新しい SDK バージョンをリリースする際には、導入される変更のタイプに応じて、これら 3 つのバージョンコンポーネントのいずれかが増分されます。
- メジャー。最新バージョンとの後方互換性がない、対応が必要な変更がバージョンに含まれる場合は、「メジャー」バージョンコンポーネントが増分されます (必須パラメーターの追加や、タイプ、プロパティ、メソッド、パラメーターの変更)。たとえば、SDK の例外クラスの名前の変更がこれに含まれます。
- マイナー。最新バージョンとの後方互換性がある新機能がバージョンに含まれる場合は、「マイナー」バージョンコンポーネントが増分されます (新しいタイプ、プロパティ、メソッド、オプションのパラメーター、またはサポートされるパラメーター値の追加)。たとえば、SDK のメタデータ削除メッセージの明確化がこれに含まれます。
- パッチ。バージョンに後方互換性のあるバグ修正が含まれる場合は、「パッチ」バージョンコンポーネントが増分されます (修正してもドキュメント化された型、プロパティ、メソッド、パラメーターを変更することのない、動作の変更)。たとえば、ファイルのアップロードが正しくリストされないバグの修正がこれに含まれます。
プレビュー版の段階では、beta または b というサフィックスを持つ SDK のバージョンを使用して、新機能や機能強化をテストできます。たとえば、Python では 5.1.0b3、他の言語の SDK では 5.1.0-beta.3 などです。
インストール手順や、Stripe-Version ヘッダーでベータ版ヘッダーを渡すことについて、詳細はそれぞれの SDK GitHub リポジトリーの README ファイルをご覧ください。
Stripe SDK のサポートポリシー
新機能とバグ修正は、SDK の最新の「メジャー」バージョンでリリースされます。以前の「メジャー」 SDK バージョンをご使用の場合は、新機能とバグ修正を利用するために、最新のメジャーバージョンにアップグレードすることをお勧めします。以前のメジャーバージョンのパッケージは引き続き使用できますが、追加の更新は提供されません。
移行ガイド
Stripe は、以前のメジャー SDK バージョンからのアップグレードに役立つ移行ガイドをご用意しています。これらのガイドは、Stripe の SDK GitHub リポジトリーの wiki セクションにあります。