Getting started with Java

All components of this SDK are distributed as Maven packages from Trimble’s eTools Artifactory repository. Below is the list of things you will need before you can get started with the SDKs.

OKTA login is required to access most of the articles below. If you cannot get to any of the sites below, please reach out to the Trimble Cloud Support.

To get a copy of SDK packages

Login to the E-Tools Artifactory.
Configure the trimblecloudplatform-engagement-maven repository in your Maven settings.xml file. You will need to add the repository URL and credentials (username and password) to your settings.xml file. You can either add the repository globally or for a specific project.
- Locate your Maven installation directory and find the settings.xml file.
- Add a new server element under the servers section, with the ID of the repository, username and password.’
Terminal window
```
<settings>
    <servers>
        <server>
            <id>repo-id</id>
            <username>${security.getCurrentUsername()}</username> <password>${security.getEscapedEncryptedPassword()!"*** Insert encrypted password here ***"}</password>
        </server>
    </servers>
</settings>
```
- Add a new repository element under the repositories section, with the ID and the URL of the repository.
Terminal window
```
<repositories>
    <repository>
        <id>repo-id</id>
        <url> https://artifactory.trimble.tools/artifactory/trimblecloudplatform-engagement-maven </url>
    </repository>
</repositories>
```
Add the dependencies to your project’s pom.xml file. Add a new dependency element under the dependencies section, with the group ID, artifact ID, and version of the dependency you want to use. All Trimble Cloud Platform Java SDKs are under the group ID - “trimblecloud”.

<dependency>
    <groupId>trimblecloud</groupId>
    <artifactId>trimblecloud-events</artifactId>
    <version>1.0.0</version>
</dependency>