Salesforce DX 開発者ガイド
jパッケージバージョンのアップグレード
既存のパッケージにメタデータの変更を適用する必要がある場合、CLI を使用してパッケージバージョンを別のバージョンにアップグレードできます。
パッケージのアップグレードを実行すると、メタデータの変更は次のように影響します。
- 新しいバージョンに適用されたメタデータは、アップグレードの一部としてインストールされます。
- アップグレードされるコンポーネントの API 参照���が対象組織にすでにあるコンポーネントの API 参照名と同じ場合、コンポーネントはメタデータの変更で上書きされます。
- アップグレード内のコンポーネントが以前に対象組織から削除されている場合、アップグレード中にコンポーネントが再作成されます。
- 新しいパッケージバージョンで削除されたメタデータは、アップグレードの一部として対象組織からも削除されます。削除されたメタデータとは、現在のパッケージバージョンのインストールに含まれず、対象組織にインストールされた前のパッケージバージョンに含まれるメタデータです。メタデータがアップグレード前に削除された場合、アップグレードは通常どおり行われます。廃止され、削除されていないメタデータの例を次にいくつか示します。
- カスタムオブジェクトおよび項目にユーザが入力したデータは廃止されても、削除されません。システム管理者はこのデータを必要に応じてエクスポートできます。
- Apex クラスなどのオブジェクトは廃止されても、パッケージの一部である Lightning コンポーネント内で参照されている場合、削除されません。
- API バージョン 45.0 以降 (Salesforce CLI バージョン 45.0.9 以降の salesforcedx プラグイン) では、パッケージのアップグレード時に、削除されたメタデータの処理を指定できます。force:package:install コマンドの -t | --upgradetype パラメータを使用して、次のいずれかの値を指定します。
- DeprecateOnly では、削除されたすべてのコンポーネントを廃止としてマークすることを指定します。削除されたメタデータは、パッケージのアップグレード後に対象組織に存在しますが、UI にはパッケージから廃止されたとして表示されます。このオプションは、パッケージ間でメタデータを移行する場合に役立ちます。
- Mixed (デフォルト) では、削除された一部のコンポーネントを完全に削除し、その他のコンポーネントを廃止としてマークすることを指定します。物理削除されたコンポーネントについての詳細は、「メタデータカバー率」を参照してください。