This page introduces the break change of Weex, you can visit GitHub page for detail changelog.
::: tip The following three major change in 0.28 only affects Android developers. :::
Due to the fact that Weex was a software of Alibaba Group (the mother company of Taobao Software Cooperation, ltd.) before donated to ASF (Apache Software Foundation),the Android package name of Weex was com.taobao.weex
before Weex 0.28.0 released.
Since Weex 0.28.0, the package name of Android(i.e. Java) files was changed to org.apache.weex
, which may cause compiling failure if you try to upgrade from a older version. For backward-compatibility reasons, we provide an artifact named sdk_legacy
where all files are still in the package name of com.taobao.weex
. The legacy artifact may not be maintained in the future, please upgrade to the new package name when it's possible for you.
Due to the fact that Weex was a software of Alibaba Group (the mother company of Taobao Software Cooperation, ltd.) before donated to ASF (Apache Software Foundation),Weex Android was under com.taobao.android:weex_sdk
in JCenter before Weex 0.28.0 release.
Since 0.28.0, Weex provides a convenience library in JCenter with the following groupId and artifactId:
org.apache.weex:sdk
is the currently stable package of Weex, where all Java files are under the package of org.apache.weex
.org.apache.weex:sdk_legacy
is the legacy package of Weex, where all Java files are under the package of com.taobao.weex
. This artifact may not be maintained in the future, please upgrade to the new package name when it's possible for you.Before Weex 0.28.0, Weex Android relied and bundled JavaScriptCore into its convenience binary(i.e. aar), and this approach have the following disadvantage:
Since Weex 0.28.0, the JavaScript Interpreter is not bundled in the convenience binary anymore, users have the freedom of using whatever JavaScript Interpreter they want as long as they implement the same interface.
This means users have to bundle a JavaScript Interpreter in their APP to run Weex. For users who don't have idea about how to choose JavaScript Interpreter, one can insert the following code snippet into the build.gradle
of the app:
apply from: 'https://raw.githubusercontent.com/apache/incubator-weex/release/0.28/android/sdk/buildSrc/download_jsc.gradle'
The above code snippet will download and bundle jsc-android of version 241213.1.0
. This is only for demonstration purpose, users always have the freedom of choosing JavaScript Interpreter in their APP.