Launch-app-lib NPM

launch-app-lib

launch-app-lib 是一个在 H5 唤起 APP 的解决方案

在使用过程中，如有bug请提issue，我会及时跟进。有更好的解决方案欢迎讨论。

Install

Install with npm:

$ npm install --save launch-app-lib

Usage

const LaunchApp = require('launch-app-lib');

or;

import LaunchApp from 'launch-app-lib';

const config = {
  scheme: {
    url: 'scheme://host/path'
  },
  intent: {
    path: 'scan/',
    scheme: 'zxing',
    packageName: 'com.google.zxing.client.android',
    fallbackUrl: 'https://dl.yzcdn.cn/koudaitong.apk'
  },
  universal: {
    url: 'https://host/path'
  },
  yingyongbao: '',
  itunes: '',
  apk: ''
};

const launchApp = new LaunchApp(config);

const params = {
  url: 'https://xxx/xxx',
  id: 123
};
launchApp.launch(params);

launchApp.getScheme(params);
// scheme://host/path?url=https://xxx/xxx&id=123

launchApp.getIntent(params);
// intent://scan/#Intent;scheme=zxing;package=com.google.zxing.client.android;S.url=https://xxx/xxx;l.id=123;S.browser_fallback_url=https%A%F%Fitunes.apple.com%Fcn%Fapp%Fid880579403;end

launchApp.getUniversalLink(params);
// https://host/path?url=https://xxx/xxx&id=123

config

参数	说明	类型	是否必须
scheme	APP scheme 信息	object	是
intent	APP intent 信息	object	是
universal	APP universal 信息	object	是
yingyongbao	APP 应用宝地址	string	是
itunes	APP 的 App Store 地址	string	是
apk	APP 的 apk 下载地址	string	是
timeout	唤起 APP 超时时间	number or string	否
intentNotSupportedBrowserList	不支持intent唤起的ua关键字名单（针对国产手机自带浏览器）	array	否

scheme

参数	说明	类型	是否必须
url	scheme url "scheme://host/path"	string	是

intent

eg:

intent:
   //scan/
   #Intent;
      package=com.google.zxing.client.android;
      scheme=zxing;
   end;

参数	说明	类型	是否必须
path	intent path "scan/"	string	是
scheme	scheme "zxing"	string	是
packageName	APP 包名 "com.google.zxing.client.android"	string	是
fallbackUrl	唤起失败降级访问 url	string	是

universal

参数	说明	类型	是否必须
url	universal url	string	是

Method

launch

唤起 APP 方法

参数	说明	类型	是否必须
params	启动 APP 参数，用于拼接到对应的启动 url 中 "scheme://host/path?key=value"	object	是
failCallback	指定启动失败后的回调函数	fun	否