この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

第二世代管理パッケージのバージョンの作成と更新

パッケージバージョンは、パッケージ内容および関連するメタデータの固定スナップショットです。パッケージバージョンは、変更を管理し、特定の変更セットをリリースするたびにその違いを追跡できる、インストール可能な不変のアーティファクトです。

パッケージバージョンを作成する前に、パッケージ名、連動関係、メジャー、マイナー、パッチバージョン番号などのパッケージの詳細を sfdx-project.json ファイルで確認します。新しいパッケージバージョンで変更または追加するメタデータがパッケージのメインディレクトリにあることを確認します。

1 日あたりに作成できる管理 2GP パッケージバージョンの数は?

1 日あたりに作成できるパッケージバージョンの数や残りの数を確認するには、次のコマンドを実行します。

1sf limits api display

Package2VersionCreates エントリを探します。

1NAME                                   REMAINING  MAXIMUM
2─────────────────────────────────────  ─────────  ─────────
3Package2VersionCreates                  23         50

管理 2GP パッケージバージョンの作成

次のコマンドでパッケージバージョンを作成します。パッケージの別名または ID (0Ho) を指定します。パッケージバージョンのメタデータが連動する一連の機能や設定があるスクラッチ定義ファイルを含めることもできます。

1sf package version create --package "Expenser App" --installation-key “HIF83kS8kS7C” \
2--definition-file config/project-scratch-def.json --wait 10

非同期モード以外でコマンドを実行するには、パッケージバージョンを作成するときに --wait の時間を指定します。パッケージバージョンがその時間内に作成されると、sfdx-project.json ファイルがパッケージバージョン情報で自動的に更新されます。時間内に作成されない場合は、プロジェクトファイルを手動で編集する必要があります。

メモ

キーワード NEXT を使用したパッケージバージョン番号の一意性の確保

バージョン番号の一意性を確保するために、sfdx-project.json ファイルでバージョン番号を設定するときにはキーワード NEXT を使用します。

たとえば、"versionNumber": "1.2.0.NEXT" のように設定します。

NEXT を使わず、sfdx-project.json ファイルのバージョン番号を更新し忘れた場合、新しいパッケージのバージョンに、以前のパッケージのバージョンと同じ番号が使用されます。パッケージのバージョン番号に一意性を強制しているわけではありませんが、すべてのパッケージのバージョンには一意の登録者パッケージバージョン ID (先頭が 04t) が割り当てられます。

管理 2GP パッケージバージョンの更新

コマンドラインからパッケージバージョンのほとんどのプロパティを更新できます。たとえば、パッケージのバージョン名や説明を変更できます。1 つの重要な例外として、リリース状況は変更できません。

この例では、タグパラメーターを追加し、このパッケージバージョンに関連付けられている git commit ID を指定します。

1sf package version update --package "Expenser App@1.3.0-5" --tag "git commit id 08dcfsdf"

更新が完了すると、次のような出力が表示されます。

1Successfully updated the package version. 04tB0000000KPhnIAG