eros 是基于 weex 封装面向前端的 vue 写法的解决方案，由于 app 开发的特殊性，eros 则更偏重关心于整个 app 项目。
| iOS 端内置 DEMO | ios 版下载 | android版下载 |
|---|---|---|
 |
 |
 |
开发者可以扫描二维码来下载 eros app 来进行体验，iOS首次打开App需要在 设置->通用->设备管理 信任开发证书。
如果您是前端开发者：
- 一定要熟练使用 vue 开发
- 一定要详细阅读 weex 的文档，尤其是与 web 环境，vue 开发差异的部分。
- 在开发客户端应用中，会有遇到无数的环境问题，程序问题，代码问题，绝大多数问题都可以在网上查到对应解决方案，在提出问题或者 issue 的时候，还请先自行尝试解决，eros 的环境安装会耗费很长的时间，你懂的。
- 需要熟悉客户端开发打包流程。
很多前端开发者在环境问题上便半途而废了，不过 eros 会一直完善文档，开发群中也会有大量开发者为您解答，还请保持一颗有始有终的心，会有收获的。
如果您是客户端开发者：
那么环境您会迅速搭建起来，然后跟着熟读 vue，weex 的文档，因为 vue 上手非常快，最后跟着 eros 的新手教程写几个 demo 便可以开始开发，还可以轻松拓展 module。
eros 提供了:
- 详细的文档来解决环境搭建过程中的坑。
- 一套代码编译成 ios，android 两端原生应用。
- 封装了大量 weex module，让前端开发方便进行原生的操作。
- 可以通过
appboard机制来减少多页面项目中的代码冗余，减少包体积，并可以对其实时修改。 - 内置了一套完整的 JS 二次封装 module (widget) ，直接通过 vue 插件系统注入，直接在
this上调用，可根据业务自行修改。 - 内置了中介者服务，来进行多个页面间的交互，并可以管理业务。
- 内置了服务器端增量发布更新逻辑，可以搭配着开源的简易增量发布系统一起使用。
- 支持真机和模拟器通过
weex debug来断点调试，程序报错均会有报错日志弹窗提示。
可以通过脚手架：
- 直接生成开发最新模板。
- 启动服务进行实时开发效果查看和 debug 调试。
- 更新开发平台所需 eros 依赖。
- 直接
pack对应平台内置JS Bundle。 - 支持生成全量包，增量包，并内置与更新服务器交互逻辑。
- 支持同步更新模板内容。
- 支持 weex 的 vue 入口和 js 入口两种开发方式。
支持市面上流行的组件库：
eros 开发中也有很多限制，需要开发者自行斟酌。
- weex 代码在浏览器端还有很多兼容性问题，所有 eros 目前不支持浏览器端。
- eros 暂时不能自动使用 weex 市场，但如果您有原生开发经验可以自行接入。
- 由于 eros 对 JS Bundle 运行机制采用了 appboard 机制来减少了 js bundle 的大小，导致 weex debug 需要特定的处理。
- eros 打出来的包体积稍大，为解决这个问题，eros 客户端依赖可配置正在开发中。
- 如果遇到复杂的页面，如 IM 之类的，eros 建议用原生实现，weex 应付此类需求还是比较吃力。
目前 eros 已有数十个 app 在开发中和上线的状态，其中有正在开发中的国外应用 starLife（100+页面），也有国内正在开发的蜂觅（60+ 页面），还有已上线的应用都在 0-50+ 页面不等，涉及行业分布于资讯，医疗，招商，购物，政府，办公等等。
而本木医疗（京医通）技术团队本身也基于 weex 开发了三个已上线的 app，均可在苹果商店和应用宝下载：
- 健康首都（京医通 app版，100+页面，很多功能还未开放）
- 本木医疗助手（30+页面）
- 本木医生助理（20+页面）
所以开发者大可放心，这不是一个 KPI 项目（公司没有 KPI ），已基于 MIT 协议开源。
- eros 文档地址 (持续更新中...)
开发之前您需要学习 weex 知识，并且能熟练使用 vue 开发，文档地址如下。
跟随着 weex 的支持性，
但目前我们并不支持开发代码兼容 web 端
- Android 4.1 (API 16)
- iOS 8.0+
- WebKit 534.30+
以下为不同 OS 开发不同客户端所需环境。
为了真机调试，我们推荐配置 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
- 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 过程比较漫长，请耐心等待执行完成
- 升级 Ruby 环境：
- 下载并安装 JDK。
- 下载并安装 Android Studio。
JDK 是 JAVA 开发包，AndroidStudio 是 Android开发IDE，这两项不再做过多介绍。
如果您使用虚拟机进行跨平台开发，也需要配置好对应平台的所需环境。
- ios 开发中 xcode 已经自带了模拟器
- android 开发者推荐下载
Genymotion模拟器
当然市面上的如
夜神模拟器也是可以的，调试教程，但是在 weex 0.17 中会出现 weex 实例化失败的问题，所以还是推荐Genymotion。
- 首先通过脚手架自动生成开发模板(我们不推荐用
sudo来执行脚手架的任何指令)
$ eros init
按提示选择模板，填写 app/项目名称和版本后在当前路径下会生成对应模板，然后 cd 到项目中
- 下载所需依赖 前端依赖
$ npm install
客户端依赖
$ eros install
- 安装完依赖之后:
-
iOS: 会自动打开
Xcode，然后选择一个模拟器，点击左上角的播放(运行)按钮，即可看到内置包中已经内置好的 eros demo. -
Android:开发者需要多几个步骤:
- 点击AndroidStudio上方的 File--->New--->Import Project。
- 找到eros在你本地的地址，选择 platforms/android/WeexFrameworkWrapper ,点击OK。
- 待项目构建完成，点击 AndroidStudio 上方工具栏的 Run ，即可运行项目。
注意：
第一次打开 AndroidStuido 时，由于本地环境未配置好，AndroidStuido 会提示错误，按照 IDE 提示，大部分环境问题都可以解决。
于是 eros 的 demo 便能在模拟器中跑起来了。
| iOS 端内置 DEMO |
|---|
|
eros 的 demo 很重要，建议在开发中，首先跟随 demo 编写几个页面，并保留其代码作为使用参考。
| 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。 |
eros 正式开源到现在已经有了一个近 300 多人的开发群 (只能通过邀请)，群里有大量开发者已经有 eros 产品在开发中和已上线，为了维护一个良好的环境，还请先熟知以下群规：
- 此并不是流量群，也并非广告群，是为了大家一起成长，保证信息的有效性，如果发黄赌毒，不和谐言语，与学习无关的广告，推广内容，无关小程序，不会商量，直接会被踢，且不会再有入群机会。
- eros开发中遇到任何问题可以随时发到群里 weex开发相关可以一起讨论。
- 如果不能及时回答也请耐心等待，群里开发丰富经验的同学会帮您一起看问题。
- 除了 eros 自身紧急 BUG 外的问题，均需要提 issue，我们会按 issue 处理，目的是为了更好的给其他开发者参考，紧急问题请直接抛到群里，我们会直接远程帮助您调试。
| 微信群 |
|---|
 |
Copyright (c) 2017-present, 本木医疗