更新记录

V1.1.0（2024-04-30）

新增插件弹窗配置参数(toastFlag)，默认关闭(false)

V1.0.0（2024-04-24）

用于连接Android端天融信VPN

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

UniApp-天融信VPN插件使用说明

引入插件

引入插件按照官方文档设置即可，就不再赘述了。

插件使用

插件支持5个方法

0. 引入插件
1. 初始化实例
2. 获取VPN信息(状态)
3. 登录
4. 启动VPN服务
5. 登出

• 引入插件

  const topVpnModule = uni.requireNativePlugin('UniPluginTopVpn')

• 初始化实例 这是下面所有步骤的前提

  const initVpn = () => {
  const vpn_ip = 'xxx.xxx.xxx.xxx'
  const vpn_port = 'xxx'
  // V1.1: 参数可以携带 toastFlag(boolean),来控制是否启用插件弹窗
  topVpnModule.initTopVpn({ vpn_ip, vpn_port }, (res: any) => {
    result.value = res
    console.log('res', res)
  })
  }

• 获取VPN信息(状态)

  const getTopVpn = () => {
  // V1.1: 参数可以携带 toastFlag(boolean),来控制是否启用插件弹窗
  topVpnModule.getTopVpn({}, (res: any) => {
    result.value = res
    console.log('res', res)
  })
  }

• 登录

  const loginTopVpn = () => {
  const username = '测试用户'
  const password = 'testtest!'
  // V1.1: 参数可以携带 toastFlag(boolean),来控制是否启用插件弹窗
  topVpnModule.loginTopVpn({ username, password }, (res: any) => {
    result.value = res
    console.log('res', res)
  })
  }

• 启动VPN服务 参照官方文档，这个方法是为了防止客户端单方面掉线

  const startService = () => {
  // V1.1: 参数可以携带 toastFlag(boolean),来控制是否启用插件弹窗
  topVpnModule.startService({}, (res: any) => {
    result.value = res
    console.log('res', res)
  })
  }

• 登出

  const logoutTopVpn = () => {
  // V1.1: 参数可以携带 toastFlag(boolean),来控制是否启用插件弹窗
  topVpnModule.logoutTopVpn({}, (res: any) => {
    result.value = res
    console.log('res', res)
  })
  }

  注意

• 应该先初始化实例，再进行其他操作

• 因为官方的接口无法判断是否登录成功，所以需要在调用登录后，主动掉一次获取获取VPN信息(状态)(建议延迟1s以上)，以此来判断是否登录成功！！！