andrewfayres commented on a change in pull request #13289: Initial website documentation for Java API URL: https://github.com/apache/incubator-mxnet/pull/13289#discussion_r235561175
########## File path: docs/install/java_setup.md ########## @@ -0,0 +1,111 @@ +# Setup the MXNet Package for Java + +The following instructions are provided for macOS and Ubuntu. Windows is not yet available. + +**Note:** If you use IntelliJ or a similar IDE, you may want to follow the [MXNet-Java on IntelliJ tutorial](../tutorials/java/mxnet_java_on_intellij.html) instead of these instructions. + +<hr> + +## Maven + +### Setup Instructions + +**Step 1.** Install dependencies: + +**macOS Steps** + +```bash +brew update +brew tap caskroom/versions +brew cask install java8 +brew install opencv +brew install maven +``` + +**Ubuntu Steps** + +These scripts will install Maven and its dependencies. You will be running the Scala scripts because the MXNet-Java project has a dependency on the MXNet-Scala project. + +```bash +wget https://raw.githubusercontent.com/apache/incubator-mxnet/master/ci/docker/install/ubuntu_core.sh +wget https://raw.githubusercontent.com/apache/incubator-mxnet/master/ci/docker/install/ubuntu_scala.sh +chmod +x ubuntu_core.sh +chmod +x ubuntu_scala.sh +sudo ./ubuntu_core.sh +sudo ./ubuntu_scala.sh +``` + +**Step 2.** Run the demo MXNet-Java project. + +Go to the [MXNet-Java demo project's README](https://github.com/apache/incubator-mxnet/tree/master/scala-package/mxnet-demo/java-demo) and follow the directions to test the MXNet-Java package installation. + +#### Maven Repository + +Package information can be found in the Maven Repository: +https://mvnrepository.com/artifact/org.apache.mxnet + +**Linux CPU** +```html +<!-- https://mvnrepository.com/artifact/org.apache.mxnet/mxnet-full_2.11-linux-x86_64-cpu --> +<dependency> + <groupId>org.apache.mxnet</groupId> + <artifactId>mxnet-full_2.11-linux-x86_64-cpu</artifactId> +</dependency> +``` + +**Linux GPU** +```html +<!-- https://mvnrepository.com/artifact/org.apache.mxnet/mxnet-full_2.11-linux-x86_64-gpu --> +<dependency> + <groupId>org.apache.mxnet</groupId> + <artifactId>mxnet-full_2.11-linux-x86_64-gpu</artifactId> +</dependency> +``` + +**macOS CPU** +```html +<!-- https://mvnrepository.com/artifact/org.apache.mxnet/mxnet-full_2.11-osx-x86_64-cpu --> +<dependency> + <groupId>org.apache.mxnet</groupId> + <artifactId>mxnet-full_2.11-osx-x86_64-cpu</artifactId> +</dependency> +``` + +**NOTE:** You may specify the version you wish to use by adding the version number to the `dependency` block. For example, to use v1.2.0 you would add `<version>1.2.0</version>`. Otherwise Maven will use the latest version available. + +<hr> + +## Source + +The previously mentioned setup with Maven is recommended. Otherwise, the following instructions for macOS, Ubuntu, and Windows are provided for reference only: + +| OS | Step 1 | Step 2 | +|---|---|---| +|macOS | [Shared Library for macOS](../install/osx_setup.html#build-the-shared-library) | [Scala Package for macOS](http://mxnet.incubator.apache.org/install/osx_setup.html#install-the-mxnet-package-for-scala) | +| Ubuntu | [Shared Library for Ubuntu](../install/ubuntu_setup.html#installing-mxnet-on-ubuntu) | [Scala Package for Ubuntu](http://mxnet.incubator.apache.org/install/ubuntu_setup.html#install-the-mxnet-package-for-scala) | +| Windows | [Shared Library for Windows](../install/windows_setup.html#build-the-shared-library) | <a class="github-button" href="https://github.com/apache/incubator-mxnet/issues/10549"; data-size="large" data-show-count="true" aria-label="Issue apache/incubator-mxnet on GitHub">Call for Contribution</a> | Review comment: Left it since it's a request for contribution. ---------------------------------------------------------------- This is an automated message from the Apache Git Service. To respond to the message, please log on GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: [email protected] With regards, Apache Git Services
