第二世代パッケージのワークフロー

このワークフローを開始する前に、「第二世代管理パッケージを作成する前に」の手順を確認して完了してください。

基本的なワークフローには次の手順が含まれます。各ステップについての詳細は、個々のトピックを参照してください。

1. DX プロジェクトを作成します。
2. Dev Hub 組織を承認し、スクラッチ組織を作成します。

   このステップを実行するとき、---setdefaultdevhubusername オプションを指定します。その後、後続の Salesforce CLI コマンドを実行するときに Dev Hub ユーザ名を省略できます。

   使用する各組織に別名を定義すると、コマンドラインから異なる組織間を簡単に切り替えることができます。パッケージ開発サイクルを反復しながら異なる組織を承認できます。

   ヒント

3. スクラッチ組織を作成し、パッケージ化するアプリケーションを開発します。VS コードとスクラッチ組織の設定 UI を使用して、パッケージに含める要素を作成および取得します。expenser-app ディレクトリに移動して、次のコマンドを実行します。
4. すべてのパッケージコンポーネントが、パッケージを作成するプロジェクトディレクトリ内にあることを確認します。このワークフローの手順とコマンドをそのまま実行する場合は、次のステップに進む前に、メタデータを 1 つ以上追加する必要があります。
5. sfdx-project.json ファイルで、namespace 属性を使用して名前空間を指定します。例: “namespace”: “exp-mgr”

   ステップ 1 で Salesforce DX プロジェクトを作成したときに名前空間を指定した場合、この手順を省略できます。名前空間を追加する前に、名前空間を Dev Hub 組織にリンクしていることを確認してください。

6. Salesforce DX プロジェクトディレクトリから、パッケージを作成します。
   新しい 2GP 管理パッケージには、sfdx-project.json ファイルで指定した名前空間が設定されます。

   パッケージを作成した後で、名前空間を変更または追加したり、パッケージが関連付けられている Dev Hub を変更したりすることはできません。

   重要

7. sfdx-project.json ファイルを確認します。CLI により、パッケージディレクトリが含まれるようにプロジェクトファイルが自動的に更新され、パッケージ名に基づいて別名が作成されます。

   versionName と versionNumber のプレースホルダ値に注目してください。これらの値を更新したり、このパッケージが連動するベースパッケージを指示したりできます。作成した namespace がプロジェクトファイルに表示されます。

   スクラッチ組織定義ファイルなどの外部 .json ファイルを使用して、パッケージのメタデータに必要な機能や組織設定を指定します。force:package:version:create コマンドで --definitionfile フラグを使用して指定するか、sfdx-project.json ファイルで定義ファイルをリストできます。「パッケージのプロジェクト設定ファイル」を参照してください。

8. パッケージバージョンを作成します。この例では、パッケージメタデータが force-app ディレクトリにあることを前提としています。
9. スクラッチ組織にパッケージバージョンをインストールしてテストします。ステップ 3 で使用したものとは異なるスクラッチ組織を使用します。
10. パッケージがインストールされたら、スクラッチ組織を開き、パッケージを表示します。

パッケージバージョンは、「管理リリース済み」状態に昇格するまで「ベータ」です。「第二世代管理パッケージのリリース」を参照してください。