From version < 1.2 >
edited by Krzysztof Płachno
on 2017/06/24 13:17
To version < 2.1 >
edited by Krzysztof Płachno
on 2017/06/24 13:30
< >
Change comment: Documentation first version

Summary

Details

ExtensionCode.ExtensionClass[0]
Description
... ... @@ -1,1 +1,29 @@
1 -Extension extending Extension Module with possibility to import extension from Bintray repositories.
1 +Extension extending Extension Module with possibility to import extension from [[Bintray>>http://bintray.com/]] repositories.
2 +
3 +Bintray is a tool for exposing built artifacts. It aggregates functionalities of different repositories, e.g.: maven, npm, debian. It's possible to connect them separately in native way or together via unified Rest API - that provides e.g. searching functionality.
4 +
5 +**Extension Repository Connector - Bintray** - enables resolving and searching of artifacts from particular repo running on Bintray.
6 +Currently the extension allows to connect only maven repository (running on bintray). In the nearest future integration with npm repository is planned to be added.
7 +
8 +
9 +== Configuration ==
10 +{{info}}
11 +Bintray is only SAAS software - you cannot download it and run on private server. The consequence is that URLs for connection are predefined and they do not need to be specified in configuration.
12 + * In Bintray terminology - different bintray instances (accounts) are called **:subject** and different repositories on bintray instance are called **:repo**. These two identifiers are enough to identify repository
13 + * Example: the "**jcenter**" (:repo) is a maven repository running on Bintray instance called "**bintray**" (:subject)
14 +{{/info}}
15 +
16 +=== Configuration in {{code}}xwiki.properties{{/code}}
17 +
18 +{{code language="properties"}}
19 +extension.repositories.bintray.maven=<privateBintrayMavenId>:<:subject>:<:repo>
20 +{{/code}}
21 +
22 +=== Example - connection with **JCenter** ===
23 +{{code language="properties"}}
24 +extension.repositories.bintray.maven=jCenter:bintray:jcenter
25 +{{/code}}
26 +
27 +
28 +== Usage ==
29 +Typical use case of **Extension Repository Connector - Bintray** is to connect jCenter and to install general-purpose Java libraries (not necesarily XWiki components!) to be later used in e.g. groovy scripts.
Show installed count
... ... @@ -1,0 +1,1 @@
1 +Yes
cogExtension extending Extension Module with possibility to import extension from Bintray repositories.
TypeJAR
Categoryrepository
Developed by

Krzysztof Płachno, Thomas Mortagne

Rating
Rate!
0 Votes
LicenseGNU Lesser General Public License 2.1

Installable with the Extension Manager

Description

Extension extending Extension Module with possibility to import extension from Bintray repositories.

Extension extending Extension Module with possibility to import extension from Bintray repositories.

Bintray is a tool for exposing built artifacts. It aggregates functionalities of different repositories, e.g.: maven, npm, debian. It's possible to connect them separately in native way or together via unified Rest API - that provides e.g. searching functionality.

Extension Repository Connector - Bintray - enables resolving and searching of artifacts from particular repo running on Bintray.
Currently the extension allows to connect only maven repository (running on bintray). In the nearest future integration with npm repository is planned to be added.

Configuration

Bintray is only SAAS software -  you cannot download it and run on private server. The consequence is that URLs for connection are predefined and they do not need to be specified in configuration.

  • In Bintray terminology - different bintray instances (accounts) are called :subject and different repositories on bintray instance are called :repo. These two identifiers are enough to identify repository
  • Example:  the "jcenter" (:repo) is a maven repository  running on Bintray instance called "bintray" (:subject)

Configuration in xwiki.properties

extension.repositories.bintray.maven=:<:subject>:<:repo>

Example - connection with JCenter

extension.repositories.bintray.maven=jCenter:bintray:jcenter

Usage

Typical use case of Extension Repository Connector - Bintray is to connect jCenter and to install general-purpose Java libraries (not necesarily XWiki components!) to be later used in e.g. groovy scripts.

Prerequisites & Installation Instructions

We recommend using the Extension Manager to install this extension (Make sure that the text "Installable with the Extension Manager" is displayed at the top right location on this page to know if this extension can be installed with the Extension Manager). Note that installing Extensions when being offline is currently not supported and you'd need to use some complex manual method.

You can also use the manual method which involves dropping the JAR file and all its dependencies into the WEB-INF/lib folder and restarting XWiki.

Dependencies

Dependencies for this extension (org.xwiki.contrib:repository-bintray 1.0):

Get Connected