Salesforce DX Developer Guide

Release Notes
How Salesforce Developer Experience Changes the Way You Work
Enable Dev Hub Features in Your Org
Project Setup
Authorization
Metadata Coverage
Scratch Orgs
Sandboxes
Track Changes Between Your Project and Org
Development
Build and Release Your App
Create a First-Generation Managed Package using Salesforce DX
Second-Generation Managed Packages
Partner Licensing Platform (Developer Preview)
Unlocked Packages
What’s a Package
Package-Based Development Model
Before You Create Unlocked Packages
Know Your Orgs
Create Org-Dependent Unlocked Packages
Workflow for Unlocked Packages
Configure Packages
How We Handle Profile Settings in Unlocked Packages
Create a Package
Push a Package Upgrade
Install a Package
Migrate Deprecated Metadata from Unlocked Packages
Uninstall a Package
Transfer an Unlocked Package to a Different Dev Hub
Continuous Integration
Troubleshoot Salesforce DX
Limitations for Salesforce DX
PDF

Newer Version Available

This content describes an older version of this product. View Latest

Know Your Orgs

Some of the orgs that you use with unlocked packaging have a unique purpose.

Choose Your Dev Hub Org

Use the Dev Hub org for these purposes.
  • As owner of all unlocked packages
  • To link your namespaces if you want to create namespaced unlocked packages
  • To authorize and run your force:package commands

When you create an unlocked package using Salesforce CLI, you associate the package with a specific Dev Hub org. The Dev Hub org owns the package, and you can’t transfer package ownership from one Dev Hub org to another. When you’re ready to define and create a package for production use, be sure to create the package using the Dev Hub in one of your production orgs.

Namespace Org

If you are using a namespace, you’ll need a namespace org to acquire a package namespace. If you want to use the namespace strictly for testing, choose a disposable namespace.

After you create a namespace org and specify the namespace in it, open the Dev Hub org and link the namespace org to the Dev Hub org.

Other Orgs

When you work with packages, you also use these orgs:
  • You can create scratch orgs on the fly to use while testing your packages.
  • The target or installation org is where you install the package.