From Fedora Project Wiki

Revision as of 12:16, 15 April 2024 by Mkoncek (talk | contribs)

Comments and Explanations
The page source contains comments providing guidance to fill out each section. They are invisible when viewing this page. To read it, choose the "view source" link.
Copy the source to a new page before making changes! DO NOT EDIT THIS TEMPLATE FOR YOUR CHANGE PROPOSAL.
Guidance
For details on how to fill out this form, see the documentation.
Report issues
To report an issue with this template, file an issue in the pgm_docs repo.


Drop Mandatory Requires on JRE

This is a proposed Change for Fedora Linux.
This document represents a proposed Change. As part of the Changes process, proposals are publicly announced in order to receive community feedback. This proposal will only be implemented if approved by the Fedora Engineering Steering Committee.

Summary

Drop the requirement of Java libraries to have Requires on JREs.

Owner

Current status

  • Targeted release: Fedora Linux 41
  • Last updated: 2024-04-15
  • [<will be assigned by the Wrangler> devel thread]
  • FESCo issue: <will be assigned by the Wrangler>
  • Tracker bug: <will be assigned by the Wrangler>
  • Release notes tracker: <will be assigned by the Wrangler>

Detailed Description

Current guidelines require all Java packages to Require: java-headless or java-headless >= 1:minimal_required_version.

Our aim is to drop this explicit requirement on Java library packages. The requirement should stay for Java applications.

Context

Java packages are compiled using javac into .class files and composed into .jar archives. Jar archives can be used as compile or runtime dependencies for other packages or can be directly executed with the java command provided by a JRE.

Jar archives can be executed using the command: java -jar ${FILE}. This command executes the main method either specified via CLI or specified within the Jar manifest file.

Java packages, which serve as libraries only, lack the main method and are not executable. Therefore, there is no requirement on any specific JRE imposed by the library implicitly.

Feedback

Benefit to Fedora

  • Very little user-visible benefit.
  • Reduced dependencies of Java packages.
  • Simplified maintenance of Java packages.
    • Smaller impact of JDK major updates (e.g. 1.8.0 -> 11 -> 17 -> 21)

Scope

  • Proposal owners:
    • Find all Java applications in Fedora, i.e. packages which BuildRequire java-devel / maven-local / ant and at the same time install files into /bin or /sbin or /usr/bin or /usr/sbin.
    • Add Requires: java-headless into their .spec file.
    • Remove Requires generator from javapackages-tools
    • Wait for a mass rebuild.
  • Other developers:
    • Maintainers of Java applications will need to add an explicit Requires: java-headless field into their .spec file or a specific version of java.
  • Release engineering: #Releng issue number
    • Mass rebuild is not required, this change can propagate via natural rebuilds.
  • Policies and guidelines:
  • Trademark approval: N/A (not needed for this Change)
  • Alignment with Community Initiatives:

Upgrade/compatibility impact

  • For Java libraries:
    • This change is removing Requires and therefore users manually installing a Java library will not additionally install the JVM.
  • For Java applications:
    • After fully implemented, applications will no longer be installable along with any JVM but rather only the system one (unless the package maintainer decides otherwise)

How To Test

  • Installing a Java library should not typically install JVM (but can if the library depends on a Java application)
  • Installing a Java application MUST cause the installation of the system-wide JVM (or a different version thereof)
  • Executing a binary installed in typical locations (such as /usr/bin) MUST NOT cause an error related to the JVM not being installed.

User Experience

Users with no Java application installed, but some Java libraries installed: the JVM may be automatically uninstalled as it is possibly not required by anything.

It is possible that there are users with only some older JVM installed. The following depends on the decision of each Java application package maintainer, but the general expectation is that the system-wide JVM will be installed and the older JVM will no longer be required by other packages.

Users who explicitly installed JVMs of various versions: no change.

Dependencies

  • javapackages-tools
    • This change allows the removal of a Requires generator.

Contingency Plan

  • Contingency mechanism:
    • In case of unexpected problems, the Requires generators can be reintroduced into javapackages-tools and packages can be rebuilt.
  • Contingency deadline: Branch Fedora Linux 41 from Rawhide Tue 2024-08-06
  • Blocks release? No

Documentation

No documentation outside of this document.

Release Notes