Skip to content

spmjs/spm-server

Repository files navigation

spm-server

NPM version Build Status Coverage Status NPM downloads

spm-server 是 spm3 项目的本地开发和调试工具。包含 server 和 middleware 两层功能,默认封装了很多常用的调试工具,见下图:

Install

$ npm install spm-server -g

本地调试

本地调试没啥好说的,就是进入到一个 spm3 的项目或组件目录中,执行 spm-server

然后可以通过参数开启上图中的功能。

livereload

通过 spm-server --livereload 开启。

这时 spm-server 会做两件事:

  1. 开启 livereload 服务器
  2. 访问 html 页面时会插入 livereload 脚本,用于和服务器通讯实时刷新页面

weinre

通过 spm-server --weinre 开启。

和 livereload 一样,spm-server 会做两件事:

  1. 开启 weinre 服务器
  2. 访问 html 页面时会插入 weinre 脚本,用于和服务器通讯

然后就可以在 weinre 页面上看到当前绑定的设备了:(端口是 8989)

关于 weinre 的使用这里就不展开了,可以访问 weinre 的官网文档 来了解。

spm

spm 的功能是通过 serve-spm 这个中间件来实现的,serve-spm 用在 spm doc、spmjs.io 等所有需要对 spm 进行调试的地方。

如果你的项目的根目录不是 /,而是 /assets/ 或者 http://x.com/assets/,则需要配置 base 参数。比如:spm-server --base /assets/,然后就可以通过 http://localhost:8000/assets/index.js 来访问到你项目中的文件了。

更多 serve-spm 的详细规则,见:serve-spm

线上调试

线上调试主要是通过 anyproxy 实现。

## spm-server 不直接依赖 anyproxy ,所以第一次使用前需要手动安装
$ npm install anyproxy -g

## 启动 spm-server 和 (any)proxy
$ spm-server --proxy

然后应该能看到下图的提示:(包含 GUI 和 HTTP 代理的端口)

注意:第一次使用时应该会提示你安装根证书。

然后就是通过各种方式把请求配置到 HTTP 代理上去,比如 Chrome:

Chrome

推荐使用扩展程序 Proxy SwitchySharp,可以很方便地定制大力规则和情景模式。安装完成后,添加一个情景模式比如 spm:

然后到切换到“切换规则”面板,启用规则切换,加入一条对 alipayobjects.com 的代理规则的配置:

根据项目的不同,这里可能需要加上你对应的开发环境的代理规则

OK,接下来选择开启 SwitchSharp 的“自动切换模式”,代理的配置就完成了:

然后访问 https://a.alipayobjects.com/ ,如果在页面上看到项目目录下的文件列表了,就说明本地环境启动成功了:

同时在 anyproxy 的监控页面也会看到一条请求记录:

移动端

  1. 常规方法

  1. 代理 app,比如 Andriod 的 ProxyDroid

同时调试多个包

如果一个项目中使用了多个包,可能会需要同时进行调试。别担心,spm-server 已经为你考虑到了:

$ spm-server ./modA ./modB

定制

参考:https://github.com/spmjs/spm-server/blob/master/cli.js