erik/kobalt-doc
erik/kobalt-doc
1
0
Fork 0
mirror of https://github.com/ethauvin/kobalt-doc.git synced 2025-04-25 20:07:11 -07:00
Code Releases Activity

Document Maven coordinates.

Browse source
This commit is contained in:
Cedric Beust 2016-03-27 18:33:16 -07:00
parent 2f13998e85
commit c1771bb98f
1 changed files with 45 additions and 18 deletions
Download patch file Download diff file Expand all files Collapse all files

27
documentation/index.html
View file

@ -216,6 +216,8 @@ dependencies {
} }
</pre> </pre>
<h4 class="section" indent="2" id="dependency-types">Dependency types</h4>
<p> <p>
There are various kinds of dependencies: There are various kinds of dependencies:
</p> </p>
@ -232,11 +234,36 @@ dependencies {
(<code>"groupId:artifactId:"</code>).</dd> (<code>"groupId:artifactId:"</code>).</dd>
</dl> </dl>
<h4 class="section" indent="2" id="dependency-versions">Dependency versions</h4>
<p>
Kobalt lets you specify Maven coordinates in one line, such as <code>"org.testng:testng:6.9.10"</code>. Note that Kobalt uses the <a href="https://maven.apache.org/pom.html#Maven_Coordinates">Maven Coordinates defined in the Maven specification</a>, which are a little bit different from the ones that Gradle uses.
</p>
<p>
The standard format for such coordinates, as explained in the link above, is:
</p>
<pre>
groupId:artifactId:packaging:classifier:version</pre>
<p>
<code>packaging</code> and <code>classifier</code> are optional and can be omitted. If <code>version</code>
is omitted, Kobalt will resolve the artifact to its latest version from all the specified repos.
Most of the time, you will only specify <code>groupId</code>, <code>artifactId</code> and <code>version</code>, but if you ever need to specify additional components such as <code>packaging</code> (sometimes referred to as "<code>extension</code>") or <code>classifier</code>,
please take note that these should appear before the version number.
</p>
<p>
For example, here is a Maven coordinate specifying a classifier:
</p>
<pre>
# No version, resolves to the latest
org.testng:testng:
# Specifies an extension and a qualifier
com.badlogicgames.gdx:gdx-platform:jar:natives-desktop:1.9.2</pre>
<h2 class="section" id="settings">Settings</h2> <h2 class="section" id="settings">Settings</h2>
<p> <p>
You can define settings that will apply to all your Kobalt builds by creating You can define settings that will apply to all your Kobalt builds by creating
the file <code>~/.config/kobalt/settings.xml</code>: the file <code>~/.config/kobalt/settings.xml</code>:
</p> </p>
<pre class="brush:plain"> <pre class="brush:plain">
&lt;kobalt-settings&gt; &lt;kobalt-settings&gt;
&lt;localRepo&gt;/Users/beust/my-kobalt-repo&lt;/localRepo&gt; &lt;localRepo&gt;/Users/beust/my-kobalt-repo&lt;/localRepo&gt;