With Gearset, you can:
create new unlocked package versions
install unlocked package versions into orgs
To get started, you'll need to connect your Dev Hub to Gearset. If you're having issues with unlocked packages, try re-authorizing your Dev Hub.
Creating a new unlocked package version
Gearset works best for VCS repositories that contain a single unlocked package and no other metadata.
Before you can create new unlocked package versions in Gearset, you'll need to:
create your package using
sf package create
To get started, head to the Packaging page in Gearset and select your Dev Hub. You'll see a list of all of the unlocked packages in your Dev Hub.
To create a new unlocked package version, click Create new package version next to the respective package.
The Dev Hub and package name will be pre-populated. Click Next.
Select the VCS repository and branch containing your new unlocked package version and click Compare.
Gearset will show all of the metadata in your VCS repository. Select the metadata to include in your package version. Assuming your VCS repository contains a single unlocked package and no other metadata, you'll need to select everything.
After selecting metadata, click Create unlocked package version.
Before creating the new package version, you'll need to enter a version name, version number, and optionally an installation key. You can also enter a deployment friendly name and deployment notes for your team.
Choose how to validate the new package version, and click Create package version.
Gearset will create the new unlocked package version in your Dev Hub. You can use the unlocked package ID (starting 04t) to install your new package version into an existing org or a new scratch org.
Installing an unlocked package
To get started, head to the Packaging page in Gearset and select your Dev Hub. You'll see a list of all of the unlocked packages in your Dev Hub.
To install an unlocked package into an org, click Install next to the respective package.
Choose a version of your unlocked package to install into your org and click Next.
If your unlocked package version requires an installation key, you'll see a key icon in the table. Enter your installation key before you click Next.
Select the org where you'll install the package and click Start installation.
Gearset will install the unlocked package into your org. This may take some time.
Once installation is complete, you'll see a success message.