This is an automated email from the ASF dual-hosted git repository. tison pushed a commit to branch main in repository https://gitbox.apache.org/repos/asf/incubator-opendal.git
The following commit(s) were added to refs/heads/main by this push: new 72a518a0 chore(bindings/java): post release 0.1.0 (#2352) 72a518a0 is described below commit 72a518a0f55db025de94877e1ca2c132337ee8a7 Author: tison <wander4...@gmail.com> AuthorDate: Sun May 28 22:05:08 2023 +0800 chore(bindings/java): post release 0.1.0 (#2352) Signed-off-by: tison <wander4...@gmail.com> --- bindings/java/README.md | 80 ++++++++++++++++++++++++++++++------------------- bindings/java/pom.xml | 5 ++-- 2 files changed, 52 insertions(+), 33 deletions(-) diff --git a/bindings/java/README.md b/bindings/java/README.md index 20487535..59a52792 100644 --- a/bindings/java/README.md +++ b/bindings/java/README.md @@ -1,41 +1,59 @@ # OpenDAL Java Bindings -## Usage +[](https://central.sonatype.com/search?q=opendal-java&smo=true) +[](https://opendal.apache.org/docs/java/) -You can use the package by adding the dependency as following: + +## Getting Started + +This project is built upon the native OpenDAL lib. And it is released for multiple platforms that you can use a classifier to specify the platform you are building the application on. + +Generally, you can first add the `os-maven-plugin` for automatically detect the classifier based on your platform: + +```xml +<build> + <extensions> + <extension> + <groupId>kr.motd.maven</groupId> + <artifactId>os-maven-plugin</artifactId> + <version>1.7.0</version> + </extension> + </extensions> +</build> +``` + +Then add the dependency to `opendal-java` as following: ```xml -<project> - <repositories> +<dependency> + <groupId>org.apache.opendal</groupId> + <artifactId>opendal-java</artifactId> + <version>${opendal.version}</version> + <classifier>${os.detected.classifier}</classifier> +</dependency> +``` + +If you'd rather like the latest snapshots of the upcoming major version, use ASF Maven snapshot repository: + +```xml +<repositories> <repository> - <id>apache.snapshots</id> - <name>Apache Snapshot Repository</name> - <url>https://repository.apache.org/snapshots</url> - <releases> - <enabled>true</enabled> - </releases> + <id>apache.snapshots</id> + <name>Apache Snapshot Repository</name> + <url>https://repository.apache.org/snapshots</url> </repository> - </repositories> - - <dependencies> - <dependency> - <groupId>org.apache.opendal</groupId> - <artifactId>opendal-java</artifactId> - <version>0.1.0-SNAPSHOT</version> - <classifier>${os.detected.classifier}</classifier> - </dependency> - </dependencies> - - <build> - <extensions> - <extension> - <groupId>kr.motd.maven</groupId> - <artifactId>os-maven-plugin</artifactId> - <version>1.7.0</version> - </extension> - </extensions> - </build> -</project> +</repositories> +``` + +... and declare the appropriate dependency version: + +```xml +<dependency> + <groupId>org.apache.opendal</groupId> + <artifactId>opendal-java</artifactId> + <version>${opendal.snapshot-version}</version> + <classifier>${os.detected.classifier}</classifier> +</dependency> ``` ## Build diff --git a/bindings/java/pom.xml b/bindings/java/pom.xml index 69cb5c22..2bac6b26 100644 --- a/bindings/java/pom.xml +++ b/bindings/java/pom.xml @@ -32,7 +32,7 @@ <groupId>org.apache.opendal</groupId> <artifactId>opendal-java</artifactId> - <version>0.1.0-SNAPSHOT</version> + <version>0.2.0-SNAPSHOT</version> <url>https://opendal.apache.org</url> <mailingLists> @@ -61,6 +61,7 @@ <maven-surefire-plugin.version>3.0.0</maven-surefire-plugin.version> <exec-maven-plugin.version>3.1.0</exec-maven-plugin.version> + <os-maven-plugin.version>1.7.0</os-maven-plugin.version> <spotless.version>2.37.0</spotless.version> </properties> @@ -151,7 +152,7 @@ <extension> <groupId>kr.motd.maven</groupId> <artifactId>os-maven-plugin</artifactId> - <version>1.7.0</version> + <version>${os-maven-plugin.version}</version> </extension> </extensions>