rexxar-web

Rexxar 是一个针对移动端的混合开发框架。现在支持 Android 和 iOS 平台。rexxar-web 是 Rexxar 的 Web 端实现，提供配合 Rexxar Container 运行的基础工具。

想要运行一个例子了解使用 Rexxar 开发页面的工作流程，直接查看简单的 example。如果要在 iOS/Android Container 查看，请至 rexxar-ios 或 rexxar-android。

Rexxar 简介

关于 Rexxar 的整体介绍，可以查看文档：Rexxar 简介。

关于 Rexxar iOS，可以访问：https://github.com/douban/rexxar-ios。

关于 Rexxar Android，可以访问：https://github.com/douban/rexxar-android。

安装

$ npm install rexxar-web --save

使用

getRexxarWidget

import { getRexxarWidget } from 'rexxar-web';

const RexxarWidget = getRexxarWidget({
  scheme: 'douban',
  host: 'rexxar-container'
});

class Title extends RexxarWidget {
  constructor(title) {
    super('title');
    this.title = title;
  }
  show() {
    super.call({ title: this.title });
  }
}
let title = new Title('My Title');
title.show();

getRexxarWidget(config)

配置 Widget 协议的 scheme 和 host，获取 RexxarWidget 基类，推荐使用继承的方式编写自己的组件。

`config.scheme`

Type: String

`config.host`

Type: String

rexxarFetch

import { rexxarFetch } from 'rexxar-web';

rexxarFetch('/request')
  .then(response => response.json())
  .then(data =>
    console.log('request succeeded with JSON response', data)
  )
  .catch(error =>
    console.log('request failed', error)
  )

rexxarFetch(input[, init])

rexxarFetch 是对 fetch 的包装，提供与 window.fetch 一样的接口和用法。值得注意的是，在 Android Container 中使用 POST 会有所限制，只允许 content-type 为 application/x-www-form-urlencoded 的请求。

开发与部署

关于如何开发一个 Rexxar 页面，并进行调试，部署集成，请查看 example 目录。

Quick Start

安装

$ git clone https://github.com/douban/rexxar-web
$ cd rexxar-web/example
$ npm i

调试

$ gulp serve

gulp serve 启动调试服务器之后，你可以在浏览器中通过 http://localhost:8080/rexxar/demo.html?uri=douban://douban.com/rexxar_demo/ 这样的url来查看页面。

如果你需要 iOS/Android Container 访问调试服务器上的页面，则应该在 serve 的时候明确指定机器的ip。

$ gulp serve --ip 192.168.0.250

然后将 Container 中的 routes 地址改为 http://192.168.0.250:8080/routes.json 这样的地址。

部署

本地调试完成后，通过以下命令可以在 dist 目录下生成一系列打包后的资源：

$ gulp deploy

在这个例子中我们用 raw.githubusercontent.com 作为我们的静态资源存放地址，iOS/Android Container 通过访问 dist/routes.json 获取路由文件。当然你可以使用自己的CDN服务器来存放资源，并且可以根据需求定制自己的测试环境和线上环境。

License

Rexxar is released under the MIT license. See LICENSE for details.

Tikitoo / rexxar-web