拡張機能のアップグレード

拡張機能開発者は、拡張機能に新しい機能を継続的に追加し、頻繁にバグを修正します。これらのアップデートは、拡張機能の新しいバージョンへとパッケージ化され、アップグレードとして拡張機能カタログ内で使用できるようになります。

拡張機能カタログ

拡張機能の開発者が拡張機能の新しいバージョンを提供すると、拡張機能カタログで新しいバージョンを入手できるようになります。カタログには、拡張機能の最新バージョンのみが表示されます。latest バージョン以外の拡張機能をインストールすることはできません。

プロパティに拡張機能をインストールすると、現在使用可能なバージョンがインストールされます。新しいバージョンがカタログに追加された場合でも、プロパティはその時点以降の特定のバージョンのままとなります。

アップグレード通知

プロパティに拡張機能をインストール後、新しいバージョンをカタログに追加した場合、インストール済みの拡張機能ページを表示すると、拡張機能カードに「アップグレード」ボタンが表示されます。

その拡張機能によって提供されるリソースを編集する際にも、通知が表示されます。

アップグレードは永続的

カタログ内の新しいバージョンにアップグレードする場合は、そのアップグレードを自分でインストールする必要があります。アップグレードは、デプロイされたタグに影響を与える前にライブラリに追加、テスト、公開する必要がある「変更」です。

アップグレードは慎重におこなってください。新しい拡張機能をテストする準備をおこない、デプロイする準備が完了している場合を除き、アップグレードはしないでください。プロパティにアップグレードが追加されたら、すべてのライブラリに追加する必要があります。アップグレードされた拡張機能を含まないライブラリは、ビルド時に失敗します。

現在、拡張機能を以前のバージョンにダウングレードする機能はありません。アップグレードが完了すると（公開するかどうかにかかわらず）、新しい拡張機能バージョンがプロパティに表示されます。

アップグレードプロセス

アップグレードのインストールは、初めて拡張機能をインストールする場合と同じです。

「保存」をクリックするまで、アップグレードは実際におこなわれません。その前であればいつでも、「キャンセル」を選択して、現在インストールされているバージョンを保持できます。「保存」を選択すると元に戻せなくなります。

ステータスが Approved または Submitted となっているライブラリがある場合、拡張機能をアップグレードすることはきません。これは、次のビルドに新しい拡張バージョンを含める必要があるためです。Approved または Submitted のライブラリの場合、次のビルドは実稼動ビルドになります。最新バージョンが含まれていないのでそのビルドは失敗します。そのためワークフローでは、拡張機能をアップグレードする​ 前に、ステータスが Approved または Submitted のライブラリを公開または拒否します。

アップグレードの公開

アップグレードされた拡張機能をプロパティにインストールしたら、それ以降のすべてのライブラリにその拡張機能をそこに含める必要があります。ビルドエラーメッセージは、そのビルドを含まないあらゆるライブラリに対して表示されます。

その点を除き、アップグレードされた拡張機能をライブラリに追加する操作は、ライブラリに 別の変更を追加する場合と同じです。

ライブラリを編集画面から、「変更されたすべてのリソースを追加」ボタンを使用するか、「リソースを追加」ボタンを使用して、アップグレードされた拡張機能をそれぞれ選択します。

ライブラリに拡張機能のアップグレードを追加したら、公開フローで説明されている手順に従って、ライブラリを実稼動環境に公開できます。