Intro

eros 是基于 weex 封装面向前端的 vue 写法的解决方案，由于 app 开发的特殊性，eros 则更偏重关心于整个 app 项目。

Advantage

• 详细的文档来解决环境搭建过程中的坑。
• 一套代码编译成 ios，android 两端原生应用。
• 封装了大量 module，让前端开发方便进行原生的操作。
• 提供 appboard 机制来减少包体积，并可以对其实时修改。
• 内置了一套完整的 widget ，可根据业务自行修改。
• 中介者模式来集中管理业务。
• 提供了服务器端增量发布更新逻辑。
• 脚手架可直接生成开发最新模板。
• 脚手架启动服务进行实时开发效果查看和 debug 调试。
• 脚手架更新开发平台所需 eros 依赖。
• 脚手架支持打对应平台内置包。
• 脚手架支持生成全量包，增量包，并内置与更新服务器交互逻辑。
• 脚手架支持同步更新模板内容。
• 脚手架支持 weex 的 vue 入口和 js 入口两种开发方式。
• 支持 weex debug

Disadvantage

eros 开发中也有很多限制，需要开发者自行斟酌。

• weex 代码在浏览器端还有很多兼容性问题，所有 eros 目前不支持浏览器端
• eros 不能使用 weex 市场，如果您有原生开发经验可以自行接入
• 由于 eros 对 JS Bundle 运行机制采用了 appboard 机制来减少了 js bundle 的大小，导致 weex debug 需要特定的处理。
• 由于目前开源的 weex ui 库都并不支持 tree-shaking，官方引入的 webpack 也是 1.x.x 版本，eros 脚手架即便升级了 webpack，但并未配置 tree-shaking，所以目前引入代码的方式需要限制很多写法来减少 JS Bundle 的体积，eros 后续会出对应的 UI组件库 来解决这些问题。
• eros 打出来的包体积稍大，为解决这个问题，eros 客户端动态加载依赖正在开发中。
• 如果遇到复杂的页面，如 IM 之类的，eros 建议用原生实现，weex 应付此类需求还是比较吃力。

Principle

大图地址

Situation

目前 eros 已有数十个 app 在开发中和上线的状态，其中有正在开发中的国外应用 starLife（100+页面），也有国内正在开发的蜂觅（60+ 页面），还有已上线的应用都在 0-50+ 页面不等，涉及行业分布于资讯，医疗，招商，购物，政府，办公等等。

而本木医疗（京医通）技术团队本身也基于 weex 开发了三个已上线的 app，均可在苹果商店和应用宝下载：

• 健康首都（京医通 app版，100+页面，很多功能还未开放）
• 本木医疗助手（30+页面）
• 本木医生助理（20+页面）

所以开发者大可放心，这不是一个 KPI 项目（公司没有 KPI ），已基于 MIT 协议开源。

Docs

• eros 文档地址 (持续更新中...)

Required

开发之前您需要学习 weex 知识，并且能熟练使用 vue 开发，文档地址如下。

• weex
• vue

Support

跟随着 weex 的支持性，但目前我们并不支持开发代码兼容 web 端

• Android 4.1 (API 16)
• iOS 8.0+
• WebKit 534.30+

Environment

以下为不同 OS 开发不同客户端所需环境。

hosts

为了真机调试，我们需要配置一个下hosts文件，添加如下地址，当然您也可以默认为公司固定资源文件访问地址，这样通过证书还能进行线上抓包分析问题。

127.0.0.1   app.weex-eros.com

脚手架所需环境:

darwin:

• Node.js (>=6.x), npm version 4+

windows:

• Git bash

因为脚手架依赖了node-sass，安装失败有很多解决办法，可自行查找。

脚手架安装:

$ npm i eros-cli -g

如果你在中国地区，我们还是推荐您使用 cnpm 安装

$ cnpm i eros-cli -g 

darwin 开发 iOS:

• Xcode
• CocoaPods
  • 升级 Ruby 环境：$ sudo gem update --system
  • 移除现有 Ruby 镜像：$ gem sources --remove https://rubygems.org/
  • 添加ruby-china镜像：$ gem source -a https://gems.ruby-china.org/
  • 安装 CocoaPods：$ sudo gem install cocoapods
  • 如果以上命令报错则执行：$ sudo gem install -n /usr/local/bin cocoapods --pre
  • 最后执行：$ pod setup 过程比较漫长，请耐心等待执行完成

darwin/windows/linux 开发 Android:

• 下载并安装 JDK。
• 下载并安装 Android Studio。

JDK 是 JAVA 开发包，AndroidStudio 是 Android开发IDE，这两项不再做过多介绍。

如果您使用虚拟机进行跨平台开发，也需要配置好对应平台的所需环境。

模拟器安装

• ios 开发中 xcode 已经自带了模拟器
• android 开发者可以下载 Genymotion

Start

1. 首先通过脚手架自动生成开发模板(我们不推荐用sudo来执行脚手架的任何指令)

$ eros init

按提示选择模板，填写 app/项目名称和版本后在当前路径下会生成对应模板，然后 cd 到项目中

2. 下载所需依赖

$ npm install
$ eros install

3. 安装完依赖之后:

• iOS: 会自动打开 Xcode ，然后选择一个模拟器，点击左上角的播放(运行)按钮，即可看到内置包中已经内置好的 eros demo.

• Android:开发者需要多几个步骤:

1. 点击AndroidStudio上方的 File--->New--->Import Project。
2. 找到eros在你本地的地址，选择 platforms/android/WeexFrameworkWrapper ,点击OK。
3. 待项目构建完成，点击 AndroidStudio 上方工具栏的 Run ，即可运行项目。

注意：

第一次打开 AndroidStuido 时，由于本地环境未配置好，AndroidStuido 会提示错误，按照 IDE 提示，大部分环境问题都可以解决。

于是 eros 的 demo 便能在模拟器中跑起来了。

在 eros demo 中我们可以看到：

• tab1 中内置了 weex-ui 并有 demo
• tab2 中内置了 bui 并有 demo
• tab3 中有大部分 widget 使用的实例
• tab4 中跑了官方的瀑布流例子和我们编写一个支持手势滑动的多个 List 的类似新闻的实例。

eros 的 demo 很重要，建议在开发中，首先跟随 demo 编写几个页面，并保留其代码作为使用参考。

Hello World

Hello World

Ecosystem

Project	Description
eros-cli	简单的 eros 项目构建工具，可以提供搭建，开发，调试和发布等功能。
eros-publish	简单的服务器差分包更新逻辑，需要和脚手架搭配使用。
eros-ios-library	eros ios Weex 项目依赖库。
eros-ios-sdk	eros ios Weex sdk。
eros-android-framework	eros weex 移动解决方案安卓端框架。
eros-android-widget	eros 安卓组件库。
eros-android-sdk	eros 安卓移动解决方案安卓端 WeexSDK。