Box SDKの提供方法に対して重要な変更が行われています。
日本時間2025年9月18日をもって、Boxの次世代SDKは、個別のアーティファクトとしてサポートされなくなりました。既存のコードは、変更しなくても引き続き動作します。Boxの次世代SDKをベースにしたアプリケーションは影響なく引き続きご利用いただけますが、新機能、更新、バグ修正は提供されなくなります。
Boxでは、業界のベストプラクティスに従って、プログラミング言語ごとにBoxの次世代SDKとBoxコアSDKを1つのパッケージに統合します。これにより、移行作業がさらに容易になり、手動で管理されていたBoxコアSDKを引き続き使用している既存のアプリケーションに新機能をシームレスに追加できるようになります。
次世代SDK向けの新機能や更新を含む、今後の開発はすべて、v10以降のBoxコアSDKを通じて提供されます。現在、v10は個別のブランチとして利用可能です。
これがアプリケーションや開発ワークフローに与える影響を以下に示します。
要点
既存のコードは引き続き動作します。Boxの次世代SDKを使用しているアプリケーションは、変更しなくても動作します。ただし、今後は、これらのSDKに新機能、更新、バグ修正が提供されなくなります。今後の開発はすべて、v10以降の統合されたBoxコアSDKパッケージで行われます。
変更内容
以下の別々の2つのSDK製品を1つに統合します。
- BoxコアSDK (手動で管理)
- Boxの次世代SDK (自動生成)
統合された新しいパッケージでは、SDK配布に関する業界のベストプラクティスに従って、プログラミング言語ごとにすべての機能を1つのアーティファクトにまとめて提供する予定です。
今回の変更の理由
今回の統合には、いくつかのメリットがあります。
- SDKのバージョン間の移行の簡略化
- コアSDKを使用しているアプリケーションへの機能導入の簡素化
- 言語ごとに1つのSDKに重点を置く開発作業の統合
- SDKのパッケージ化に対する業界標準のアプローチ
移行方法
この移行は、下位互換性を優先しつつ明確なアップグレード方法を提供する、Boxの標準的なSDKのバージョン戦略に従っています。
バージョン (n+1) — 移行フェーズ
現在のバージョン後の次のメジャーバージョンには、コアSDKと次世代SDK両方のアーティファクトが含まれます。これにより、移行中、両方のSDKの機能を同時に使用できます。
バージョンv10.0.0 — 次世代のみ
バージョン10には、Box SDKの今後の方向性を表す、次世代SDKのアーティファクトのみが含まれています。
意思決定のためのクイックガイド
新しいアプリケーションを作成する場合
BoxコアSDKパッケージのv10.0.0を使用します。
Boxの次世代SDKを使用する場合
パッケージの依存関係をBoxコアSDK v10.0.0に置き換えます。インポートに変更はありません (ただし、微調整が必要なTypeScriptを除く)。
BoxコアSDKを使用する場合
使用可能な場合は、次のメジャーバージョンにアップグレードして、移行中に両方のアーティファクトにアクセスします。
変更の予定がない場合
予期しない更新を防ぐために、パッケージマネージャを現在のSDKバージョンにロックします。
SDKのバージョンのリファレンス
詳細については、開発者向けドキュメントサイトをご確認ください。
次のステップ
- 依存関係を確認する — アプリケーションで使用されているBox SDKのバージョンを確認します。
- 移行を計画する — ほとんどの移行は、パッケージ名の変更だけで済みます。
- 徹底的にテストする — ほとんどのコードは変更なしで動作しますが、特定のユースケースは確認します。
- 必要に応じてバージョンをロックする — 移行の準備ができていない場合は自動更新を阻止します。
Boxの次世代SDKからBoxコアSDK v10への移行
Boxの次世代SDKからBoxコアSDK v10に移行するには、以下の詳細な移行ガイドに従ってください。
この統合は、Box SDKに期待される信頼性を維持しながら、より効率的な開発者エクスペリエンスを提供するというBoxの取り組みを表すものです。この変更により、Boxを使用した開発がさらに簡単かつ効率的になることを確信しています。