---

Quick start

General description

This project is a Gradle plugin that provides useful tasks for implement a Continuous Integration process for SalesForce projects.

How can you use this plugin?

Here you can find the enought required information to have running a Gradle project with Enforce.

1.Create build.gradle file on your source code project, below you have an example:

buildscript {
    repositories {
        mavenCentral()
        jcenter()
    }
    dependencies {
        classpath 'org.fundacionjala.gradle.plugins.enforce:enforce-gradle-plugin:1.1.5'
    }
}

apply plugin: 'enforce'
enforce {
	srcPath = 'src'
}

2.Register a Salesforce credential to be used

   $ gradle addCredential -Pid=default
			  	-Pusername=<USER NAME>
			  	-Ppassword=<PASSWORD>
			  	-Ptoken=<SECURITY TOKEN>

In this step is recomendable put credential id as default value, to run the EnForce tasks without using credentialId parameter.

Executing a task without credentialId parameter:

$ gradle <TASK NAME>

It uses the default credential.

Executing a task with credentialId parameter:

$ gradle <TASK NAME> -PcredentialId=<CREDENTIAL ID>

This credential will be saved in credentials.dat file located in user HOME directory.

3.Start executing available commands, for example, deploy all classes from your local repository to your organization.

   $ gradle deploy

Now you can start using all the Enforce features.

---

Reports

• These reports are generated on {PROJECT_FOLDER}/build/report/ after execute gradle runTest command.
• They are able to be integration with Jenkins enviroments

JUnit test result report

Configuration

• Select your job.
• Go to Configure -> Add post-build action
• Select Publish JUnit test result report option

Preview

Enforce code coverage and test result report

• Summary, contains charts with the coverage and test results.
• Unit Test, contains unit test execution results and also it has options to filter its results.
• Coverage, contains a list of all classes categorized by coverage status(Danger, Risk, Acceptable, Safe) and also it is possible to review the covered and uncovered lines by file(click on file name).

Configuration

• Select your job.
• Go to Configure -> Add post-build action
• Select Publish HTML reports option

Preview

---

Development

Requirements

• Java JDK or JRE, version 7 or higher.
• Gradle version 2.0 or higher.
• Internet access (configure Gradle if you are using a Proxy).

Using the plugin in your gradle build script

You can use your own gradle version but to avoid unexpected results with the compatibility we recommend to use the gradle wrapper. You can modify the build.gradle file and specify your version there.

It is desired a basic knowledge about Gradle and its plugin mechanism, as starting point you can review:

• Writing custom plugins
• Gradle Custom Plugin

Once you have the source code, open the source code in a console and execute:

   $ gradle wrapper

Please, make sure that your changes are not breaking any functionality running the unit test:

   $ ./gradlew test