Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.
The Ant Migration Tool is retired with Spring ’24. The tool continues to
function as-is for future API versions but isn’t updated with new functionality and isn’t
supported. If Salesforce adds a new feature that is incompatible with Ant, the Ant Migration
Tool won't be updated to support it. To manage metadata changes, switch to Salesforce CLI for a
modern, supported developer experience.
To retrieve Lightning Platform components:
- Open a command prompt.
- Run Ant by specifying a target name in build.xml. If it’s the first time
you’re running Ant, use ant retrieveUnpackaged to
retrieve unpackaged components specified in package.xml.
- The sample build.xml contains some useful targets for various
retrieve() and deploy() options that
you can modify or use as is. To see a list of all your named targets in build.xml,
enter ant -p at the command line.
- You can deploy or retrieve up to 10,000 files at once. The maximum size of the deployed or
retrieved .zip file is 39 MB. If the files are uncompressed in an unzipped folder, the
size limit is 600 MB or 629,145,600 bytes. The size limit in bytes is calculated as 600 x
1024 x 1024. If you’re working with many components, use the listMetadata target to identify the subset of
files that you want to retrieve. You can also retrieve batches of components as described
in Retrieving Components in Bulk.
j