mirror of
https://github.com/wahyd4/jabba.git
synced 2026-08-09 12:56:36 +10:00
206 lines
7.5 KiB
Markdown
206 lines
7.5 KiB
Markdown
# jabba  [](https://travis-ci.org/shyiko/jabba)
|
|
|
|
|
|
|
|
Java Version Manager inspired by [nvm](https://github.com/creationix/nvm) (Node.js) / [rvm](https://rvm.io) (Ruby).
|
|
|
|
Supports installation of [Oracle JDK](http://www.oracle.com/technetwork/java/javase/archive-139210.html) (default) / [Server JRE](http://www.oracle.com/technetwork/java/javase/downloads/server-jre8-downloads-2133154.html),
|
|
[Zulu OpenJDK](http://zulu.org/) (since 0.3.0), [IBM SDK, Java Technology Edition](https://developer.ibm.com/javasdk/) (since 0.6.0) and from custom URLs.
|
|
|
|
It's written in [Go](https://golang.org/) to make maintenance easier (significantly shorter, easier to understand and less prone to errors
|
|
compared to pure shell implementation). Plus it enables us to support Windows natively (no need for Cygwin) without rewriting
|
|
the whole thing in PowerShell or whatever.
|
|
|
|
The goal is to provide unified pain-free experience of **installing** (and **switching** between different versions of) JDK regardless of
|
|
the OS.
|
|
|
|
> **jabba** has a single responsibility - managing different versions of JDK. For an easy way to install Scala/Kotlin/Groovy (+ a lot more) see [SDKMAN][0].
|
|
SBT/Maven/Gradle should <u>ideally</u> be "fixed in place" by [sbt-launcher][1]/[mvnw][2]/[gradlew][3].
|
|
|
|
[0]: http://sdkman.io/
|
|
[1]: http://www.scala-sbt.org/0.13/docs/Manual-Installation.html
|
|
[2]: https://github.com/shyiko/mvnw
|
|
[3]: https://docs.gradle.org/current/userguide/gradle_wrapper.html
|
|
|
|
## Installation
|
|
|
|
#### macOS / Linux
|
|
|
|
> (in bash/zsh/...)
|
|
|
|
```sh
|
|
curl -sL https://github.com/shyiko/jabba/raw/master/install.sh | bash && . ~/.jabba/jabba.sh
|
|
```
|
|
|
|
> (use the same command to upgrade)
|
|
|
|
> In [fish](https://fishshell.com/) command looks a little bit different -
|
|
`curl -sL https://github.com/shyiko/jabba/raw/master/install.sh | bash; and . ~/.jabba/jabba.fish`
|
|
|
|
> If you don't have `curl` installed - replace `curl -sL` with `wget -qO-`.
|
|
|
|
> If you are behind a proxy see -
|
|
[curl](https://curl.haxx.se/docs/manpage.html#ENVIRONMENT) /
|
|
[wget](https://www.gnu.org/software/wget/manual/wget.html#Proxies) manpage.
|
|
Usually simple `http_proxy=http://proxy-server:port https_proxy=http://proxy-server:port curl -sL ...` is enough.
|
|
|
|
#### Docker
|
|
|
|
While you can obviously use the same snippet as above, chances are you don't want jabba binary & shell
|
|
integration script(s) to be included in the final Docker image, all you want is a JDK. In this case
|
|
use the following `Dockerfile` (this is just an example; adjust if needed) (when `JABBA_COMMAND` env variable is set
|
|
`install.sh` downloads `jabba` binary, executes specified command and then deletes the binary)
|
|
|
|
```dockerfile
|
|
FROM buildpack-deps:jessie-curl
|
|
|
|
# Server JRE (https://goo.gl/2MsPoh)
|
|
ENV JAVA_VERSION "sjre@1.8.121"
|
|
|
|
RUN curl -sL https://github.com/shyiko/jabba/raw/master/install.sh | \
|
|
JABBA_COMMAND="install $JAVA_VERSION" bash
|
|
|
|
ENV JAVA_HOME /root/.jabba/jdk/$JAVA_VERSION
|
|
ENV PATH $JAVA_HOME/bin:$PATH
|
|
```
|
|
|
|
> (build & run as usual)
|
|
|
|
```sh
|
|
$ docker build -t sjre:1.8.121 .
|
|
|
|
$ docker run -it --rm sjre:1.8.121 java -version
|
|
|
|
java version "1.8.0_121"
|
|
Java(TM) SE Runtime Environment (build 1.8.0_121-b13)
|
|
Java HotSpot(TM) 64-Bit Server VM (build 25.121-b13, mixed mode)
|
|
```
|
|
|
|
#### Windows 10
|
|
|
|
> (in powershell)
|
|
|
|
```powershell
|
|
Invoke-Expression (
|
|
wget https://github.com/shyiko/jabba/raw/master/install.ps1 -UseBasicParsing
|
|
).Content
|
|
```
|
|
|
|
> (use the same command to upgrade)
|
|
|
|
## Usage
|
|
|
|
```sh
|
|
# install Oracle JDK
|
|
jabba install 1.8 # "jabba use 1.8" will be called automatically
|
|
|
|
# install Zulu OpenJDK (since 0.3.0)
|
|
jabba install zulu@1.8.72
|
|
|
|
# install IBM SDK, Java Technology Edition (since 0.6.0)
|
|
jabba install ibm@1.8.0-3.21
|
|
|
|
# install from custom URL (supported qualifiers: zip (since 0.3.0), tgz, dmg, bin)
|
|
jabba install 1.8.0-custom=tgz+http://example.com/distribution.tar.gz
|
|
jabba install 1.8.0-custom=zip+file:///opt/distribution.zip
|
|
|
|
# link system JDK
|
|
jabba link system@1.8.72 /Library/Java/JavaVirtualMachines/jdk1.8.0_72.jdk
|
|
|
|
# list all installed JDK's
|
|
jabba ls
|
|
|
|
# switch to a different version of JDK
|
|
jabba use 1.6.65
|
|
|
|
echo "1.8" > .jabbarc
|
|
# switch to the JDK specified in .jabbarc (since 0.5.0)
|
|
jabba use
|
|
|
|
# list available JDK's
|
|
jabba ls-remote
|
|
|
|
# set default java version on shell (since 0.2.0)
|
|
# this version will automatically be "jabba use"d every time you open up a new terminal
|
|
jabba alias default 1.6.65
|
|
```
|
|
|
|
> `.jabbarc` has to be a valid YAML file. JDK version can be specified as `jdk: 1.8` or simply as `1.8`
|
|
(same as `~1.8`, `1.8.x` `">=1.8.0 <1.9.0"` (mind the quotes)).
|
|
|
|
> jsyk: **jabba** keeps everything under `~/.jabba` (on Linux/Mac OS X) / `%USERPROFILE%/.jabba` (on Windows). If at any point of time you decide to uninstall **jabba** - just remove this directory.
|
|
|
|
For more information see `jabba --help`.
|
|
|
|
## Development
|
|
|
|
> PREREQUISITE: [go1.8](https://github.com/moovweb/gvm)
|
|
|
|
```sh
|
|
git clone https://github.com/shyiko/jabba $GOPATH/src/github.com/shyiko/jabba
|
|
cd $GOPATH/src/github.com/shyiko/jabba
|
|
make fetch
|
|
|
|
go run jabba.go
|
|
|
|
# to test a change
|
|
make test # or "test-coverage" if you want to get a coverage breakdown
|
|
|
|
# to make a build
|
|
make build # or "build-release" (latter is cross-compiling jabba to different OSs/ARCHs)
|
|
```
|
|
|
|
## FAQ
|
|
|
|
**Q**: What if I already have `java` installed?
|
|
|
|
A: It's fine. You can switch between system JDK and `jabba`-provided one whenever you feel like it (`jabba use ...` / `jabba deactivate`).
|
|
They are not gonna conflict with each other.
|
|
|
|
**Q**: How do I switch `java` globally?
|
|
|
|
A: **jabba** doesn't have this functionality built-in because the exact way varies greatly between the operation systems and usually
|
|
involves elevated permissions. But. Here are the snippets that <u>should</u> work:
|
|
|
|
* Windows
|
|
|
|
> (in powershell as administrator)
|
|
|
|
```
|
|
# select jdk
|
|
jabba use ...
|
|
|
|
# modify global PATH & JAVA_HOME
|
|
$envRegKey = [Microsoft.Win32.Registry]::LocalMachine.OpenSubKey('SYSTEM\CurrentControlSet\Control\Session Manager\Environment', $true)
|
|
$envPath=$envRegKey.GetValue('Path', $null, "DoNotExpandEnvironmentNames").replace('%JAVA_HOME%\bin;', '')
|
|
[Environment]::SetEnvironmentVariable('JAVA_HOME', "$(jabba which $(jabba current))", 'Machine')
|
|
[Environment]::SetEnvironmentVariable('PATH', "%JAVA_HOME%\bin;$envPath", 'Machine')
|
|
```
|
|
|
|
* Linux
|
|
|
|
> (tested on Debian/Ubuntu)
|
|
|
|
```
|
|
# select jdk
|
|
jabba use ...
|
|
|
|
sudo update-alternatives --install /usr/bin/java java ${JAVA_HOME%*/}/bin/java 20000
|
|
sudo update-alternatives --install /usr/bin/javac javac ${JAVA_HOME%*/}/bin/javac 20000
|
|
```
|
|
|
|
> To switch between multiple GLOBAL alternatives use `sudo update-alternatives --config java`.
|
|
|
|
## License
|
|
|
|
[Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0)
|
|
|
|
By using this software you agree to
|
|
- [Oracle Binary Code License Agreement for the Java SE Platform Products and JavaFX](http://www.oracle.com/technetwork/java/javase/terms/license/index.html)
|
|
- [Oracle Technology Network Early Adopter Development License Agreement](http://www.oracle.com/technetwork/licenses/ea-license-noexhibits-1938914.html) in case of EA releases
|
|
- Apple's Software License Agreement in case of "Java for OS X"
|
|
- [International License Agreement for Non-Warranted Programs](http://www14.software.ibm.com/cgi-bin/weblap/lap.pl?la_formnum=&li_formnum=L-PMAA-A3Z8P2&l=en) in case of IBM SDK, Java Technology Edition.
|
|
|
|
This software is for educational purposes only.
|
|
Use it at your own risk.
|