106 | 同时也可以添加`jsServer`字段来指定访问的服务地址（即`eros dev`服务的地址） 107 | 108 | ```js 109 | // eros.native.js 文件 110 | 'url': { 111 | ... 112 | // 在这里添加 socketServer 请将 ip 地址改为你电脑真实的地址，注意如果是 dhcp 分配的地址会发生变化 113 | 'socketServer': 'ws://192.168.15.252:8890', 114 | // 指定访问服务地址 115 | 'jsServer': "http://192.168.15.252" 116 | } 117 | ... 118 | ``` 119 | 120 | 121 | ## Q: 手机设置代理后不能上网 122 | 123 | A: 124 | 125 | 1.首先请在查看一次`开发调试`的文档，确认一下是否打开了代理工具（charles、fiddler或其他），如果没有打开请打开相关代理工具； 126 | 127 | - Charles 使用教程：http://www.jianshu.com/p/fdd7c681929c 128 | - Fiddler 使用教程：http://www.jianshu.com/p/99b6b4cd273c 129 | 130 | ## Q: eros dev 开发服务不成功 131 | 132 | A: 133 | 如果报错 134 | ``` 135 | ... 136 | webpackRun.run is not a function 137 | ... 138 | ``` 139 | 请 cd 到您新建的项目中去在尝试 140 | 141 | **mac/linux:** 142 | 正常来说 mac/linux 下不会有任何报错，如果提示权限不足请 sudo 执行。 143 | 144 | **windows** 145 | 如果报权限不足，如果 dev.json 未做修改，默认是80端口，请找出80端口占用程序并关闭他。 146 | 147 | 如果报了以下错误: 148 | > vue packages version mismatch 149 | 150 | 请全局安装 weex-toolkit，并运行： 151 | ``` 152 | weex repair 153 | ``` 154 | 155 | ## Q: 为什么我当前打出来的 js bundle 会这么大 156 | 157 | A: 158 | 目前脚手架中正在集成 tree-shaking，因为官方也并未使用 tree-shaking 来优化包体积，所以需要一定时间。 159 | 160 | 目前可以先这么优化： 161 | ``` 162 | // 当前： 163 | import {buiButton} from 'Eros/bui' 164 | 165 | // 改为： 166 | import buiButton from 'Eros/bui/components/buiButton' 167 | ``` 168 | 169 | 这样能明显减少包体积大小。 170 | 171 | ## Q: iOS资源下载慢，或者等待时间巨长（eros install ios 命令） 172 | 173 | A: 174 | 175 | 执行 `eros install ios` 命令后会从 git 上加载iOS工程所需要的三方SDK，由于网络原因，或者是墙的原因一些资源加载巨慢，甚至会加载失败如下图： 176 | 177 |  178 | 179 | **解决方法**:从 https://github.com/xiaohuapunk/WeexEros3Rd 仓库将里面的资源文件下载到本地，并拷贝到 (你的工程目录)/platforms/ios/WeexEros 中，然后再次执行`eros install ios`命令即可； 180 | 181 | ## Q: IOS模板工程无证书真机调试 182 | 183 | A: 184 | 185 | > 自 Xcode7 版本之后，苹果爸爸允许开发者无证书真机调试（跟有证书的还是存在一些差异的，很多功能都是用不了的，比如推送），简单几步就可以实现无证书真机调试； 186 | 187 | ##### 1.注册个人AppleID 账号 188 | 189 | - 登录开发者后台（https://developer.apple.com/) 注册一个AppleID，如果之前有账号（就是下载app登录的那个账号）登录进去，同意一下条款即可； 190 | 191 | - 在Xcode账号设置中，添加账号 192 | 193 |  194 | 195 | ##### 2.无证书真机调试需要先关闭 `Push Notifications` 功能；不然的话就会报下面的错误提示👇 196 | 197 | > 我们的模板开启了推送功能，所以需要先将这功能关闭，个人账号是没有这功能的 198 |
199 | 200 |  201 | 202 | 解决办法： 203 | 204 | - 修改 Bundle Identifier 注：需要修改成别人没有用到过，苹果会验证唯一性 205 | 206 |  207 | 208 | - 修改team，选择 None（需要先将team设置成none） 209 | 210 |  211 | 212 | - 找到 Gapabilities，将 `Push Notitications` 关闭 213 | 214 |  215 | 216 | ##### 3.在将 Team 设置为自己的账户即可 217 | 218 | ##### 升级工程文件 219 | > 更新前记得将工程备份
220 | > 有些更新需要更新工程文件，通过 `instal`更新不到，需要使用 `eros update` 命令；
221 | 222 | 在终端输入 `eros update` 后按提示输入文件的路径即可更新 223 | 224 | 以下是每个文件路径 225 | - install.sh: `/platforms/ios/WeexEros/install.sh` 226 | - Info：`/platforms/ios/WeexEros/WeexEros/Info.plist` 227 | - Podfile：`/platforms/ios/WeexEros/Podfile` 228 | - AppDelegate.m: `/platforms/ios/WeexEros/WeexEros/AppDelegate.m`
229 | 升级完后需要再次执行 `eros install ios` 230 | 231 | ##### 移除ATSDK 232 | `Weex`默认集成了的 `ATSDK 性能监测工具`，`Eros` 中之前也集成了这个sdk，sdk中用到了私有api，会导致审核不通过，Eros 现在已经将其移除，如果你已经使用`Eros`开发了iOS app 下面是移除方法: 233 | 234 | > 2017.12.22 之后初始化的工程不需要此操作 235 | 236 | ##### 1.升级Podfile文件 237 | 238 | - Podfile：`eros update`，path 填写 `/platforms/ios/WeexEros/Podfile`。 239 | 240 | 241 | ##### 2.升级完后需要再次执行 `eros install ios` 242 | ##### 3.修改配置文件 243 | 244 | > 在Xcode中：找到Other Linker Flags 并展开，在`Debug`和`Release`中，移除 `ATSDK`的引用，注意：需要将上面的 `-framework`也一同移除 245 | 246 |  247 | 248 | ##### 4.重新运行,成功运行起来则说明移除成功了 249 | 250 | ## Q: errCode->wx_network_error msg->Unable to resolve host 'app.weex-eros.com':No address associated with hostname 251 | 252 | A: 253 | 发生这个错误证明您的手机或者模拟器无法连接到您的服务，你需要检查以下情况排查为何无法连接到服务。 254 | 1. 确认服务是否开启，可以访问服务如：app.weex-eros.com:8889 （如果端口没有或者不一样需要对应修改）。 255 | 2. 如电脑可以正常访问，那么请使用手机浏览器访问继续查看。 256 | 3. 如果手机浏览器无法访问，那么您可能需要连接代理。 257 | 4. 如果设置代理以后还是无法访问，请确认代理是否设置成功，您可以尝试用手机访问下百度，是否可以访问，并且代理抓包成功。 258 | 5. 如果您不想设置代理，可以尝试在手机浏览器里直接用ip（如果有端口记得加上）访问您的服务，如果可以直接访问成功的话。 259 | 您可以将eros-demo/config/eros.native.js 文件里 jsServer 字段改成您的 ip (如果有端口记得加上)。 260 | 然后请重新pack运行 Android程序 261 | 262 | 263 | ## Q: Android 如何修改包名（同一个手机可以跑2个eros 项目）。 264 | 265 | A: 修改gradle.properties 文件 APPLICATION_ID （gradle.properties 文件在项目的跟目录）。 266 | 修改完了请记得 点击 sync now 同步下 267 | 268 | 269 | ## Q: Failed to resolve: com.android.support:appcompat 270 | ``` 271 | Failed to resolve: com.android.support:appcompat-v7:25.3.1 272 | Add Google Maven repository and sync project 273 | Show in File 274 | Show in Project Structure dialog 275 | ``` 276 | A： 这时候您可以直接点击 Add Google Maven repository and sync project 等待编译完成即可 277 | 278 | ## Q: 如何实现安卓的finish 279 | 280 | A: 281 | 282 | 1.注册两个属性curHomeBackTriggerTimes: 1, 283 | maxHomeBackTriggerTimes: 2,//代表按几次退出APP。 284 | 2.实现方法 285 | ``` 286 | //安卓自定义退出APP 287 | androidFinishApp() { 288 | const globalEvent = weex.requireModule("globalEvent"); 289 | globalEvent.addEventListener("homeBack", options => { 290 | this.curHomeBackTriggerTimes === this.maxHomeBackTriggerTimes && 291 | this.$router.finish(); 292 | 293 | this.$notice.toast({ 294 | message: `点击返回${ 295 | this.maxHomeBackTriggerTimes 296 | }次之后，会关闭应用，当前点击第${this.curHomeBackTriggerTimes}次` 297 | }); 298 | this.curHomeBackTriggerTimes++; 299 | }); 300 | } 301 | 302 | ``` 303 | 304 | 3.在created中调用此方法 305 | 306 | ## Q: 导入项目后提示`android.enableAapt2 xxxxx`错误 307 | 308 | A: 309 | 出现此类问题主要是AS在导入项目是用了新版本gradle编译插件造成的。eros官方目前推荐且默认使用的gradle版本为4.1，gradle plugin版本为3.0.0。如果你不小心升级了版本，可按照如下操作设置版本。 310 | 311 | 1. 312 |  313 | 314 | 2.点击右上角SynNow按钮同步项目。 315 | 316 | ## Q: 使用 weex-amui 317 | 318 | A: 319 | 1. 安装 `weex-amui` 320 | ```shell 321 | npm install --save weex-amui 322 | ``` 323 | 2. 修改 `.babelrc` 文件， plugins => import 下添加： 324 | ```json 325 | { 326 | "libraryName": "weex-amui", 327 | "libraryDirectory": "packages", 328 | "style": false 329 | } 330 | ``` 331 | 3. 使用 332 | ``` 333 | import { AmButton } from 'weex-amui' 334 | ``` 335 | ## Q: bmchart添加热力图 336 | A: 337 | ### 申请百度地图AK 338 | 1、 访问并登录[百度地图开放平台][1]。 339 | 340 | 2、 创建应用。 341 |  342 | 343 | 3、 完善应用信息。 344 |  345 | 346 | 4、按照要求提交后会自动生成应用及AK值。 347 |  348 | 349 |  350 | 351 | ### 下载所需[bmap.min.js][2]文件。 352 | github: [echarts的地图扩展][3] 353 | 354 | ### 存放html及相应js文件 355 | 356 | 1、将eros内置的bm-chart.html及echarts.min.js文件拷贝，与下载的bmap.js一起放置到assets文件夹下，如下图所示 357 |  358 | 359 | 2、修改bm-chart.html文件，将其中的js路径修改为相对路径并添加百度地图的jssdk路径及bmap的路径，如下图所示 360 |  361 | 362 | ### 数据样例格式 363 | 写法与[eros文档][4]所述一致，只需按照[echarts官网样例][5]配置参数即可。 364 | 365 |  366 | 367 | [1]:http://lbsyun.baidu.com/ "百度地图开放平台" 368 | [2]:https://github.com/apache/incubator-echarts/blob/master/dist/extension/bmap.min.js "bmap.min.js" 369 | [3]:https://github.com/apache/incubator-echarts/tree/master/extension/bmap "echarts的地图扩展" 370 | [4]:https://bmfe.github.io/eros-docs/#/zh-cn/eros_widget "eros文档" 371 | [5]:http://echarts.baidu.com/examples/editor.html?c=heatmap-bmap "heatmap样例" 372 | 373 | ### bmchart引入bm-chart.html文件 374 |
121 |
122 | # License
123 | [MIT](https://opensource.org/licenses/MIT)
124 |
125 | Copyright (c) 2017-present, 本木医疗
--------------------------------------------------------------------------------
/zh-cn/advanced_appboard.md:
--------------------------------------------------------------------------------
1 | ## 由来
2 | 我们知道 weex 推荐通过多页面的形式来构建我们的应用，那么常见的传统多页面造成的问题自然也需要我们去解决，其中影响最大是就是：
3 |
4 | > 所有页面的公共依赖直接会影响的 bundle 体积
5 |
6 | 100 个页面都依赖某些公共模块 `common.js`，假设 `common.js` 大小是 `10 kb`，如果你拆分的不够细，或者写法不支持 tree shaking，那么你每个页面中都会含有这 `10 kb` 的代码，总大小 `1000 kb`，分析一下：
7 |
8 | > 1000kb = 10kb + 990kb（冗余）
9 |
10 | 我只想要打包体积只增长 `10kb`，不要剩余的 `990kb 冗余`，`appboard` 就是帮你减少冗余的。
11 |
12 | ## 什么是 appboard ？
13 | 我们把 board 翻译成为`寄宿`就会好理解，意思就是我们想寄宿在 app 上，他的本质就是一个 `js bundle`，原理大家也不难猜出：
14 |
15 | > 把这些公共逻辑打成一个 `js bundle`，在客户端执行业务 bundle 之前，执行公共逻辑的 `js bundle` 即可。
16 |
17 | ## 使用
18 | > 我们在开发模板中默认帮你配置了 `公共 js bundle` 为 `src/js/config/index.js`，**一般来说你无需进行以下手动配置，直接使用即可**。
19 |
20 | 1.在 `eros.dev.js` 中配置出你想要成为公共 js bundle 的路径：
21 |
22 | ```js
23 | 'exports': [
24 | // appBoard
25 | 'js/config/index.js',
26 | ...
27 | ]
28 | ```
29 |
30 | 2.在 `eros.native.js` 注册，写入 src/js/ 的相对路径。
31 |
32 | ```js
33 | {
34 | ...
35 | 'appBoard': '/config/index.js',
36 | ...
37 | }
38 | ```
39 |
40 | 3.用上面的例子来说，我只想寄宿这`10kb`，我只需把代码放入 `src/js/config/index.js` 中即可。
41 |
42 | ## 建议
43 | > 聪明的你应该已经发现，我们的 widget 就是这样的方式引入进来的，widget 总共大小有 50 多kb，但每个业务 bundle 中并未冗余。
44 |
45 | 但我们还有几点需要注意的：
46 | - **不要往里面放过多的代码，必定会增加每个 bundle 的解析执行的时间！**
47 | - 我们建议公共代码抽离之后放入 `appboard`，非公共的还是在业务 bundle 中自行引入。
48 | - 而你无需在业务的 `js bundle` 中做类似 `import` 这个 `config/index.js` 的代码，因为我们已经在客户端内帮你拼接了。
49 | - 这里路径相差了个 `js` 字符，先记一下，后续会在优化，保持一致。
50 |
--------------------------------------------------------------------------------
/zh-cn/advanced_bindingx.md:
--------------------------------------------------------------------------------
1 | ## bindingx 由来
2 |
3 | 引用官方文档上的介绍：
4 |
5 | * 由于 **weex 底层使用的 JS-Native Bridge 具有天然的异步特性**，这使得 JS 和 Native 之间的通信会有固定的性能损耗，因此在一些复杂的交互场景中，JS 代码很难以高帧率运行。举个例子，如果我们要实现 `视图随手势移动` 的效果，那么按照传统的方式，需要在这个视图上绑定 `touch` 或者 `pan` 事件，当手势发生时， Native 会将手势事件通过 Bridge 传递给 JS , 这产生了一次 Native 到 JS 的通信。而 JS 在接收到事件后，需要根据手指移动的偏移量驱动界面变化，这又会产生一次 JS 到 Native 的通信。**与此同时，手势回调事件触发的频率是非常高的，频繁的通信带来的时间成本很可能导致界面无法在16ms中完成绘制，进而产生卡顿**。
6 |
7 | * 事实上，不仅仅是在 weex 上存在这种问题, React Native 等框架同样存在类似的问题。拿 React Native Animated 组件为例，为了实现流畅的动画效果，这个组件采用了声明式的API，在 JS 端仅仅定义了输入与输出以及具体的 transform 行为，而真正的动画是通过 Native Driver 在 Native 层执行，这样就避免了频繁的通信。然而，这个方案只能解决一部分问题，如果是有复杂交互操作的场景就不够用了。另外，声明式的方式能够定义的行为非常有限，无法满足更复杂的交互场景。
8 |
9 | ## 使用之前
10 | 请熟读官方文档：
11 |
12 | * [bindingx 文档](https://alibaba.github.io/bindingx/guide/cn_introduce)
13 |
14 |
15 | `weex native` 项目的使用过程中需要注意：
16 |
17 | 1.传入的元素需要多取一层 `ref` 属性，假设我们给一个元素上面 `ref` 属性赋值为 `box` ，则使用时候按照以下方式才可：
18 |
19 | ```js
20 | this.$refs.box.ref
21 | ```
22 |
23 | 2.如果引用方式为 `requireModule('bindingx')` 这种 weex 引入 module 的写法，bind 方法按照文档中的方式是无效的，需要做特殊处理，后面会说到。
24 |
25 | 3.ios 端引入的时候需要做下页面手势返回处理 (eros 中拓展了`$router gesBack` 属性)，防止右滑时候出现`手势冲突`。
26 |
27 | ## eros 中使用
28 |
29 | 如果下载官方的 npm 包 `weex-bindingx` 直接使用时没有问题的，但 eros 是主要 focus native，引入 `weex-bindingx` 在打出来一个简单的 JS Bundle 就要 `190+ kb`，很明显有些过于臃肿，在交互复杂的页面，打出来的 JS Bundle 的大小就更加不可控。
30 |
31 | 进入 `weex-bindingx` 源码发现，如果 native 直接使用 `requireModule('bindingx')` 引入，是需要改变 expression 为对象，把填写的表达式值传入对象的 origin 属性，然后传入一个的 `transformed` 属性，这个属性是很长的 CallNative 指令字符串，可以通过下载 npm 包 `bindindx-parser` 来自动生成。
32 |
33 | 于是 eros 做了很简单的二次封装，集成进 `widget` 中，直接通过 `this` 调用即可。
34 |
35 | 下面我们来实现一个官方的 demo：
36 |
37 | 
38 |
39 |
40 | 首先编写模板和样式：
41 |
42 | ```
43 |
44 |
45 |
61 |
62 |
63 |
131 |
132 | ```
133 | 编写 js 逻辑：
134 | ```
135 |
242 | ```
243 | 可以看到，只需要调用 `$bindingx` 即可。
244 |
245 | ## weex native 中使用
246 | **在非 eros 的 weex native 项目中**，我们可以重写 `bind` 方法来保持与官方使用一致，下载 npm 包， `lodash`和 `bindingx-parser` 来进行改造：
247 |
248 | ```
249 | // bindingx.js
250 | import { parse } from 'bindingx-parser'
251 | import _cloneDeep from 'lodash/cloneDeep'
252 |
253 | const WeexBinding = weex.requireModule('bindingx')
254 | const BindingxFunction = WeexBinding.bind
255 |
256 | let _WeexBinding = _cloneDeep(WeexBinding)
257 |
258 | // 重写 bind 方法
259 | _WeexBinding.bind = (options, callback) => {
260 | if (!options) {
261 | throw new Error('should pass options for binding')
262 | }
263 |
264 | options.exitExpression = formatExpression(options.exitExpression)
265 |
266 | if (options.props) {
267 | options.props.forEach((prop) => {
268 | prop.expression = formatExpression(prop.expression)
269 | })
270 | }
271 |
272 | return BindingxFunction(options, options && options.eventType === 'timing' ? fixCallback(callback) : callback)
273 | }
274 |
275 | module.export = _WeexBinding
276 | ```
277 | 在业务中使用：
278 | ```
279 | var bindingx = require('bindingx')
280 | ```
281 | 这样在打包之后非压缩状态下体积能减少到 `34kb` 左右。而 eros js bundle 的大小会更小，已经把这部分重写逻辑放入了 `widget`，通过 `appboard.js` 来内置到客户端执行。
282 |
283 | 现在，尽情使用 bindingx 吧！
284 |
285 |
286 |
--------------------------------------------------------------------------------
/zh-cn/advanced_diff.md:
--------------------------------------------------------------------------------
1 | > 更新逻辑已开源，使用文档 [eros-publish](https://github.com/bmfe/eros-publish)，下面我们说下增量发布的大概实现逻辑。
2 |
3 | ### 需要更新的资源
4 |
5 | weex 的优势之一就是业务发布可以不走 App Store 的审核，能实现业务快速更新，快速落地，需要更新的资源大致分下面几类
6 |
7 | * native 代码部分
8 | * js 业务代码
9 | * 图片、iconfont 等静态资源
10 |
11 | #### native 代码部分
12 |
13 | 苹果之前 对 native 热更新方案进行警告之后，这部分目前希望大家谨慎尝试。
14 |
15 | #### js 业务代码
16 |
17 | 我们认为所有脱离了 native 部分的代码都是业务代码，weex-eros 设计的页面交互是多页面，并不适用 vue-router，配合封装的路由，基本上是一个页面对应一个 js 文件，就像是回到了多年前的多页面时代。但是这带来的原生的页面切换，交互体验好了很多，也一定程度的抹平了初始化渲染的性能问题。这部分代码的更新是一定牵涉业务的，这也是更新包的主要部分。
18 |
19 | #### 图片、iconfont 等静态资源
20 |
21 | 图片部分：图片这块目前没有做打包本地，虽然会有加快一定的渲染速度，但随着业务的变化，这块会增加更新包的大小，有可能更新包里的图片都不会被用户使用，但是还是下载下来了，造成用户流量浪费也增加了更新包的大小，目前的方案是发送请求，图片资源客户端会缓存到本地，二次加载同一张图片就会变快。
22 |
23 | iconfont：如果在样式解释的时候没有找到字体图标文件，字体图标就会找不到，并且 iconfont 请求完成之后不会更新当前视图，所以 iconfont 必须要做增量更新，大小对包的影响不大。所以放在增量包中。
24 |
25 | ### 更新包设计
26 |
27 | 经过上面的分析，我们的更新包包括两部分：js 业务代码和 iconfont。我们目前将这两部分的代码加上一个 md5.json，生成一个 .zip 压缩包。
28 |
29 | md5.json 内容如下：
30 |
31 | ```js
32 | {
33 | // 所有页面对应的 js 文件，用于做单个文件完整性校验
34 | "filesMd5": [{
35 | "android": "1.0.0",
36 | "iOS": "1.0.0",
37 | "page": "/pages/home/index.js",
38 | "md5": "c2125dfab756dc0e9cfe854a297a0512"
39 | }, {
40 | "android": "1.0.0",
41 | "iOS": "1.0.0",
42 | "page": "/iconfont/iconfont.ttf",
43 | "md5": "50ed903231bcdc851bfde9a0bf565e38"
44 | }],
45 | // 当前 zip 包依赖的最低的安卓版本号
46 | "android": "1.0.0",
47 | // 当前 zip 包依赖的最低的 iOS 版本号
48 | "iOS": "1.0.0",
49 | // 当前这个 appName，用于区分不同 APP 业务的 key
50 | "appName": "demo",
51 | // 当前这个 zip 包的版本号
52 | "jsVersion": "56a4569f271294a05e4ff0f567d332b4",
53 | // 生成当前 zip 包版本号的时间戳
54 | "timestamp": 1489983294137
55 | }
56 | ```
57 |
58 | filesMd5 中的每一项就是当前这个 zip 包文件中的文件信息，根据每个文件内容会生成一个 MD5 值，当前包的 MD5 值作为当前包的版本号，会根据这个 MD5 进行文件完整性的校验
59 |
60 | 客户端可以根据每一个文件来看下载下来的文件有没有缺失，如果有缺失，这里就需要看策略了，是直接去请求线上最新的这个 js 文件还是重新下载 zip
61 |
62 | ### **如何增量**
63 |
64 | 当出现第一个版本之后，我们就需要考虑每次升级的问题了，我们肯定不希望每次都去下载完整的 zip 包，浪费流量。也不可能实时 diff，这样更新肯定会慢，所以我们想用空间换时间的方式。
65 |
66 | 每生成一次完整的资源包，需要和当前已有的资源包进行一次 diff，生成若干差分包。每次 APP 更新的时候只需要下载差分包就行了。如：
67 |
68 | > * 新版本\(v3\) - 旧版本\(v1，v2\) = 全新的 v3 包、v3-v1 差分包、v3-v2 差分包
69 | > * 然后，APP 根据自己的当前版本，比如 v2，下载对应的增量包 v3-v2。
70 | > * 然后本地进行合并。 v2 完整包 + v3-v2 差分包，得到完整的 v3 新包。
71 |
72 | ### 增量包生成
73 |
74 | zip 包的生成依赖的是 bsdiff，这个需要本地装一个 bsdiff
75 |
76 | ```js
77 | // 命令行生成差分包命令：
78 | bsdiff oldZip newZip diffZip
79 | //命令行合并差分包命令：
80 | bspatch oldZip diffZip newZip
81 | ```
82 |
83 | 生成的 diffZip 包命名可以有一些命名的算法，这样的命名在存储的时候就不需要存差分包和完整包的映射 了。
84 |
85 | 在生成差分包时需要指定所有完整的包目录，在 demo 中 config.js 有对应的配置，每次发布都会将完整的 zip 放在 打包机上，每次都会和留下的这些完整的包进行对比生成差分包。
86 |
87 | 至此，我们的打包工作就完成了
88 |
89 | ### 增量发布流程设计
90 |
91 | #### 服务器支持
92 |
93 | 增量包生成完成之后会生成一个 version.json 文件，并将文件内容上传至服务器，服务器存下版本，下次返回客户端是否需要更新的凭证。下面是 version.json 的具体内容，服务器存下多个版本之后就可以对客户端每次是否需要更新进行回复。
94 |
95 | 发布地址配置在 config.js 中有对应的配置，这里主要说明一下后端的逻辑。
96 |
97 | ```js
98 | {
99 | // 当前 zip 包依赖最低安卓版本
100 | "android": "1.0.0",
101 | // 当前 zip 包依赖最低 iOS 版本
102 | "iOS": "1.0.0",
103 | 当前这个 appName，用于区分不同 APP 业务的 key
104 | "appName": "demo",
105 | // 当前 zip 包的版本号
106 | "jsVersion": "cd34091af113f98c2cbf4d81131ccdde",
107 | // 生成版本号时的时间戳
108 | "timestamp": 1489997936509,
109 | // 对应的静态资源服务器的地址
110 | "jsPath": "https://xxx.xxx.com/app/"
111 | }
112 | ```
113 |
114 | ### 检测更新场景
115 |
116 | 增量更新包管理，可以以 当前客户端版本号+当前客户端版本能使用的最新压缩包版本号 进行 md5，这样的管理方式，后端和资源包能解耦关系，更好的维护版本包。
117 |
118 | #### 客户端请求参数
119 |
120 | ```js
121 | 请求参数：
122 |
123 | {
124 | // 当前客户端版本号
125 | "android[or iOS]": "1.0.0",
126 | // 当前 APP 业务的名称
127 | "appName": "demo",
128 | // 当前 zip 包的版本号
129 | "jsVersion": "cd34091af113f98c2cbf4d81131ccdde",
130 | // 是否需要差分包，如果是 false 则返回完整的 zip 包，完整 zip 包多用于特殊情况
131 | "isDiff": true
132 | }
133 | ```
134 |
135 | 后端对更新逻辑的判断
136 |
137 | ```js
138 | 必传参数：appName、iOS/android
139 | 步骤1：
140 | 查询库里当前的 appName 和 iOS/android 版本号相同的数据
141 | 无结果：返回固定错误码，错误信息 未查询到更新版本信息
142 | 有结果：继续下一步
143 | 步骤2：
144 | 查询库中客户端传过来的 appName、iOS/android、jsVersion 的数据
145 | 无结果：返回需要更新，isDiff = false，返回当前 jsPath：jsPath + jsVersion + '.zip'
146 | 有结果：比对当前
147 |
148 | 查询当前 appName 和 iOS/android 值相同的 (timestamp 最大的 jsVersion)
149 |
150 | 判断 isDiff 的值
151 | false：判断客户端传的 jsVersion 和 (timestamp 最大的 jsVersion)
152 | 相等：返回无需更新
153 | 不相等：返回需要更新，isDiff = false，jsPath：jsPath + jsVersion + '.zip'
154 | true：判断客户端传的 jsVersion 和 (timestamp 最大的 jsVersion)
155 | 相等：返回无需更新
156 | 不相等：返回需要更新 isDiff = true，jsPath：jsPath + md5(客户端传的 jsVersion + (timestamp 最大的 jsVersion)) + '.zip'
157 | ```
158 |
159 | #### 更新场景1
160 |
161 | 发布了新版本，需要更新，这也是最常见的更新场景。发送请求参数如下：
162 |
163 | ```js
164 | {
165 | // 当前客户端版本号
166 | "android[or iOS]": "1.0.0",
167 | // 当前 APP 业务的名称
168 | "appName": "demo",
169 | // 当前 zip 包的版本号
170 | "jsVersion": "cd34091af113f98c2cbf4d81131ccdde",
171 | // 是否需要差分包，如果是 false 则返回完整的 zip 包，完整 zip 包多用于特殊情况
172 | "isDiff": true
173 | }
174 | ```
175 |
176 | 接口返回场景1
177 |
178 | 当前 jsVersion 在数据库中不存在，这种情况下无法生成差分包，也有可能是包的信息被篡改了，此时返回需要更新，并返回完整的更新包地址，客户端不做差分合并
179 |
180 | ```js
181 | {
182 | // 此次请求有没有问题
183 | "resCode": 0,
184 | // 此次请求描述
185 | "msg": "当前版本已是最新，不需要更新",
186 | // 回溯的数据
187 | "data": {
188 | // 表示这是一个完整的包
189 | "diff": false,
190 | // 完整包的地址
191 | "path": "https://xxx.xxx.com/app/cd34091af113f98c2cbf4d81131ccdde.zip"
192 | }
193 | }
194 | ```
195 |
196 | 接口返回场景2
197 |
198 | 当前 jsVersion 在数据库中存在，当前客户端版本号下，jsVersion 已经是最新的，不需要更新
199 |
200 | ```js
201 | {
202 | // 此次请求有没有问题
203 | "resCode": 1000,
204 | // 此次请求描述
205 | "msg": "当前版本已是最新，不需要更新",
206 | // 回溯的数据
207 | "data": {}
208 | }
209 | ```
210 |
211 | 接口返回场景3
212 |
213 | 当前 jsVersion 在数据库中存在，当前客户端版本号下，jsVersion 还有更新的版本，获取差分包，进行合并再解压。
214 |
215 | 服务端查询当前库中最新的版本号，得到差分包的下载地址并返回。
216 |
217 | ```js
218 | {
219 | // 此次请求有没有问题
220 | "resCode": 0,
221 | // 此次请求描述
222 | "msg": "当前版本已是最新，不需要更新",
223 | // 回溯的数据
224 | "data": {
225 | // 当前下载的 js 的 verison
226 | "jsVersion": "cd34091af113f98c2cbf4d81131ccdde",
227 | // 表示这是一个完整的包
228 | "diff": true,
229 | // 完整包的地址
230 | "path": "https://xxx.xxx.com/app/cd34091af113f98c2cbf4d81131ccdde.zip"
231 | }
232 | }
233 | ```
234 |
235 | 接口返回场景4
236 |
237 | 当前 jsVersion 在数据库中存在，当前客户端版本号下，jsVersion 还有更新的版本，但是获取差分包失败，这个情况下客户端会重新发起一个请求，获取当前客户端版本号下完整的 zip 包
238 |
239 | #### 更新场景2
240 |
241 | 本地不存在包，或者校验包的完整性发现 zip 包有问题时，直接请求最新的 zip 包。
242 |
243 | ```js
244 | {
245 | // 当前客户端版本号
246 | "android[or iOS]": "1.0.0",
247 | // 当前 APP 业务的名称
248 | "appName": "demo",
249 | // 是否需要差分包，如果是 false 则返回完整的 zip 包，完整 zip 包多用于特殊情况
250 | "isDiff": false
251 | }
252 | ```
253 |
254 | 接口返回场景1
255 | 当前 jsVersion 在数据库中不存在，这种情况下无法生成差分包，也有可能是包的信息被篡改了，此时返回需要更新，并返回完整的更新包地址，客户端不做差分合并
256 |
257 | ```js
258 | {
259 | // 此次请求有没有问题
260 | "resCode": 0,
261 | // 此次请求描述
262 | "msg": "当前版本已是最新，不需要更新",
263 | // 回溯的数据
264 | "data": {
265 | // 表示这是一个完整的包
266 | "diff": false,
267 | // 完整包的地址
268 | "path": "https://xxx.xxx.com/app/cd34091af113f98c2cbf4d81131ccdde.zip"
269 | }
270 | }
271 | ```
272 |
273 |
274 |
275 |
--------------------------------------------------------------------------------
/zh-cn/advanced_mediator.md:
--------------------------------------------------------------------------------
1 | # 由来
2 | 在传统多页面中，各个页面之前的交互几乎很少，都通过 `url 传参`或者`本地存储`等简单的方式来进行交流，而像 weex 这样把整个 app 都当做一个多页面来处理显然是不太合理的。
3 |
4 | 我们需要一个全局的地方，常驻内存，不被销毁
5 | 举个例子，app 个推推送过来，你要在无论当前在哪个页面都想弹出一个 toast，weex 中你需要在每个页面都写这个公共逻辑。
6 |
7 | > 这样当你有 100 个页面，你就注册了 100 个监听个推回调的事件。
8 |
9 | 而我们期望只监听一次这个事件，然后执行即可，所以 mediator 就出现了：
10 |
11 | > mediator 中介者，本质是个 JS bundle，在程序最开始实例化常驻在内存中，不被销毁。
12 |
13 | ## 使用
14 | > 我们在开发模板中默认帮你配置了 `公共 js bundle` 为 `src/js/mediator/index.js`，**一般来说你无需进行以下手动配置，直接使用即可**。
15 |
16 | 1.在 `eros.dev.js` 中配置出你想要成为公共 js bundle 的路径：
17 |
18 | ```js
19 | 'exports': [
20 | // mediator
21 | 'js/mediator/index.js',
22 | ...
23 | ]
24 | ```
25 |
26 | 2.在 `eros.native.js` 注册，写入 src/js/ 的相对路径。
27 |
28 | ```js
29 | {
30 | ...
31 | 'mediator': '/mediator/index.js',
32 | ...
33 | }
34 | ```
35 |
36 | 3.用上面的例子来说，我们把监听个推的事件代码放入 `src/js/mediator/index.js` 中即可。
37 |
38 | 注意：
39 | - 每次修改之后需要重启 app 才可以看到变动。
40 | - 中介者中试用 weex dom 无效，因为没有页面。
41 | - 中介者与其他页面交互需要通过`发布订阅`。
--------------------------------------------------------------------------------
/zh-cn/advanced_publish.md:
--------------------------------------------------------------------------------
1 | >时间就是金钱，热更新能避免 appStore 的审核，为 app 迭代提供强大动力。
2 |
3 | ## Git 地址
4 | > [https://github.com/bmfe/eros-publish](https://github.com/bmfe/eros-publish)
5 |
6 | ## 开始之前
7 | 本章内容会与开发者一起在`本地构建热更新服务`，开始本章内容前，请再次确保您已经运行起 eros 开发的整套流程，**如果需要构建到服务端/自动构建平台上，我们建议您先了解一些后端基础，在尝试构建 `热更新`**。
8 |
9 | ## eros 为什么要做自己的热更新？
10 | 如果您之前熟读了我们的[入门指南](https://bmfe.github.io/eros-docs/#/zh-cn/tutorial_newcomer)，大概就理解为什么 eros 要做`内置包热更新`，这里在列举一下。
11 |
12 | **相对于 weex 每次都走线上请求最新的 bundle，我们做内置包的设计是考虑到如下场景：**
13 |
14 | 1.发布了新页面。
15 |
16 | - weex 场景：新的页面，不做自身缓存策略的话，会加载远端的 bundle，首次加载会很慢，这样页面就会出来的比较慢。
17 | - eros 场景：客户在使用中还是访问老的页面，下次进入 app 更新访问新的，每次从本地读取 bundle，很快。
18 |
19 | 2.bundle 打包体积。
20 |
21 | - weex 场景：weex 推荐多页面，所以每个页面都是个 bundle，意味着使用时候如果不做特殊处理，按需引入，每个 bundle 会有很多重复的冗余代码，尽管 weex 相比 rn，bundle 的体积已经小很多了。
22 | - eros 场景：weex 在本地有一个公共的 js bundle (appboard)，我们把公共逻辑都放入这里，每次打包都打一份代码，并把公共代码在客户端来进行拼接这行，虽然这样不太规范，**但这样的方式使我们的 bundle 大小减少了 60% +，100 多个页面，内置包大小仅仅为 2MB**。
23 |
24 | 3.用户在挂号这条业务线中走到了支付这一步，挂号流程改造，支付的时候多加了些参数。
25 |
26 | - weex 场景：发布了新的版本，如果没有做好自身的缓存兼容逻辑，支付页面跳转了新的页面，前端就每次都需要考虑兼容版本之间兼容。
27 | - eros 场景：客户端本地更新了最新的内置包，不会立即更新，用户完成此次 app 使用，下次进入 app 时才会提示更新。
28 |
29 | 4...
30 |
31 | 我们还能列出许多相似的场景，不难看出，内置包热更新的设计，更适于纯 weex native 的项目。
32 |
33 | ## 模拟 EROS 热更新
34 | ### 环境
35 | - node > 7.x.x
36 | - mongoDB > v3.4.9
37 |
38 | ### 工具
39 | - supervisor 开发
40 | - pm2 部署
41 | - Robo 3T (mongoDB 可视化工具)
42 |
43 | 安装都比较简单，装到全局即可，不过多赘述。
44 |
45 | ### clone 项目
46 | ```
47 | $ git clone https://github.com/bmfe/eros-publish.git
48 | $ cd eros-publish/server
49 | $ npm i
50 | ```
51 | ### 修改配置
52 | ```
53 | // eros-publish/server/config.js
54 | module.exports = {
55 | db:'mongodb://localhost:27017/app',
56 | defaultPort: 3001,
57 | staticVirtualPath: '/static',
58 | staticRealPath: '/Users/yangmingzhe/Work/opensource/',
59 |
60 | zipReturn: 'diff'
61 | }
62 | ```
63 | - `db`: 数据库服务地址
64 | - `defaultPort`: 热更新服务默认端口
65 | - `staticVirtualPath`: 静态虚拟地址
66 | - `staticRealPath`: 静态真实地址
67 | - `zipReturn`: 返回包的开关，`full` 是任何情况下都返回`全量包`， `diff` 则是任何情况下都返回`增量包`
68 |
69 | 这里说下 `staticVirtualPath` 和 `staticRealPath`，拿上面例子来说，访问虚拟地址 ('/static') ，其实是访问的真实地址 ('/Users/yangmingzhe/Work/opensource/') 下的资源。
70 |
71 | > http://localhost:3001/static => /Users/yangmingzhe/Work/opensource/
72 |
73 | 所以当我们把自己的项目放到 opensource 下，就可以让别人通过`/static` 访问到你项目中的打包生成好的资源文件 `(dist)`。
74 | ### 开发调试
75 |
76 | - 开启数据库:
77 | 权限不足用sudo
78 | ```
79 | $ mongod
80 | ```
81 |
82 | - 打开 `Robo 3T` 可视化工具：
83 |
84 | 这时候会提示你链接到你的数据库，链接即可。
85 |
86 | - 运行后端服务
87 | ```
88 | $ supervisor app.js
89 | ```
90 | 看到如下界面后:
91 |
92 | 后端已经调通了。
93 |
94 | ### 接口
95 | 总共就 3 个接口，需要我们先熟悉一下：
96 | * 发布列表
97 | * path: `/app/list`
98 | * method: `GET`
99 | * params:
100 | * appName: app名称
101 | * 增加发布记录
102 | * path: `/app/add`
103 | * method: `POST`
104 | * params:
105 | * appName: { type: **String**, require: **true**, desc: **"app 名称"**},
106 | * jsPath: { type: **String**, require: **true**, desc: **"js bundle 下载路径，也就是 eros.dev.js 中的 diff.proxy"**},
107 | * iOS: { type: **String**, require: **true**, desc: **"ios 版本号"**},
108 | * android: { type: **String**, require: **true**, desc: **"android 版本号"**},
109 | * jsVersion: { type: **String**, require: **true**, desc: **"当前 bundle 的 md5 值"**},
110 | * timestamp: {type: **Number**, require: **true**, desc: **"单当前包生成的时间**"}
111 | * 检查是否更新
112 | * path: `/app/check`
113 | * method: `POST`
114 | * params:
115 | * appName: { type: **String**, require: **true**, desc: **"app 名称"**},
116 | * jsPath: { type: **String**, require: **true**, desc: **"js bundle 下载路径，也就是 eros.dev.js 中的 diff.proxy"**},
117 | * iOS: { type: **String**, require: **true**, desc: **"ios 版本号"**},
118 | * android: { type: **String**, require: **true**, desc: **"android 版本号"**},
119 | * jsVersion: { type: **String**, require: **true**, desc: **"当前 bundle 的 md5 值"**}
120 |
121 | `/app/check`中 ios 和 android 二选一。
122 |
123 | ### 修改模板配置
124 | 1. 这里我们重新生成了一个名叫 eros-demo 的默认项目，在本地 `/Users/yangmingzhe/Work/opensource/` 绝对路径下，注意这个就是我上面填写的 `staticRealPath`。
125 | 2. 修改 eros.native.js 中的 `url.bundleUpdate`，由上面的接口我们能知道，需要 app 进行更新检测的接口是 `/app/check`，所以我们填写 `http://localhost:3001/app/check`即可
126 | 3. 修改 eros.dev.js 中的 diff 对象
127 | * `pwd`: 每次更新的全量包我们都存放到这个地址，这样每次差分包的生成都会遍历这个路径下的全量包生成，建议无论是在本地还是在服务器上，都先建好这个目录，我这里写我本地的路径一个新建的目录`/Users/yangmingzhe/Work/opensource/eros-diff-folder`
128 | * `proxy`: 能被用户访问到的路径，由于上面我们配置了 `staticVirtualPath`，这样我们就能在 `http://localhost:3001/static/` 访问到我们的 eros-demo 项目资源，填写路径为 `http://localhost:3001/static/eros-demo/dist/js/`
129 |
130 | ### 模拟更新
131 | 这里需要用到两条指令：
132 | - `$ eros pack -s url`: 构建全量包，内置到两端成为内置包，并将包信息发送 eros-publish 来记录。
133 | - `$ eros build -s url -d`: 构建最新全量包，遍历 eros.dev.js 下 diff.pwd 历史版本分别生成差分包，并将全量包信息发送服务器
134 |
135 | > 差分包 v1-v2 = md5(全量包 v1 md5 + 全量包 v2 md5)
136 |
137 | 首先我们构建模拟 iOS app v1.0.0 首次发版情况。
138 | 1. 修改业务代码，模拟我们 1.0.0 的功能，添加首页加一行代码：
139 | ```
140 |
46 |
60 |
47 |
59 |
48 |
49 | HACKER
50 |
51 |
52 | Google announced a new version of Nearby Connections for fully offline.high bandwidth peer to peer device communications.
53 |
54 |
58 | 您申请的应用签名请一定与您的包名一致，否则可能导致微信无法回调 10 | 11 | **Android 相关配置** 12 | 13 | 1.打开Android目录工程目录/platforms/android/WeexFrameworkWrapper/app,编辑app目录下build.gradle 文件 dependencies 下添加引用，代码如下： 14 | 15 | dependencies { 16 | ...... 17 | compile 'com.github.bmfe:eros-plugin-android-wxpay:1.1.0' // 具体版本参考最新 18 | } 19 | 20 | 2.打开Android目录工程目录/platforms/android/WeexFrameworkWrapper/app/src/main/java/com/benmu/wx/wxapi/下的WXEntryActivity.java和WXPayEntryActivity.java解开注释 21 | 22 | 3.更改Android目录工程目录/platforms/android/WeexFrameworkWrapper/app/src/main/AndroidManifest.xml 23 | 24 | ``` 25 |
13 | * 打开iOS目录`工程目录/platforms/ios/WeexEros`，编辑Podfile文件，修改版本号（即 tag对应的版本号），库每次升级后都会有相关说明文档详情请看页面最下方的 Change Log，如需升级将 tag 修改为对应的版本即可； 14 | ```ruby 15 | def common 16 | ...忽略其他库的引用 17 | #集成 Eros iOS 基础库 18 | pod 'ErosPluginBaseLibrary', :git => 'https://github.com/bmfe/eros-plugin-ios-baseLibrary.git', :tag => '版本号' 19 | end 20 | target 'WeexEros' do 21 | common 22 | end 23 | ``` 24 | 25 | * 在终端中`cd`到此目录下执行 `pod update`，就会重新拉取最新版本的文件，等待命令执行完毕即可； 26 | 27 | **Android 集成** 28 | 29 | * 进入Android目录`工程目录/platforms/android/WeexFrameworkWrapper/` 目录下 clone 对应的插件。 30 | 31 | ``` java 32 | git clone https://github.com/bmfe/WeexErosFramework.git "wxframework" 33 | git clone https://github.com/bmfe/eros-nexus.git "nexus" 34 | ``` 35 | 36 | > 具体版本为Tag,如果您需要使用指定版本的话可以切换到指定的Tag. 37 | 38 | 39 | * 打开Android目录`工程目录/platforms/android/WeexFrameworkWrapper/`,编辑`settings.gradle`,添加引入。 40 | 在`settings.gradle` 中 添加如下代码。 41 | 42 | ``` java 43 | include ':app',':sdk',':nexus', ':wxframework' //(这里只需要添加 app 后面的 既 ：,':sdk',':nexus', ':wxframework' ) 44 | 45 | // 基础库 46 | project(':wxframework').projectDir = new File(settingsDir,'/wxframework/eros-framework') 47 | project(':sdk').projectDir = new File(settingsDir,'/nexus/sdk') 48 | project(':nexus').projectDir = new File(settingsDir,'/nexus/nexus') 49 | 50 | ``` 51 | 52 | * 打开Android目录`工程目录/platforms/android/WeexFrameworkWrapper/app`,编辑app目录下`build.gradle` 文件 `dependencies` 下添对应 插件引用。 53 | 54 | ``` java 55 | dependencies { 56 | .... 57 | compile project(':nexus') 58 | compile project(':wxframework') 59 | } 60 | ``` 61 | 62 | * 具体Android 插件详细集成方式 您还可以参考[Android 插件依赖](/zh-cn/android_plugin_integration) 63 | 64 | ## Change Log 65 | **iOS 1.3.3** 2018.11.23
66 | * 优化App启动逻辑，避免热更新时重复初始化Weex环境； 67 | * 解决BMEvent `off` 方法不能取消监听事件的问题； 68 | 69 | **iOS 1.3.3** 2018.11.14
70 | * [update] 适配WeexSDK 0.19.0版本； 71 | * 升级部分依赖库； 72 | 73 | **iOS 1.3.2** 2018.10.11
74 | * [bugfix] 修复拓展的上拉加载更多loadMore事件与weex默认的loadmore事件冲突的问题；感谢 陈远•Frank，M、的贡献，[文档请戳](https://bmfe.github.io/eros-docs/#/zh-cn/base_extend?id=上拉加载更多) 75 | * [bugfix] 修复iPhoneX的判断方法；感谢 Shawn唐的贡献； 76 | 77 | **iOS 1.3.1** 2018.09.25
78 | * [教程] 升级 Xcode 10后会编译报错，请参考这篇文章来解决相关问题；[请戳这里](https://www.jianshu.com/p/6d94278d62b3) 79 | * [bugfix] 修复使用Xcode10开发并运行在iOS12系统上设置导航栏背景色无效的问题； 80 | * [bugfix] 解决使用`bmBundleUpdate`module进行热更新，当解压缩失败时没有回调callback的问题； 81 | * [optimize] 网络请求一些代码优化； 82 | * [update] 基础库包名已修改（ErosPluginBaseLibrary），详情请看上面的集成方式； 83 | 84 | **Android 1.1.0** 2018.09.07
85 | * [bugfix] input组件，type为number时不能输入小数点 86 | * [bugfix] 修复判断前后台方法错误问题. 87 | * [feature] 添加虚拟按键高度全局属性 virtualButtonsHeight 88 | 89 | **iOS 1.3.0** 2018.08.02
90 | * [bugfix-iOS]`
96 | * [feature]`bmNavigator` module 添加隐藏状态栏功能；[文档请戳](https://bmfe.github.io/eros-docs/#/zh-cn/eros_sdk_module?id=bmnavigator) 97 | * [feature]`bmBundleUpdate` module 添加获取 JSVersion 方法；[文档请戳](https://bmfe.github.io/eros-docs/#/zh-cn/eros_sdk_module?id=bmbundleupdate) 98 | * [optimize]`bmchart`component 支持加载自定义 html 文件；[文档请戳](https://bmfe.github.io/eros-docs/#/zh-cn/eros_sdk_component?id=图表组件) 99 | 100 | **Android 1.0.8** 2018.07.26
101 | * [bugfix-Android]`tabbar` 多页面 `watchIndex` 只有一个生效问题 102 | * [bugfix-Android]`tabbar` 生命周期触发不正常问题。 103 | * [bugfix-Android] 解决issue[#248][#246] 104 | * [bugfix-Android] 解决部分页面内存泄漏问题 105 | * [bugfix-Android] 优化图片加载过多 的OOM 问题。 106 | * [feature]新增 `web` 标签支持本地html 107 | 108 | **iOS 1.2.9** 2018.07.26
109 | * [bugfix-iOS] `web`标签通过url传参参数丢失问题； 110 | * [bugfix-iOS] 微信分享插件、微信支付插件判断是否安装微信方法无效的问题（请升级最新版本）； 111 | * [optimize-iOS] 优化 `bmChart` 加载本地js资源的方法； 112 | 113 | 114 | **Android 1.0.7** 2018.07.18
115 | * [bugfix]加载本地`html`参数丢失的问题； 116 | * [bugfix-Android]`input`标签动态切换`type = password`不生效； 117 | * [bugfix-Android]从后台进入app、tabbar上所有页面都会触发生命周期，应该只有当前显示的页面触发； 118 | * [bugfix-Android]`image`标签动态设置高度图片变形； 119 | * [bugfix-Android]加载本地`html`参数丢失的问题； 120 | * [feature]`bmTabbar` 新增监听切换页面方法、获取当前下标方法、及动态修改tabbar配置信息。[文档请戳](https://bmfe.github.io/eros-docs/#/zh-cn/eros_sdk_module?id=bmTabbar)； 121 | * [feature-Android]更新`jsbundle`添加弹窗提示，行为保持跟iOS一致； 122 | * [feature]新增`bmBundleUpdate`module，开发者可以自定义更新`jsbundle`逻辑。[文档请戳](https://bmfe.github.io/eros-docs/#/zh-cn/eros_sdk_module?id=bmBundleUpdate)； 123 | * [feature]`weex.config.eros`中添加`tabbarHeight`原生`TabBar`高度参数； 124 | * [feature]`bmImage`module 新增 `scanImage()`方法，识别图片二维码。[文档请戳](https://bmfe.github.io/eros-docs/#/zh-cn/eros_sdk_module?id=bmimage)；感谢 [scholar-ink](https://github.com/scholar-ink)提供pr； 125 | * [feature]`bmRouter`module 添加 `claerHomePage()` 方法清除之前设置的首页; 126 | * [feature]新增友盟统计插件。[使用文档请戳] 127 | 128 | 129 | **iOS 1.2.8** 2018.07.18
130 | * [bugfix]加载本地`html`参数丢失的问题； 131 | * [bugfix]`mediator.js`中使用`bmRouter`跳转页面无效; 132 | * [feature]`bmTabbar` 新增监听切换页面方法、获取当前下标方法、及动态修改tabbar配置信息。[文档请戳](https://bmfe.github.io/eros-docs/#/zh-cn/eros_sdk_module?id=bmTabbar)； 133 | * [feature]新增`bmBundleUpdate`module，开发者可以自定义更新`jsbundle`逻辑。[文档请戳](https://bmfe.github.io/eros-docs/#/zh-cn/eros_sdk_module?id=bmBundleUpdate)； 134 | * [feature]`weex.config.eros`中添加`tabbarHeight`原生`TabBar`高度参数； 135 | * [feature]`bmImage`module 新增 `scanImage()`方法，识别图片二维码。[文档请戳](https://bmfe.github.io/eros-docs/#/zh-cn/eros_sdk_module?id=bmimage)；感谢 [scholar-ink](https://github.com/scholar-ink)提供pr； 136 | * [feature]`bmRouter`module 添加 `claerHomePage()` 方法清除之前设置的首页; 137 | 138 | **iOS 1.2.7** 2018.07.04
139 | * [bugfix]修复debug按钮不兼容iPad8.0系统的问题；感谢 zhongdong提的pr； 140 | * [bugfix]修复原生tabbar设置上边栏颜色不生效的问题； 感谢 zhongdong提的pr； 141 | * [feature]
146 | * [bugfix]修复fetch传递参数不是字符串时导致的崩溃问题。 147 | * [bugfix]修复tabbar 切换不触发生命周期。 148 | * [feature]`
153 | * [feature] 新增`bmTabbar`Module，支持设置tabbar数字角标及红点 [文档请戳](https://bmfe.github.io/eros-docs/#/zh-cn/eros_sdk_module?id=bmTabbar)； 154 | * [bugfix]修复mediator.js中使用router跳转页面无效的问题； 155 | * [update]优化请求失败返回错误信息的逻辑； 156 | 157 | **Android 1.0.5** 2018.06.21
158 | * [feature] 新增`bmTabbar`Module，支持设置tabbar数字角标及红点 [文档请戳](https://bmfe.github.io/eros-docs/#/zh-cn/eros_sdk_module?id=bmTabbar)； 159 | * [bugfix-Android]解决无法获取联系人问题； 160 | * [bugfix-Android]解决Tabbar 无法连接 weex-debugger 问题； 161 | * [bugfix-Android]解决导航栏 在4.4.4Androud 版本兼容性问题； 162 | * [bugfix-Android]解决拍照 allowCrop 不生效问题 ； 163 | 164 | **iOS 1.2.5** 2018.06.06
165 | 166 | * bmAxios 请求支持 application/x-www-form-urlencoded 表单格式; 167 | 168 | **Android 1.0.4** 2018.05.30
169 | 170 | * Axios支持表单提交格式; 171 | * 解决Tabbar 刷新崩溃问题; 172 | * 修复v-model问题; 173 | * 插件最新版本 174 | ``` 175 | implementation 'com.github.bmfe.eros-nexus:nexus:1.0.3' 176 | implementation 'com.github.bmfe:WeexErosFramework:1.0.4' 177 | ``` 178 | 179 | **Android 1.0.3** 2018.05.30
180 | 181 | * 拓展原生tabBar; 182 | * sdk恢复源码依赖; 183 | * 解决APP启动黑屏问题; 184 | 185 | **iOS 1.2.5** 2018.06.06
186 | 187 | * [feature] bmAxios 请求支持 application/x-www-form-urlencoded 表单格式； 188 | 189 | **iOS 1.2.4** 2018.05.30
190 | 191 | * 拓展原生tabBar; 192 | * router open 方法添加 backgroundColor 参数； 193 | * axios请求返回 response header； 194 | * bmToolModul 添加监听网络状态方法； 195 | * 修复点击推送消息唤起App崩溃的问题（请更新推送插件）； 196 | 197 | **iOS 1.2.3** 2018.05.18
198 | 199 | * 修复模拟器首次运行一定几率crash的问题; 200 | * 修复热刷新后修改的页面MD5值校验失败的问题； 201 | 202 | **iOS 1.2.2** 2018.05.11
203 | 204 | * 修复热更新后，新增加的页面提示找不到的问题; 205 | * 优化webview加载时机，提升加载速度； 206 | * 修复日历单选模式重复点击一天样式显示的问题； -------------------------------------------------------------------------------- /zh-cn/base_config.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | > 整个项目中，只有两个配置文件，都放在了项目根目录的 `config` 文件夹下。 4 | 5 | ## eros.native.js -> 客户端 6 | 7 | 客户端需要读取的配置文件。 8 | 9 | > 注意: **`eros.native.js` 每次变动，都需要重新执行命令 `eros dev` 并重新运行你的 app 。** 10 | 11 | ```javascript 12 | { 13 | appName: "eros-demo", 14 | appBoard: "/config/index.js", 15 | androidIsListenHomeBack: "true", 16 | customBundleUpdate: 'true', 17 | version: { 18 | android: "1.0.0", 19 | iOS: "1.0.0" 20 | }, 21 | page: { 22 | homePage: "/pages/eros-demos/index.js", 23 | mediatorPage: "/mediator/index.js", 24 | navBarColor: "#3385ff"， 25 | navItemColor:"#ffffff" 26 | }, 27 | url: { 28 | image: "https://app.weex-eros.com/xxx/xxx", 29 | bundleUpdate: "http://localhosts:3001/app/check" 30 | }, 31 | zipFolder: { 32 | server: "home/app", 33 | iOS: "/ios/WeexEros/WeexEros", 34 | android: "/android/WeexFrameworkWrapper/app/src/main/assets" 35 | }, 36 | getui: { 37 | enabled: "false", 38 | appId: "", 39 | appKey: "", 40 | appSecret: "" 41 | }, 42 | tabBar: { 43 | color: '#777777', 44 | selectedColor: '#00b4cb', 45 | backgroundColor: '#fafafa', 46 | borderColor: '#dfe1eb', 47 | list: [{ 48 | pagePath: '/pages/demo/router/tabbarItem1.js', 49 | text: '首页', 50 | icon: 'bmlocal://assets/TabBar_Item1@2x.png', 51 | selectedIcon: 'bmlocal://assets/TabBar_Item1_Selected@2x.png', 52 | navShow: 'true', 53 | navTitle: "首页" 54 | }, 55 | { 56 | pagePath: '/pages/demo/router/tabbarItem2.js', 57 | text: '联系人', 58 | icon: 'bmlocal://assets/TabBar_Item2@2x.png', 59 | selectedIcon: 'bmlocal://assets/TabBar_Item2_Selected@2x.png', 60 | navShow: 'true', 61 | navTitle: '联系人' 62 | }, 63 | { 64 | pagePath: '/pages/demo/router/tabbarItem3.js', 65 | text: '个人中心', 66 | icon: 'bmlocal://assets/TabBar_Item3@2x.png', 67 | selectedIcon: 'bmlocal://assets/TabBar_Item3_Selected@2x.png', 68 | navShow: 'true', 69 | navTitle: '我' 70 | } 71 | ] 72 | } 73 | } 74 | ``` 75 | ### 配置说明 76 | 77 | #### **`appName`**: 脚手架自动生成 app 名称。 78 | 79 | #### **`version`**: app 对应版本号，脚手架会自动初始化填写。 80 | * iOS: iOS 对应版本号。`(增量发布相关)` 81 | * android: andorid 对应版本号。`(增量发布相关)` 82 | 83 | #### **`androidIsListenHomeBack`**: 安卓平台 是否监听第一个页面的物理返回键。 84 | 85 | #### **`customBundleUpdate`**: 是否自定义更新jsbundle逻辑
86 | * 如果不想使用eros默认的更新逻辑请将此参数设置为 `true`，然后使用[bmBundleUpdate](https://bmfe.github.io/eros-docs/#/zh-cn/eros_sdk_module?id=bmBundleUpdate) module 自定义更新逻辑。 87 | 88 | #### **`page`** 页面配置相关: 89 | * homePage: 主页的 js 相对地址。 90 | * mediatorPage: 中介者页面的相对地址，中介者页面是为了让我们在多个页面（js）中间可以通过事件来通信。 91 | * navBarColor: 原生导航条的默认颜色。 92 | * navItemColor: 原生导航栏字体颜色。 93 | 94 | #### **`url`**: 路经相关: 95 | * jsServer: 本地 js 的服务路径。(默认脚手架自动填写) 96 | * image: 图片上传绝对路径。 97 | * bundleUpdate: 检测jsBundle更新接口。`(增量发布相关)` 98 | > 增量发布相关的配置可以结合着增量发布文章结合着一起看。 99 | 100 | #### **`zipFolder`** 内置包存放地址。 101 | * server: 自动生成差分包的目录，可将脚手架部署在服务器上，做增量发布。 102 | * iOS: ios内置包地址，如果需要变更项目目录，请对应修改，如果不需要，就不要修改。 103 | * android: android内置包地址，如果需要变更项目目录，请对应修改，如果不需要，就不要修改。 104 | 105 | #### **`getui`** 个推 （目前项目推送服务是基于个推实现的） 106 | * enabled: 是否启用个推服务。 107 | * appId、appKey、appSecret 在个推平台申请。 108 | 109 | #### **`tabBar`** 原生tabBar配置信息 110 | 111 | 如果你的 App 首页设计为多tab的样式可以将 page 中的 homePage 设置为 'tabBar'，这样App首页会使用原生的tabBar，大大提升用户体验；同时可以通过 `bmTabbar` Module 设置红点或者数字角标，具体使用方法请参考 [bmTabbar](https://bmfe.github.io/eros-docs/#/zh-cn/eros_sdk_module?id=bmTabbar) 文档； 112 | 113 | * color：文字颜色； 114 | * selectedColor：文字选中后的颜色； 115 | * backgroundColor：tabBar背景颜色； 116 | * borderColor：tabBar上边栏颜色（tabBar最顶端1px的线条）； 117 | * list：tabBarItem 配置信息 （2 <= item数量 <= 5）； 118 | * pagePage：页面路径从 /page 开始填写； 119 | * text：标题； 120 | * icon：默认图片（注：只支持 png 图片，size 建议为50px左右，图片请命名为 xxx@2x.png）； 121 | * selectedIcon：选择后图片（规则与icon一致）； 122 | * navShow: 是否显示原生导航栏； 123 | * navTitle：导航栏标题； 124 | 125 | ## eros.dev.js -> 脚手架 126 | 127 | 脚手架会去读取此项配置来让开发者进行开发，调试，语法检测，mock，生成增量包和全量包等能力 128 | 129 | > 注意: **，`eros.dev.js` 每次变动，都需要重新启 eros dev 开发服务。**`(因为此项配置，是在脚手架启动的时才会去读取)`。 130 | 131 | ```javascript 132 | { 133 | exports: [ 134 | "js/service/bus.js", 135 | "js/pages/home/index.js", 136 | "js/pages/demo/index.js", 137 | "js/pages/home/tab1/index.js", 138 | "js/pages/home/tab2/index.js", 139 | "js/pages/home/tab2/components/router/index.js", 140 | "js/pages/home/tab3/index.js" 141 | ], 142 | alias: { 143 | "Components": "js/components", 144 | "Common": "js/common", 145 | "Config": "js/config", 146 | "Widget": "js/widget", 147 | "Pages": "js/pages", 148 | "Utils": "js/utils" 149 | }, 150 | eslint: false, 151 | server: { 152 | "path": "./", 153 | "port": 8889 154 | }, 155 | diff: { 156 | "pwd": "/Users/yangmingzhe/Work/opensource/eros-diff-folder", 157 | "proxy": "https://app.weex-eros.com/source" 158 | }, 159 | proxy: [{ 160 | "route": "/test", 161 | "target": "127.0.0.1:52077/test" 162 | }], 163 | mockServer: { 164 | "port": 52077, 165 | "mockDir": "./dist/mock" 166 | }, 167 | socketServer: { 168 | "switch": true, 169 | "port": 8890 170 | } 171 | } 172 | ``` 173 | 174 | ##### **`exports (重要)`** 175 | 暴露出你的页面对应的 js 地址，app中的每个页面本质上都对应一个 js，**所以你每次添加一个页面，都需要再次添加需要打包成 js bundle 的文件**。 176 | 177 | ##### **`alias`** 178 | 文件夹别名，方便快速访问。 179 | 180 | ```js 181 | import component from 'Components' //对应 js/components 182 | ``` 183 | ##### **`eslint`** 184 | **项目编译时是否需要进行 eslint 检查**。 185 | 186 | ##### **`server`** 187 | **脚手架运行 `eros dev` 服务的路径和端口，使用默认即可**。 188 | 189 | ##### **`proxy`** 190 | 代理相关，会把 `/test`路径对应的请求代理的到 `127.0.0.1:52077/test`，默认即可，无需修改。 191 | 192 | ##### **`mockServer`** 193 | 本地`mock`数据服务，因为`proxy`中已经把`/test`路径代理带`52077`端口，而我们在`52077`端口起了`mock`服务，所以能在本地`mock`数据。 194 | 195 | #### **`socketServer`** 196 | 热更新服务`开关`和`端口`，**若没有此项配置，热更新功能是无法使用的。** 197 | 198 | 199 | 200 | -------------------------------------------------------------------------------- /zh-cn/base_debug.md: -------------------------------------------------------------------------------- 1 | ## 实时预览 2 | eros 支持实时预览，即修改完代码可以立即查看效果 **<现已不在需要开启代理工具>** 3 | 4 | ### 1. 开启开发服务 5 | 6 | 在项目根目录中起开发服务： 7 | 8 | ``` 9 | $ eros dev 10 | ``` 11 | 12 | 脚手架会在项目根目录下生成 dist 文件，存放 JS Bundle。 13 | 14 | ### 2.关闭拦截器 15 | 16 |  17 | 18 | 运行App，点击屏幕上的`debug`按钮-> `Setting` -> `Interceptor` 关闭拦截器，然后点击`Refresh`或者双击屏幕上`debug`按钮刷新页面，就会重新从服务器加载最新的 js 文件。 19 | 20 | > 拦截器的主要作用就是控制加载 js 文件的方式 21 | > - 打开状态：会从当前工程内置的资源中加载js资源文件；
22 | > - 关闭状态：就会从开发服务上加载js资源文件； 23 | 24 | **注**：使用`真机`调试需要将手机与起服务的pc连接到**同一个局域网内！！！** 25 | 26 | ## 热刷新 27 | eros 现已支持热刷新，即修改完代码保存（command + s）的时候，页面会自动刷新
28 | - 点击屏幕上的`debug`按钮-> `Setting` -> 打开`HotRefresh`开关，提示 “hot refresh connected.”，说明热刷新以开启 29 | 30 | **注**：热刷新只有在`eros dev`起服务，并且关闭拦截器的情况下才会生效 31 |
32 |
33 |  34 | 35 | 36 | ## weex debug 真机断点调试 37 | 38 | 39 | 1. 重复上面真机调试的所有步骤。 40 | 2. 执行命令：`$ weex debug`，执行完毕后会自动唤起 Chrome 浏览器打开调试主页，并展示出了二维码。 41 | 3. 在App中，点击屏幕上的调试按钮在弹出框中点击`调试`，呼出扫一扫，对准二维码。 42 | 4. 选择 Debugger 即可断点调试(这时候页面是空白的，只能调试逻辑代码)，点击 Inspector 即可查看页面结构。 43 | 44 | 45 | -------------------------------------------------------------------------------- /zh-cn/base_dependencies.md: -------------------------------------------------------------------------------- 1 | eros 项目中依赖只有2种，一种是 `JavaScript 依赖`，一种则是 `App SDK 相关依赖`。 2 | 3 | ## JavaScript 依赖 4 | `JavaScript 依赖`可以参考 package.json： 5 | 6 | ```js 7 | "dependencies": { 8 | "eros-widget": "^1.0.0", 9 | "weex-ui": "^0.3.13beta2" 10 | }, 11 | "devDependencies": { 12 | "babel-core": "~6.25.0", 13 | "babel-plugin-component": "^1.0.0", 14 | "babel-plugin-transform-runtime": "~6.23.0", 15 | "babel-preset-env": "~1.5.2", 16 | "babel-preset-stage-0": "^6.24.1", 17 | "babel-register": "^6.22.0", 18 | "eslint": "^4.17.0", 19 | "eslint-plugin-html": "^4.0.2", 20 | "eslint-plugin-vue": "^4.2.2" 21 | } 22 | ``` 23 | 24 | 在 `dependencies` 中我们配置了 `eros-widget` 和 `weex-ui`，`weex-ui` 我们知道是非常优秀的组件库，那么 `eros-widget` 是什么？ 25 | 26 | > `eros-widget` 是对我们 eros-sdk 拓展出来的 module 的二次封装，使我们直接在 `Vue 实例`使用，也就是 this 上调用，eros-widget 不是必须的，但他可以帮我们间接的稳定 eros-sdk，所以建议还是使用 widget 拓展的方法。 27 | 28 | 具体可以参考 [eros-widget 文档部分](/zh-cn/eros_widget)。 29 | 30 | 由于 weex 和 eros 的开发差异性， weex-ui 中的 demo 是需要进行小部分修改即可运行的，基本都是路径的问题，开发时可以自己看脚手架输入日志来解决。 31 | 32 | #### 更新 `eros-widget`： 33 | 34 | ``` 35 | $ cnpm i eros-widget -S 36 | ``` 37 | 38 | ## App SDK 相关依赖 39 | * Eros工程基础库（必须依赖） 40 | * 拓展的 weex 不具有的 `module`。 41 | * 拓展的 weex 不具有的 `component`。 42 | * 拓展的`简易更新逻辑`。 43 | * 内置了 `WeexSDK`。 44 | * 其他插件库（选择依赖） 45 | * 微信分享； 46 | * 微信授权登录； 47 | * 微信支付； 48 | * 高德地图（封装了Weex-Amap); 49 | * 持续扩展中； 50 | 51 | #### **iOS 更新方法** 52 | 53 | > iOS 工程中将Eros基础库，及其他插件都封装成了pod库，采用版本管理，便于大家集成使用及版本更新；
54 | > （pod简介：全名[CocoaPods](https://cocoapods.org/)，是iOS端的第三方库管理工具，类似 `npm`包管理工具） 55 | 56 | 下面以 Eros 基础库 BMBaseLibrary 为例说明一下升级依赖库的步骤： 57 | 58 | * 打开iOS目录`工程目录/platforms/ios/WeexEros`，编辑Podfile文件，修改版本号（即 tag对应的版本号），库每次升级后都会有相关说明文档，如需升级将 tag 修改为对应的版本即可； 59 | ```ruby 60 | def common 61 | ...忽略其他库的引用 62 | #Eros iOS 基础库 63 | pod 'ErosPluginBaseLibrary', :git => 'https://github.com/bmfe/eros-plugin-ios-baseLibrary.git', :tag => '版本号' 64 | end 65 | target 'WeexEros' do 66 | common 67 | end 68 | ``` 69 | 70 | * 在终端中`cd`到此目录下执行 `pod update`，就会重新拉取最新版本的文件，等待命令执行完毕即可； 71 | 72 | 73 | #### **Android 更新方法** 74 | 75 | * 打开Android目录`工程目录/platforms/android/WeexFrameworkWrapper/`，进入对应的库目录切换 `tag`,或者 直接 使用 `git pull` 更新代码即可。 76 | 77 | -------------------------------------------------------------------------------- /zh-cn/base_dev.md: -------------------------------------------------------------------------------- 1 | ### 建议 2 | 如果您之前的教程都跑过了，我们建议您跟着入门教程过一遍： 3 | - [入门教程](https://bmfe.github.io/eros-docs/#/zh-cn/tutorial_newcomer) 4 | 5 | 您也可以直接看对应的文档，节约时间： 6 | - [项目结构](https://bmfe.github.io/eros-docs/#/zh-cn/tutorial_newcomer?id=%E9%A1%B9%E7%9B%AE%E7%BB%93%E6%9E%84) 7 | - [Hello Eros](https://bmfe.github.io/eros-docs/#/zh-cn/tutorial_newcomer?id=hello-eros) 8 | 9 | -------------------------------------------------------------------------------- /zh-cn/base_env.md: -------------------------------------------------------------------------------- 1 | 2 | > 我们推荐全部都安装，**但标注必须的环境必须安装，不然无法开发与调试**。 3 | 4 | ## 基础环境`(必须)` 5 | darwin: 6 | * Node.js (>=9.x), npm version 4+ 7 | 8 | windows: 9 | * Git bash (并确定已经设置为`.sh脚本的默认执行程序`) 10 | 11 | ``` 12 | $ npm i eros-cli -g 13 | ``` 14 | 如果你在中国地区，我们还是推荐您使用 [cnpm](https://npm.taobao.org/) 安装或者直接修改为`淘宝源`。 15 | ``` 16 | $ cnpm i eros-cli -g 17 | ``` 18 | 19 | > 因为脚手架依赖了`node-sass`，安装失败有很多解决办法，可自行查找。 20 | 21 | ## darwin 开发 iOS`(必须)` 22 | > CocoaPods 使用过程中遇到问题及时 Google。 23 | 24 | ### 版本要求 25 | - ruby: `2.5.0` 以上 26 | - rubygems: <= `2.7.6` [降级参考](https://github.com/rubygems/rubygems/blob/master/UPGRADING.rdoc) 27 | - cocoapods: `1.4.0` (最好) 28 | 29 | 其他版本会有环境问题 30 | ### 安装 31 | * Xcode (appStore 下载) 32 | * CocoaPods(建议使用pod 1.4.0版本) 33 | * 升级 rubygem 环境：`$ sudo gem update --system` 34 | * 移除现有 rubygem 镜像：`$ gem sources --remove https://rubygems.org/` 35 | * 添加gem.ruby-china镜像：`$ gem source -a https://gems.ruby-china.com/` 36 | * 安装 CocoaPods：`$ sudo gem install cocoapods -v 1.4.0` 37 | * 如果以上命令报错则执行：`$ sudo gem install -n /usr/local/bin cocoapods -v 1.4.0` 38 | * 最后执行：`$ pod setup 过程比较漫长，请耐心等待执行完成` 39 | 40 | ## darwin/windows/linux 开发 Android`(必须)` 41 | ### 版本要求 42 | `AndroidStudio` 版本目前最好 43 | - `3.0.x` best (高版本不太稳定，会有很多问题) 44 | 45 | ### 安装 46 | 47 | JDK 是 JAVA 开发包，AndroidStudio 是 Android开发IDE，这两项不再做过多介绍。 48 | 49 | * 下载并安装 [JDK](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html)。 50 | * 下载并安装 [Android Studio](https://developer.android.google.cn/studio/index.html)。 51 | 52 | 53 | > 如果您使用虚拟机进行跨平台开发，也需要配置好对应平台的所需环境。 54 | 55 | ## 模拟器安装`(必须)` 56 | * ios 开发中 xcode 已经自带了模拟器 57 | * android 开发者可以使用 android studio 再带模拟器，为了更好的效果，推荐下载 `Genymotion`模拟器 58 | 59 | >当然市面上的如 `夜神模拟器` 也是可以的，[调试教程](http://blog.csdn.net/qq_34653571/article/details/53007044?locationNum=14&fps=1)，但是在 weex 0.17/0.18 中会出现 weex 实例化失败的问题，所以还是推荐 `Genymotion`。 60 | 61 | ## weex-toolkit`(可选)` 62 | `断点调试` app 的能力。 63 | ``` 64 | $ cnpm i -g weex-toolkit 65 | ``` 66 | > [weex-toolkit](https://github.com/weexteam/weex-toolkit) 是 weex 官方提供的一个脚手架命令行工具，你可以使用它进行 weex 项目的创建，调试以及打包等功能，我们这里只使用它的调试功能( `weex debug` )； 67 | 68 | ## 代理软件`(可选)` 69 | 帮助我们进行 app 请求抓包，分析问题。 70 | * darwin/linux 推荐下载 [Charles](http://xclient.info/s/charles.html?_=b75d1488fca52bf0f85a4d11ac1200e3)。 71 | 72 | 下完完成之后需要进行相关的配置： 73 | 74 | * [fidder 手机抓包](http://blog.csdn.net/gld824125233/article/details/52588275)(如果未生效可尝试重启fidder) 75 | * [charles 手机抓包](http://blog.csdn.net/suifeng3051/article/details/52087343) 76 | 77 | 至此，所有的相关的工具和软件都已下载完毕，下面我们开始创建一个 `eros-demo` 工程。 78 | -------------------------------------------------------------------------------- /zh-cn/base_extend.md: -------------------------------------------------------------------------------- 1 | # 全局属性 2 | 3 | 官方提供的`weex.config.env`属性上，包含了当前 Weex 页面的环境信息。 4 | 5 | 我们在其基础上，又扩展了新的属性，开发者可通过`weex.config.eros`查看所有属性。 6 | 7 | 新的属性包括： 8 | 9 | - `bmFontScale`：当前字体大小，值为 NORM（标准）、BIG（大号）、EXTRALARGE（特大） 10 | 11 | - `bmFontSize`：当前字体放大倍数，值为1、1.15、1.3等 12 | 13 | - `deviceId`：手机的唯一标示 14 | 15 | - `jsServer`：js所在地址的域名 16 | 17 | - `logLevel`：日志等级 18 | 19 | - `request`：请求后端接口的域名 20 | 21 | - `scale`：屏幕放大倍数 22 | 23 | - `statusBarHeight`：通知栏高度，可在适配 iPhoneX 时使用。在页面顶部添加一个`div`，高度与`statusBarHeight`一致，即可撑起顶部刘海区，还可修改`div`颜色，使其与页面主体部分一致 24 | - `navBarHeight `：原生导航栏高度，在自定义导航栏的时候高度取这值就可以 25 | - `touchBarHeight `：iPhoneX底部的touchBarHeight，可以通过此参数来判断是否是iPhoneX，来适配页面，当参数不等于0则表示是 iPhoneX设备； 26 | - `jsVersion `：当前内置包js版本号 27 | 28 | **注意事项：** 29 | 30 | 若用到`