ロック解除済みパッケージの作成、テスト、リリース

他の Salesforce DX プロジェクトと同様に、まず自分のスクラッチ組織で作業を開始します。対象の環境でパッケージを構築してインストールする前に、アプリケーションを実行してテストできます。

1. GIFter ディレクトリにいることを確認します。
   GIFter プロジェクトには、そのまま使用できるスクラッチ組織設定ファイルが用意されています。
2. まだ Dev Hub 組織に接続していない場合は、Dev Hub 組織にログインします。
   

   sf org login web --set-default-dev-hub --alias DevHub

3. スクラッチ組織を作成します。
   

   sf org create scratch --set-default --definition-file config/project-scratch-def.json

   次のような応答が表示されます。
   

   Your scratch org is ready.

   これで、使用可能なスクラッチ組織が作成され、プロジェクトワークスペースのデフォルトとして設定されました。
4. 次に、force-app フォルダーから新しく作成したスクラッチ組織にすべてのソースをリリースします。
   

   sf project deploy start

   組織にリリースされたすべてのソースのリストが表示されます。
   

   === Pushed Source
   STATE  FULL NAME                             TYPE                  PROJECT PATH
   ─────  ────────────────────────────────────  ────────────────────  ─────────────────────────────────────────────────────────────────────────
   Add    GIFter                                CustomApplication     force-app/main/default/applications/GIFter.app-meta.xml
   Add    SearchGIPHY/SearchGIPHY.auradoc       AuraDefinitionBundle  force-app/main/default/aura/SearchGIPHY/SearchGIPHY.auradoc
   Add    SearchGIPHY/SearchGIPHY.cmp           AuraDefinitionBundle  force-app/main/default/aura/SearchGIPHY/SearchGIPHY.cmp
   Add    SearchGIPHY/SearchGIPHY.cmp           AuraDefinitionBundle  force-app/main/default/aura/SearchGIPHY/SearchGIPHY.cmp-meta.xml
   Add    SearchGIPHY/SearchGIPHY.css           AuraDefinitionBundle  force-app/main/default/aura/SearchGIPHY/SearchGIPHY.css
   Add    SearchGIPHY/SearchGIPHY.design        AuraDefinitionBundle  force-app/main/default/aura/SearchGIPHY/SearchGIPHY.design
   Add    SearchGIPHY/SearchGIPHY.svg           AuraDefinitionBundle  force-app/main/default/aura/SearchGIPHY/SearchGIPHY.svg
   Add    SearchGIPHY/SearchGIPHYController.js  AuraDefinitionBundle  force-app/main/default/aura/SearchGIPHY/SearchGIPHYController.js
   Add    SearchGIPHY/SearchGIPHYHelper.js      AuraDefinitionBundle  force-app/main/default/aura/SearchGIPHY/SearchGIPHYHelper.js
   Add    SearchGIPHY/SearchGIPHYRenderer.js    AuraDefinitionBundle  force-app/main/default/aura/SearchGIPHY/SearchGIPHYRenderer.js
   Add    ChatterHelper                         ApexClass             force-app/main/default/classes/ChatterHelper.cls
   Add    ChatterHelper                         ApexClass             force-app/main/default/classes/ChatterHelper.cls-meta.xml
   Add    GIPHY                                 CspTrustedSite        force-app/main/default/cspTrustedSites/GIPHY.cspTrustedSite-meta.xml
   Add    GIFter                                FlexiPage             force-app/main/default/flexipages/GIFter.flexipage-meta.xml
   Add    GIFter_UtilityBar                     FlexiPage             force-app/main/default/flexipages/GIFter_UtilityBar.flexipage-meta.xml
   Add    GIFter                                PermissionSet         force-app/main/default/permissionsets/GIFter.permissionset-meta.xml
   Add    GiphyMedia0                           RemoteSiteSetting     force-app/main/default/remoteSiteSettings/GiphyMedia0.remoteSite-meta.xml
   Add    GiphyMedia1                           RemoteSiteSetting     force-app/main/default/remoteSiteSettings/GiphyMedia1.remoteSite-meta.xml
   Add    GIPHY                                 StaticResource        force-app/main/default/staticresources/GIPHY.resource
   Add    GIPHY                                 StaticResource        force-app/main/default/staticresources/GIPHY.resource-meta.xml
   Add    jquery360                             StaticResource        force-app/main/default/staticresources/jquery360.js
   Add    jquery360                             StaticResource        force-app/main/default/staticresources/jquery360.resource-meta.xml
   Add    GIFter                                CustomTab             force-app/main/default/tabs/GIFter.tab-meta.xml

   ソースの中に、構築する GIFter アプリケーションへのアクセス権を管理するために使用する権限セットがあります (GIFter という名前です)。
