salesforce-devkit-project

The repository can be used to initiate a new Salesforce.com development project. It uses ant-salesforce and git.

Note about Salesforce Developer Experience (DX)

The repository was an attempt to use git in the Salesforce.com development life-cycle before Salesforce DX was announced. Salesforce Developer Experience (DX) is a new way to manage and develop apps on the Force.com platform across their entire life cycle. It brings together the best of Force.com to enable source-driven development, team collaboration with governance, and new levels of agility for custom app development on Salesforce.

Go through Get Started with Salesforce DX trailhead for more information.

Reference links:

1. Force.com Migration Tool Guide
2. Metadata API Developer Guide
3. Apace Ant

Configuration

1. Clone the repositary
2. Enter Salesforce Connection Information in master.properties file. The file will be used in master branch. See Entering Salesforce Connection Information at Force.com Migration Tool Guide for more information.
3. Create new git branch, e.g. dev or feture1
4. Copy master.properties to <branch name>.properties
5. Enter Salesforce Connection Information in the just created .properties file.

You have to create seporate *.properties file per each branch. So the brnaches will linked to the specific salesforce.com instance.

Note: The *.properties files are added to .gitignore

Usage

ant <target>

Ant targets:

1. deploy - deploys changes to the Salesforce.com instance
2. remove - deploys destructiveChanges.xml to to the Salesforce.com instance. See Deleting Components from an Organization at Metadata API Developer Guide
3. retrieve - refreshs src folder by retrieving Metadata from Salesforce.com instance to the the temp folder .src, delete src folder and rename .src to src
4. commit - Commits changes with "Deployment: ${git.message}" message
5. push - runs deploy, remove, retrieve and commit.