针对移动端的混合开发框架 - rexxar-web

2016-10-09      173      JavaScript
项目简介

rexxar-web

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

想要运行一个例子了解使用 Rexxar 开发页面的工作流程,直接查看简单的example。如果要在 iOS/Android Container 查看,请至rexxar-ios 或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服务器来存放资源,并且可以根据需求定制自己的测试环境和线上环境。