Liferay Faces Version Scheme
Use this reference to identify which Liferay Faces artifacts to include in your portlet and to understand what each component of the version number means.
Liferay Faces Alloy
Provides a suite of JSF components that utilize AlloyUI.
| Branch | Example Artifact | AlloyUI | JSF API | Additional Info |
|---|---|---|---|---|
| master (4.x) | com.liferay.faces.alloy-4.1.0.jar | 3.1.x | 2.2+ | AlloyUI 3.1.x is the version that comes bundled with Liferay Portal 7.3. |
| 3.x | com.liferay.faces.alloy-3.1.0.jar | 3.0.x | 2.2+ | AlloyUI 3.0.x is the version that comes bundled with Liferay Portal 7.0/7.1/7.2. |
| 2.x | com.liferay.faces.alloy-2.0.1.jar | 2.0.x | 2.1+ | AlloyUI 2.0.x is the version that comes bundled with Liferay Portal 6.2. |
| 1.x | com.liferay.faces.alloy-1.0.1.jar | 2.0.x | 1.2 | AlloyUI 2.0.x is the version that comes bundled with Liferay Portal 6.2. |
Liferay Faces Bridge
Provides the ability to deploy JSF web applications as portlets within Apache Pluto, the reference implementation for JSR 286 (Portlet 2.0) and JSR 362 (Portlet 3.0).
| Branch | Example Artifacts | Portlet API | JSF API | JCP Specification | Additional Info |
|---|---|---|---|---|---|
| API: 5.x IMPL: 5.x | com.liferay.faces.bridge.api-5.0.0.jar com.liferay.faces.bridge.impl-5.0.0.jar | 3.0 | 2.2 | JSR 378 | Released as a Final Specification in June 2022. |
| API: 4.x IMPL: 4.x | com.liferay.faces.bridge.api-4.1.0.jar com.liferay.faces.bridge.impl-4.0.0.jar | 2.0 | 2.2 | JSR 329 | Includes non-standard bridge extensions for JSF 2.2. |
| API: 3.x IMPL: 3.x | com.liferay.faces.bridge.api-3.1.0.jar com.liferay.faces.bridge.impl-3.0.0.jar | 2.0 | 2.1 | JSR 329 | Includes non-standard bridge extensions for JSF 2.1. |
| API: 2.x IMPL: 2.x | com.liferay.faces.bridge.api-2.1.0.jar com.liferay.faces.bridge.impl-2.0.0.jar | 2.0 | 1.2 | JSR 329 (MR1) | Includes support for Maintenance Release 1 (MR1). |
| 1.x | N/A | 1.0 | 1.2 | JSR 301 | N/A (Not Applicable) since Liferay Faces Bridge has never implemented JSR 301. |
Liferay Faces Bridge Ext
Extension to Liferay Faces Bridge that provides compatibility with Liferay DXP and also takes advantage of Liferay-specific features such as friendly URLs.
| Branch | Example Artifact | Liferay Portal API | Bridge API | Portlet API | JSF API |
|---|---|---|---|---|---|
| 8.x | com.liferay.faces.bridge.ext-8.0.0.jar | 7.3.0+ | 5.x | 3.0 | 2.3 |
| 7.x | com.liferay.faces.bridge.ext-7.0.0.jar | 7.3.0+ | 5.x | 3.0 | 2.2 |
| 6.x | com.liferay.faces.bridge.ext-6.0.0.jar | 7.3.0+ | 4.x | 2.0 | 2.2 |
| 5.x | com.liferay.faces.bridge.ext-5.0.4.jar | 7.0.x/7.1.x/7.2.x | 4.x | 2.0 | 2.2 |
| 4.x | UNUSED | N/A | N/A | N/A | N/A |
| 3.x | com.liferay.faces.bridge.ext-3.0.1.jar | 6.2.x | 4.x | 2.0 | 2.2 |
| 2.x | com.liferay.faces.bridge.ext-2.0.1.jar | 6.2.x | 3.x | 2.0 | 2.1 |
| 1.x | com.liferay.faces.bridge.ext-1.0.1.jar | 6.2.x | 2.x | 2.0 | 1.2 |
Liferay Faces Portal
Provides a suite of JSF components that are based on the JSP tags provided by Liferay DXP.
| Branch | Example Artifact | Liferay Portal API | Portlet API | JSF API |
|---|---|---|---|---|
| 6.x | com.liferay.faces.portal-6.0.0.jar | 7.2+ | 3.0 | 2.3 |
| 5.x | com.liferay.faces.portal-5.0.0.jar | 7.2+ | 3.0 | 2.2 |
| 4.x | com.liferay.faces.portal-4.0.0.jar | 7.2/7.3 | 2.0 | 2.2 |
| 3.x | com.liferay.faces.portal-3.0.1.jar | 7.0/7.1/7.2 | 2.0 | 2.2 |
| 2.x | com.liferay.faces.portal-2.0.1.jar | 6.2 | 2.0 | 2.1/2.2 |
| 1.x | com.liferay.faces.portal-1.0.1.jar | 6.2 | 2.0 | 1.2 |
Liferay Faces Util
Library that contains general purpose JSF utilities to support many of the sub-projects that comprise Liferay Faces.
| Branch | Example Artifact | JSF API |
|---|---|---|
| master | com.liferay.faces.util-3.1.0.jar | 2.3 |
| 3.x | com.liferay.faces.util-3.1.0.jar | 2.2 |
| 2.x | com.liferay.faces.util-2.1.0.jar | 2.1 |
| 1.x | com.liferay.faces.util-1.1.0.jar | 1.2 |
The following image shows the Liferay Faces dependency diagram, which visualizes how components interact and depend on each other.
