step.yml

title: Set Java version
summary: This Step helps you activate pre-installed Java (JDK) version on the build virtual machine.
description: |
  This Step is not supposed to install any Java version on the fly. You can only pick from the already installed versions.
  If you want to install other Java versions, check out [Using a Java version not installed on our Android stacks](https://devcenter.bitrise.io/infrastructure/virtual-machines/#using-a-java-version-not-installed-on-our-android-stacks).

  ### Configuring the Step
  1. In the **Java version to be set globally for the build** input, select an installed Java version you wish to use during the build run.

  ### Troubleshooting
  If the Step fails to set the Java version, you can use these [scripts](https://devcenter.bitrise.io/infrastructure/virtual-machines/#managing-java-versions) as a temporary workaround.

  ### Useful links
  - [Managing Java versions on Bitrise](https://devcenter.bitrise.io/infrastructure/virtual-machines/#managing-java-versions)
website: https://github.com/bitrise-steplib/bitrise-step-set-java-version
source_code_url: https://github.com/bitrise-steplib/bitrise-step-set-java-version
support_url: https://github.com/bitrise-steplib/bitrise-step-set-java-version/issues

type_tags:
- utility

is_always_run: false
is_skippable: false

toolkit:
  go:
    package_name: github.com/bitrise-steplib/bitrise-step-set-java-version

inputs:
- set_java_version: "11"
  opts:
    title: Java version
    summary: Select which pre-installed Java version you want to use during the build.
    description: |
      Select the installed Java version you want to use during the build run.

      You can check [in system reports](https://stacks.bitrise.io) which Java versions are installed on each Bitrise stack.
    is_required: true
    value_options:
    - "21"
    - "17"
    - "11"
    - "8"

outputs:
- JAVA_HOME:
  opts:
    title: Location of the active Java installation.
    description: |-
      JAVA_HOME is an environment variable that points to the path where the JDK (Java Development Kit) is installed.