5. 組織のデフォルトユーザーをこの権限セットに割り当てます。
   

   sf org assign permset --name GIFter

   === Permsets Assigned
   USERNAME                       PERMISSION SET ASSIGNMENT
   ─────────────────────────────  ─────────────────────────
   test-ou0arkv1qbow@example.com  GIFter

6. では、アプリケーションを開いて試してみましょう。
   
   組織を開いてアプリケーションランチャーから GIFter を参照することもできますが、ここではさらに 1 歩進んで、GIFter を直接開いてみます。
   

   sf org open --path lightning/n/GIFter

   [GIPHY Search Terms (GIPHY 検索語)] に「funny animals (面白い動物)」と入力した場合、表示は次のようになります。
7. アプリケーションを試してみましょう。お楽しみください。

これで、アプリケーションが期待どおりに機能することを確認できました。次に、パッケージを作成しましょう。

パッケージには 2 つの部分があります。1 つはパッケージで、もう 1 つはパッケージバージョンです。

パッケージは、実際に何を作成するかを示すマニフェストで、パッケージバージョンは、ある時点で構築およびインストールしている内容に関するメタデータとコードのスナップショットです。

そのため、最初のステップは、パッケージを作成し、名前や説明など、変更される可能性の低い情報を指定することです。さらに、作成するパッケージの種類も選択します。この場合は、ロック解除済みパッケージです。

1. 任意のテキストエディター でsfdx-project.json を開きます。
   
   GIFter は、いつでも変更できるオープンソースのプロジェクトです。この手順を確実に完了させるために、開始時のプロジェクトファイルを次のようなものにします。
   

   {
     "packageDirectories": [
       {
         "path": "force-app",
         "default": true
       }
     ],
     "namespace": "",
     "sfdcLoginUrl": "https://login.salesforce.com",
     "sourceApiVersion": "55.0"
   }

2. 必要に応じて、id、versionName、versionNumber など既存のパラメーターをいくつか削除します。Salesforce CLI のバージョンと一致するように sourceApiVersion を更新します。忘れずに保存しましょう。
   
   
3. パッケージを作成します。
   

   sf package create --name GIFter --description "Using GIPHY to find GIFs and post to Chatter" --path force-app --package-type Unlocked --target-dev-hub DevHub

これで、パッケージの別名 (GIFter) がパッケージ ID (0Ho) に関連付けられます。

=== Ids
NAME                  VALUE
───────────────────── ──────────────────
Package Id           0Hoxxx

 パッケージの別名またはパッケージ ID を忘れても、sf package list を実行すれば、Dev Hub で作成したすべてのパッケージをリストできます。

TP (または、実際の場合は Sandbox や本番組織) にパッケージをインストールする前に、常にまず、新しく作成したスクラッチ組織でテストすることをお勧めします。そこで、以前に実行したいくつかのステップを繰り返しましょう。ただし今回は、直前に作成したパッケージバージョンを使用してアプリケーションをスクラッチ組織にインストールします。

アプリケーションは期待どおりに動作しました。[Setup (設定)] に移動して [Installed Packages (インストール済みパッケージ)] を選択すると、GIFter パッケージがインストールされていることを確認できます。

いいですね! いよいよ、Trailhead Playground にインストールします。