app-methods

使用 NPM 或者 Yarn 安装`app-methods`:

Usage no npm install needed!

<script type="module">
  import appMethods from 'https://cdn.skypack.dev/app-methods';
</script>

README

统一各个 APP 的 native 接口调用方法,目前支持「轩辕」与「Ping」。

安装

使用 NPM 或者 Yarn 安装app-methods

yarn add app-methods
# 或
npm install app-methods --save

然后在项目里导入:

import * as app from 'app-methods'
// 或单独导入属性与方法
import { platform, showBar, hideBar, exit } from 'app-methods'

你还可以直接在 HTML 里加入下面的代码:

<!-- 使用未压缩版本 -->
<script src="https://unpkg.com/app-methods"></script>
<!-- 或压缩后的版本 -->
<script src="https://unpkg.com/app-methods/dist/app.min.js"></script>

这会添加一个名为 app 的全局变量。

API

app 对象有一个属性和三个方法:

app.platform

'ping''xy''other' 的其中一个。其中 ping 代表「Ping」,xy 代表「轩辕」,other 代表任何其它运行平台。

app.hideBar()

隐藏 APP 导航栏的方法。

app.showBar()

显示 APP 导航栏的方法

app.exit()

退出 APP WebView 的方法。

工作原理

app-methods 内部根据 userAgent 判断出网页当前运行在哪个 APP 里,然后调用对应 APP 的接口方法。如果网页运行在未知的应用里(即 app.platform === 'other')时,调用所有方法都会无效(事实上此时这些方法都是空函数)。你可以联系我添加更多 APP 接口,或者自行判断当 app.platformother 时调用其它方法。