Wiki source code of Release Notes for $doc.getValue('product') $doc.getValue('version')
Version 3.3 by Vincent Massol on 2022/01/31
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
1.1 | 1 | {{velocity}} |
| 2 | #set ($rnObject = $doc.getObject('ReleaseNotes.Code.ReleaseNoteClass')) | ||
| 3 | #set ($product = $rnObject.product) | ||
| 4 | #set ($version = $rnObject.version) | ||
| 5 | #set ($versionPrefix = $stringtool.substringBefore($version, '-')) | ||
| 6 | #set ($versionParts = $stringtool.split($versionPrefix, '.')) | ||
| 7 | #set ($isRC = $version.contains('rc')) | ||
| 8 | #set ($isFinal = !$isRC) | ||
| 9 | #set ($isFirstFinal = $versionParts.size() == 2 && $isFinal) | ||
| 10 | {{/velocity}} | ||
| 11 | |||
| 12 | {{box cssClass="floatinginfobox" title="**Contents**"}} | ||
| 13 | {{toc/}} | ||
| 14 | {{/box}} | ||
| 15 | |||
| 16 | This is the release notes for [[XWiki Commons>>http://commons.xwiki.org]], [[XWiki Rendering>>http://rendering.xwiki.org]] and [[XWiki Platform>>http://platform.xwiki.org]]. They share the same release notes as they are released together and have the same version. | ||
| 17 | |||
| |
2.1 | 18 | This is the first release of 14.x cycle which introduces the drop of Java 8: XWiki now requires Java 11 to work. As part of this cycle we're also dropping support of Internet Explorer 11. This release includes new work to allow refactoring of attachments, a few new UI extension points for developpers and better explanatory messages when macro are missing, among other improvments. |
| |
1.1 | 19 | |
| 20 | {{comment}} | ||
| 21 | Uncomment when there's at least one issue listed in the table! | ||
| 22 | {{error}} | ||
| 23 | The following regressions were introduced in this release (and found after it was released). Please check them out and if they impact you we recommend waiting to upgrade to a version where they are fixed. | ||
| 24 | |||
| 25 | {{velocity}} | ||
| 26 | #if ($isFirstFinal) | ||
| 27 | #set ($affectedVersions = "${version}-rc-1, ${version}") | ||
| 28 | #set ($fixVersionJQL = " and (fixVersion != ${version}-rc-1 or fixVersion is empty)") | ||
| 29 | #else | ||
| 30 | #set ($affectedVersions = "${version}") | ||
| 31 | #set ($fixVersionJQL = "") | ||
| 32 | #end | ||
| 33 | {{jira id="xwikiorg" source="jql"}} | ||
| 34 | category = 10000 and affectedVersion in ($affectedVersions)${fixVersionJQL}and priority = Blocker and resolution in (Fixed, Unresolved) | ||
| 35 | {{/jira}} | ||
| 36 | {{/velocity}} | ||
| 37 | {{/error}} | ||
| 38 | {{/comment}} | ||
| 39 | |||
| |
2.1 | 40 | = New and Noteworthy (since {{velocity}}$product{{/velocity}} 13.10.2) = |
| |
1.1 | 41 | |
| |
3.2 | 42 | [[Full list of issues fixed and Dashboard for XWiki 14.0>>https://jira.xwiki.org/secure/Dashboard.jspa?selectPageId=14909]]. |
| |
1.1 | 43 | |
| 44 | {{releasenotechanges/}} | ||
| 45 | |||
| 46 | === Upgrades === | ||
| 47 | |||
| 48 | The following runtime dependencies have been upgraded (they have a different release cycle than [[XWiki Commons>>http://commons.xwiki.org]], [[XWiki Rendering>>http://rendering.xwiki.org]] and [[XWiki Platform>>http://platform.xwiki.org]]): | ||
| 49 | |||
| |
2.1 | 50 | * [[jasmine-maven-plugin 3.0-beta-02>>https://jira.xwiki.org/browse/XWIKI-19248]] (xwiki-platform-livedata-webjar only) |
| 51 | * [[frontend-maven-plugin 1.12.0>>https://jira.xwiki.org/browse/XWIKI-19247]] | ||
| 52 | * [[less 4.1.2>>https://jira.xwiki.org/browse/XWIKI-19246]] (xwiki-platform-livedata-webjar only) | ||
| 53 | * [[eslint-plugin-vue 7.20.0>>https://jira.xwiki.org/browse/XWIKI-19245]] | ||
| 54 | * [[@vue/test-utils 1.3.0>>https://jira.xwiki.org/browse/XWIKI-19243]] | ||
| 55 | * [[@vue/cli-plugin-unit-jest 4.5.15>>https://jira.xwiki.org/browse/XWIKI-19241]] | ||
| 56 | * [[@vue/cli-plugin-eslint 4.5.15>>https://jira.xwiki.org/browse/XWIKI-19240]] | ||
| 57 | * [[@vue/cli-plugin-babel 4.5.15>>https://jira.xwiki.org/browse/XWIKI-19239]] | ||
| 58 | * [[@testing-library/jest-dom 5.16.1>>https://jira.xwiki.org/browse/XWIKI-19238]] | ||
| 59 | * [[@babel/eslint-parser 7.16.5>>https://jira.xwiki.org/browse/XWIKI-19237]] | ||
| 60 | * [[vue-tippy 4.13.0>>https://jira.xwiki.org/browse/XWIKI-18988]] | ||
| 61 | * [[log4j API 2.17.0>>https://jira.xwiki.org/browse/XCOMMONS-2327]] | ||
| 62 | * [[log4j API 2.17.1>>https://jira.xwiki.org/browse/XCOMMONS-2340]] | ||
| 63 | * [[Logback 1.2.10>>https://jira.xwiki.org/browse/XCOMMONS-2330]] | ||
| 64 | * [[CKEditor Integration 1.58>>https://jira.xwiki.org/browse/XWIKI-19273]] | ||
| 65 | * [[CKEditor 4.17.1>>https://jira.xwiki.org/browse/CKEDITOR-416]] | ||
| 66 | * [[H2 MVStore 2.1.210>>https://jira.xwiki.org/browse/XWIKI-19191]] | ||
| 67 | * [[Maven 3.8.4>>https://jira.xwiki.org/browse/XWIKI-19164]] | ||
| 68 | * [[JNR POSIX 3.1.12>>https://jira.xwiki.org/browse/XWIKI-19163]] | ||
| 69 | * [[Snakeyaml 1.30>>https://jira.xwiki.org/browse/XCOMMONS-2335]] | ||
| 70 | * [[Infinispan 13.0.5.Final>>https://jira.xwiki.org/browse/XCOMMONS-2334]] | ||
| 71 | * [[Apache PDFBox 2.0.25>>https://jira.xwiki.org/browse/XWIKI-19253]] | ||
| 72 | * [[Jackson 2.13.1>>https://jira.xwiki.org/browse/XCOMMONS-2332]] | ||
| 73 | * [[httpasyncclient 4.1.5>>https://jira.xwiki.org/browse/XCOMMONS-2328]] | ||
| 74 | * [[Liquibase 4.6.2>>https://jira.xwiki.org/browse/XWIKI-19214]] | ||
| 75 | * [[Doxia 1.11.1>>https://jira.xwiki.org/browse/XRENDERING-626]] | ||
| 76 | * [[Checker Qual 3.20.0>>https://jira.xwiki.org/browse/XCOMMONS-2325]] | ||
| 77 | * [[HTTP Core 4.4.15>>https://jira.xwiki.org/browse/XCOMMONS-2323]] | ||
| 78 | * [[Bouncy Castle 1.70>>https://jira.xwiki.org/browse/XCOMMONS-2321]] | ||
| 79 | * [[Plexus Containers 2.1.1>>https://jira.xwiki.org/browse/XCOMMONS-2337]] | ||
| 80 | * [[Hibernate Validator 6.2.1.Final>>https://jira.xwiki.org/browse/XCOMMONS-2339]] | ||
| 81 | * [[Tika 2.2.1>>https://jira.xwiki.org/browse/XWIKI-19254]] | ||
| 82 | * [[Rome 1.18.0>>https://jira.xwiki.org/browse/XWIKI-19275]] | ||
| 83 | * [[JavaCC 7.0.10>>https://jira.xwiki.org/browse/XRENDERING-635]] | ||
| 84 | * [[Closure Compiler v20220104>>https://jira.xwiki.org/browse/XCOMMONS-2129]] | ||
| 85 | * [[Checker Qual 3.21.1>>https://jira.xwiki.org/browse/XCOMMONS-2333]] | ||
| 86 | * [[JNR POSIX 3.1.15>>https://jira.xwiki.org/browse/XWIKI-19213]] | ||
| 87 | * [[JNR FFI 2.2.11>>https://jira.xwiki.org/browse/XWIKI-19162]] | ||
| 88 | * [[JFFI 1.3.9>>https://jira.xwiki.org/browse/XWIKI-19161]] | ||
| 89 | * [[JBoss Logging 3.4.3>>https://jira.xwiki.org/browse/XCOMMONS-2348]] | ||
| 90 | * [[Protobuf Java 3.19.3>>https://jira.xwiki.org/browse/XCOMMONS-2344]] | ||
| 91 | * [[Liquibase 4.7.0>>https://jira.xwiki.org/browse/XWIKI-19315]] | ||
| 92 | * [[SLF4J 1.7.33>>https://jira.xwiki.org/browse/XCOMMONS-2352]] | ||
| 93 | * [[Byte Buddy 1.12.7>>https://jira.xwiki.org/browse/XCOMMONS-2316]] | ||
| 94 | * [[Woodstox 6.2.8>>https://jira.xwiki.org/browse/XCOMMONS-2315]] | ||
| 95 | * [[Netty 4.1.73.Final>>https://jira.xwiki.org/browse/XWIKI-19231]] | ||
| 96 | * [[jdom 2.0.6.1>>https://jira.xwiki.org/browse/XCOMMONS-2324]] | ||
| 97 | * [[MySQL connector 8.0.28>>https://jira.xwiki.org/browse/XWIKI-19322]] | ||
| 98 | * [[Hibernate 5.6.4>>https://jira.xwiki.org/browse/XWIKI-19255]] | ||
| 99 | * [[Java Diff Utils>>https://jira.xwiki.org/browse/XCOMMONS-2169]] (migrated from ##com.googlecode.java-diff-utils:diffutils:1.3.0## to ##io.github.java-diff-utils:java-diff-utils:4.11##) | ||
| 100 | * [[Bootstrap Date Time Picker 4.17.49>>https://jira.xwiki.org/browse/XWIKI-19330]] | ||
| 101 | * [[Bootstrap Switch 3.3.4>>https://jira.xwiki.org/browse/XWIKI-19329]] | ||
| 102 | * [[Bootstrap Date Range Picker 3.1>>https://jira.xwiki.org/browse/XWIKI-19325]] | ||
| 103 | * [[Bootstrap Select 1.13.18>>https://jira.xwiki.org/browse/XWIKI-19323]] | ||
| 104 | * [[Drawer 3.2.2>>https://jira.xwiki.org/browse/XWIKI-13140]] | ||
| 105 | * [[iscroll 5.2.0>>https://jira.xwiki.org/browse/XWIKI-19328]] | ||
| 106 | * [[selectize.js 0.13.3>>https://jira.xwiki.org/browse/XWIKI-19326]] | ||
| 107 | * [[momentjs 2.29.1>>https://jira.xwiki.org/browse/XWIKI-19324]] | ||
| 108 | * [[jstree 3.3.12>>https://jira.xwiki.org/browse/XWIKI-18875]] | ||
| |
1.1 | 109 | |
| 110 | = Translations = | ||
| 111 | |||
| |
3.1 | 112 | The following translations have been updated: |
| |
1.1 | 113 | |
| |
3.1 | 114 | {{language codes="de,fr,zh"/}} |
| |
1.1 | 115 | |
| 116 | {{comment}} | ||
| 117 | TODO: uncomment and update with proper link when the report is ready. | ||
| 118 | |||
| 119 | = Tested Browsers & Databases = | ||
| 120 | |||
| 121 | {{include reference="TestReports.<test report page>"/}} | ||
| 122 | {{/comment}} | ||
| 123 | |||
| 124 | {{comment}} | ||
| 125 | TODO: uncomment and update with proper links when the report is ready. | ||
| 126 | |||
| 127 | = Performances tests compared to <last super stable version> = | ||
| 128 | |||
| 129 | {{display reference="test:Performances.Jetty HSQLDB single wiki xxx to yyy" section="HSummary"/}} | ||
| 130 | |||
| 131 | More details on [[performance comparison on single wiki between x.x and y.y>>test:Performances.Jetty HSQLDB single wiki xxx to yyy]]. | ||
| 132 | {{/comment}} | ||
| 133 | |||
| 134 | = Known issues = | ||
| 135 | |||
| 136 | * [[Bugs we know about>>https://jira.xwiki.org/issues/?jql=category%20%3D%2010000%20AND%20issuetype%20%3D%20Bug%20AND%20resolution%20%3D%20Unresolved%20ORDER%20BY%20updated%20DESC]] | ||
| 137 | |||
| 138 | = Backward Compatibility and Migration Notes = | ||
| 139 | |||
| 140 | == General Notes == | ||
| 141 | |||
| 142 | * When upgrading make sure you compare and merge the following XWiki configuration files since some parameters may have been modified, removed or added: | ||
| 143 | ** ##xwiki.cfg## | ||
| 144 | ** ##xwiki.properties## | ||
| 145 | ** ##web.xml## | ||
| 146 | ** ##hibernate.cfg.xml## | ||
| 147 | * Add ##xwiki.store.migration=1## in ##xwiki.cfg## so that XWiki will attempt to automatically migrate your current database to any new schema. Make sure you backup your Database before doing anything. | ||
| 148 | |||
| 149 | == Issues specific to {{velocity}}$product $version{{/velocity}} == | ||
| 150 | |||
| |
2.1 | 151 | === Drop support of Java 8 === |
| |
1.1 | 152 | |
| |
2.1 | 153 | XWiki now [[requires Java 11>>dev:Community.SupportStrategy.JavaSupportStrategy]] to run. |
| 154 | |||
| 155 | {{gallery}} | ||
| |
2.2 | 156 | image:ReleaseNotes.Data.XWiki.14\.0RC1.WebHome@java11.png |
| |
2.1 | 157 | {{/gallery}} |
| 158 | |||
| 159 | === Drop support of Internet Explorer 11 === | ||
| 160 | |||
| 161 | Internet Explorer 11 support has been [[dropped>>https://forum.xwiki.org/t/drop-support-for-ie11-in-xwiki-14-0/9647/]]: we removed most of the hacks that were required by IE11 which makes this new version of XWiki unusable with this old web browser. Check the [[Browser Support Strategy>>dev:Community.SupportStrategy.BrowserSupportStrategy]] documentation to see the list of supported web browsers. | ||
| 162 | |||
| 163 | === Mentions === | ||
| 164 | |||
| 165 | A local database is stored in the permanent directories and stores the updated document that needs to be analyzed for new mentions. This database is based on [[H2 MVStore>>url:https://www.h2database.com/html/mvstore.html]]. When upgrading to 14.0RC1+ the file format of H2 MVStore changes and the old one becomes unsupported. The old database file is moved to a backup file, and a new one is created. | ||
| 166 | |||
| 167 | {{warning}} | ||
| 168 | In this case, any updated document queued for upgrade when the server is stopped will be discarded, and some users will not be notified of their mentions. | ||
| 169 | Please make sure that the queue size is at zero before upgrading (see [[JMX>>doc:extensions:Extension.Mentions Application.WebHome||anchor="HJMX"]]). | ||
| 170 | {{/warning}} | ||
| 171 | |||
| |
1.1 | 172 | == API Breakages == |
| 173 | |||
| |
3.3 | 174 | The following APIs were modified since {{velocity}}$product{{/velocity}} 13.10.2: |
| |
1.1 | 175 | |
| 176 | {{comment}} | ||
| 177 | Remove! | ||
| 178 | {{velocity}} | ||
| 179 | {{backwardCompatibilityReport134 version="$version"/}} | ||
| 180 | {{/velocity}} | ||
| 181 | {{/comment}} | ||
| 182 | |||
| 183 | = Credits = | ||
| 184 | |||
| 185 | The following people have contributed code and translations to this release (sorted alphabetically): | ||
| 186 | |||
| 187 | <code and translation contributors> |
