Apache Weex (Incubating)

Clone this repo:
  1. 5c25f0b Merge pull request #3353 from apache/WillemJiang-patch-1 by 任跃兵 · 2 years ago master
  2. 4adf19d Added RETIRED.txt file by Willem Jiang · 2 years ago WillemJiang-patch-1
  3. d39ca6e Merge pull request #3351 from Hanks10100/feature/cleanup by jianhan-he · 2 years, 1 month ago release/0.30
  4. 788e8ed [js] clean up front-end assets and fix test by Hanks · 2 years, 1 month ago
  5. a69d8fa Merge pull request #3350 from jianhan-he/master by jianhan-he · 2 years, 1 month ago


A framework for building Mobile cross-platform UI.

Build Status

Join Us

Join us through mailing list.

Convenience Distribution

Since 0.28.0, Weex would publish two convince binary in each release for Android, please read the documentation about the detail.

Please take the above link seriously, otherwise you would be able to use the latest version of Weex.

Androidsdk Download Or sdk_legacy Download
iOSPod version Carthage compatible
Mobile Webnpm version

Support Android 4.1 (API 16), iOS 9.0+ and WebKit 534.30+.

FYI: The mobile web render is not supported by Apache Weex officially

For Windows

First of all, compiling or building Weex from Windows is not supported officially.

You could install Git for Windows and run all the following commands in git-bash.

Good Luck.

Meet Weex

  • Install Weex Playground to see examples we already written.
  • If you want to write a demo, install weex-cli in Node.js 8.0+ and
  • Run weex init to generate & start a simple project in an empty folder.
  • Follow the instructions in the project README.
  • Enjoy it.

Use Weex


You should install android environment before building.

You can either build Weex from IDE (Android Studio) or command line.

Build From Android Studio

  1. Open android directory in Android Studio.
  2. Run git submodule update --init --remote in android directory if this is the first time you try to run Weex.

Build From Command Line

Please read How To Build for detail.


You should install iOS environment before building.

You can either build Weex from IDE (XCode) or command line.

Build From XCode

  • Run playground

    • cd ios/playground
    • pod install
    • Open WeexDemo.xcworkspace in Xcode
    • Click (Run button) or use default shortcut cmd + r in Xcode
    • If you want to run the demo on your device, don't need to modify CURRENT_IP manually. In DemoDefine.h(you can search this file by Xcode default shortcut cmd + shift + o), modify CURRENT_IP to your local IP
  • integrate to your application

    • CocoaPods

      Add the following line to your Podfile:

      pod 'WeexSDK'

    run pod install

    • Carthage

      Add the following line to your Cartfile:

      github "apache/incubator-weex"

    Run carthage update, and you should now have the latest version of WeexSDK in your Carthage folder.

Build From Command Line

Please read How To Build for detail.

Mobile Web

Vue Render for Apache Weex is a third party plugin, and not developed nor maintained by Apache Weex.

see Vue Render for Apache Weex.

Third part plugin

There is a third party plugin provides for debugging purpose.

You can also view this page for all third party plugin.

Weex Community


See Weex Contributing Guide for more information.