SDK のメンテナンスとサポート

AmplitudeがSDKを維持する方法

このドキュメントでは、ブラウザやモバイルSDKを含むAmplitudeソフトウェア開発キット（SDK）とツール、Ampli CLI、およびそれらの基礎となる依存関係に関するメンテナンスポリシーについて概説しています。AmplitudeはこれらのSDKとツールを定期的に更新し、新規または更新されたAmplitude API、新機能、機能強化、バグ修正、セキュリティパッチ、またはドキュメントアップデートのサポートを追加します。 また、アップデートで依存関係、言語ランタイム、およびオペレーティングシステムの変更に対応する場合があります。AmplitudeはSDKリリースをパッケージマネージャー（npm、CocoaPods、Maven、PyPIなど）に公開しており、ソースコードはGitHubで入手できます。

Amplitudeは、最新の機能、セキュリティアップデート、依存関係のサポートを入手するために、SDKリリースを最新の状態に保つことをお勧めします。 AmplitudeはサポートされていないSDKバージョンを引き続き使用することを推奨していません。 ご自身の判断で行ってください。

バージョン管理

Amplitude SDKとツールのリリースバージョンは、Xの形式に従い、X.Y.Zがメジャーバージョンを表します。メジャーバージョンが増加したことは、SDKが言語の新しい慣用句やパターンをサポートするために大幅な変更を加えたことを示しています。Amplitudeは、パブリックインターフェイス（クラス、メソッド、タイプなど）、動作、またはセマンティクスが変更されたときにメジャーバージョンを導入します。アプリケーションを更新して、最新のSDKバージョンで動作するようにしてください。メジャーバージョンを慎重に更新し、Amplitudeのアップグレードガイドラインに従ってください。

SDKメジャーバージョンのライフサイクル

主要な SDK およびツールバージョンのライフサイクルには、次の 4 つのフェーズがあります。

• 開発者プレビュー（ベータ）（フェーズ0）：このフェーズでは、AmplitudeはSDKを完全にサポートしており、本番環境で使用できます。重大な変更は、新しいメジャーバージョンのリリースなしに発生することがあります。 本番環境での使用の場合、Amplitudeは固定バージョンを設定し、定期的に更新し、各更新後にテストすることをお勧めします。 これらのSDKでは最新機能への早期アクセスが可能になり、ユーザーはGA前にフィードバックを提供できます。Amplitudeは、リリースが安定したプロダクトであると判断した後、そのリリースをGAとしてマークすることがあります。

• 一般提供（GA）（フェーズ1）：このフェーズでは、AmplitudeはSDKを完全にサポートします。Amplitudeは定期的にSDKリリースを提供しており、これには新サービスのサポート、既存サービスのAPIアップデート、バグやセキュリティの修正が含まれています。 ツールに関しては、Amplitudeは新機能のアップデートやバグ修正を含む定期リリースを提供しています。

• メンテナンス（フェーズ2）：メンテナンスモードでは、AmplitudeはSDKのリリースを重要なバグ修正とセキュリティ問題のみに制限します。 SDKには、新規または既存のサービスに対するAPI更新や、新しいリージョンをサポートするための更新は含まれません。メンテナンスモードのデフォルト期間は、別途指定がない限り、少なくとも12か月です。新しいメジャーバージョンがGAになると、以前のバージョンはメンテナンスに入ります。

• サポート終了（EOL）（フェーズ3）：SDKがサポート終了に達すると、更新やリリースが提供されなくなります。すでに公開されているリリースは引き続きパッケージマネージャーを通じて入手可能であり、コードはGitHubに残ります。AmplitudeはGitHubリポジトリをアーカイブすることがあります。 サポートが終了した SDK は、お客様の判断でご利用ください。 Amplitudeは、新しいメジャーバージョンにアップグレードすることをお勧めします。

依存関係のライフサイクル

ほとんどのAmplitude SDKには、言語ランタイム、オペレーティングシステム、サードパーティ製ライブラリやフレームワークなど、基本的な依存関係があります。 これらの依存関係は通常、言語コミュニティまたはそのコンポーネントを所有するベンダーと結びついています。 各コミュニティやベンダーは、それぞれのプロダクトのサポート終了スケジュールを独自に公開しています。

Amplitudeは、基盤となるサードパーティへの依存関係を以下の用語で分類しています。

• オペレーティングシステム（OS）：例としては、MacOS 12.6、Android 13、Windows 11などがあります。
• 言語ランタイム: 例としては、TypeScript 4.1.6、Swift 5.7、Java 8、Python 3.10.4 などがあります。
• サードパーティ製のライブラリ/フレームワーク: OpenSSL、OCLIF、React などがその例です。

Amplitudeのポリシーは、コミュニティまたはベンダーが依存関係に対するサポートを終了した後も、少なくとも6か月間はSDKの依存関係をサポートし続けることです。 このポリシーは、特定の依存関係によって異なる場合があります。