JarCastingDigger Java client
A java integration library for AeroGear Digger
Project Info
| Project Info | |
|---|---|
| License: | Apache License, Version 2.0 |
| Build: | Maven |
| Documentation: | https://github.com/aerogear/aerogear-digger-java-client |
| Issue tracker: | https://issues.jboss.org/browse/AGDIGGER |
| Mailing lists: | aerogear-users (subscribe) |
| aerogear-dev (subscribe) | |
| IRC: | #aerogear channel in the freenode network. |
Getting started
For now, clone the repository and run the build:
mvn clean install
Add the following dependencies to your pom.xml file:
<dependency>
<groupId>org.jboss.aerogear</groupId>
<artifactId>digger-java-client</artifactId>
<version>1.1.0</version>
</dependency>
Usage
Build a default client:
DiggerClient client = DiggerClient.createDefaultWithAuth("https://digger.com", "admin", "password");
Build a customized client:
DiggerClient client = DiggerClient.builder()
.jobService(new JobService())
.buildService(new BuildService(10000, 100))
.artifactsService(artifactsService)
.withAuth("https://digger.com", "admin", "password")
.build();
Create job:
client.createJob("java-client-job1","https://github.com/wtrocki/helloworld-android-gradle","master");
The client supports setting clean-up values for jobs in relation to the number of days to store builds and artifacts and the total number of builds and artifacts to keep.
Create a job with clean-up policy:
import org.aerogear.digger.client.model.BuildDiscarder
BuildDiscarder buildDiscarder = new BuildDiscarder();
buildDiscarder.setStoreBuildsDays(7)
client.createJob("java-client-job1","https://github.com/wtrocki/helloworld-android-gradle","master", buildDiscarder);
The client supports passing a list of build parameters. To create a job with build params:
import org.aerogear.digger.client.model.BuildParameter;
public static final BuildParameter EXAMPLE = new BuildParameter(EXAMPLE)
.setDescription("Branch of project to checkout and build.")
.setDefaultValue("master");
private List<BuildParameter> params = Lists.newArrayList(EXAMPLE)
client.createJob("java-client-job1","https://github.com/wtrocki/helloworld-android-gradle","master", params);
Trigger a job:
BuildStatus buildStatus = client.build("java-client-job1");
Get build logs:
int buildNumber = 4;
String logs = client.getBuildLogs("java-client-job1", buildNumber);
Save artifacts to file
int buildNumber = 4;
String artifactName="*.apk"
File outputFile = ...
client.saveArtifact("java-client-job1", buildNumber,artifactName, outputFile);
Requirements
Client works with Java6 and above.
Building
mvn clean package
