更新记录

1.0（2024-05-16）

初始化发布

平台兼容性

原生插件通用使用流程：

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原生插件配置”->”云端插件“列表中删除该插件重新选择

wireguard VPN接入

/ Title: XF-wireguardVPN Description: XF-wireguardVPN /

概述

XF-wireguardVPN模块，实现了iOS平台集成Network Extensions集成wireguard、Android集成wireguard实现VPN功能。

模块使用攻略

1. iOS扩展配套插件地址下载：Gitee仓库

接口

requestIgnoreBattery

申请加入电池白名单

requestIgnoreBattery(callback(ret))

callback(ret)

ret：

• 类型：JSON对象
• 内部字段：

{
    status: true,  //布尔型；true||false
    msg : ''
}

示例代码

var demo = uni.requireNativePlugin('XF-wireguardVPN');
demo.requestIgnoreBattery(function(ret){
    alert(JSON.stringify(ret));
});

可用性

Android系统

可提供的1.0.0及更高版本

setConfig

加载VPN配置信息

setConfig({params},callback(ret))

params

name：

• 类型：字符串
• 描述：（可选项）vpn名称。
• 默认值：Wireguard

conf：

• 类型：字符串
• 描述：（必填项）配置信息

[Interface] 
Address = 10.10.0.5/24 
PrivateKey = QDx0sGkhVWJxotjmG+jHA7s2y0S4GbYIw8/6xo/tIlg= 

[Peer] 
PublicKey = 2dbAtt+9LgqVrcSQX6il8Q0twTHdmfwDsUrFjCZQZgQ= 
PresharedKey = 7N4hK0LFoiDil3WVwFO2Ymt6cbPGubpi8ls4GJKiqaI= 
AllowedIPs = 10.10.0.0/24 
Endpoint = 17.19.15.81:5120 
PersistentKeepalive = 25

callback(ret)

ret：

• 类型：JSON对象
• 内部字段：

{
    status: true,  //布尔型；true||false
    msg : ''
}

示例代码

var demo = uni.requireNativePlugin('XF-wireguardVPN');
demo.setConfig({
    conf : ""
},function(ret){
    alert(JSON.stringify(ret));
});

可用性

iOS、Android系统

可提供的1.0.0及更高版本

startVPN

连接VPN

startVPN(callback(ret))

callback(ret)

ret：

• 类型：JSON对象
• 内部字段：

{
    status: true,  //布尔型；true||false
    msg: ""
}

示例代码

var demo = uni.requireNativePlugin('XF-wireguardVPN');
demo.startVPN(function(ret){
    alert(JSON.stringify(ret));
});

可用性

iOS、Android系统

可提供的1.0.0及更高版本

stopVPN

断开VPN

stopVPN(callback(ret))

callback(ret)

ret：

• 类型：JSON对象
• 内部字段：

{
    status: true,  //布尔型；true||false
    msg: ""
}

示例代码

var demo = uni.requireNativePlugin('XF-wireguardVPN');
demo.stopVPN(function(ret){
    alert(JSON.stringify(ret));
});

可用性

iOS、Android系统

可提供的1.0.0及更高版本

addStatusCallback

添加VPN连接状态监听

addStatusCallback(callback(ret))

callback(ret)

ret：

• 类型：JSON对象
• 内部字段：

{
    status: 'Invalid',//Invalid Disconnecting Connecting Connected Reasserting Disconnected
}

示例代码

var demo = uni.requireNativePlugin('XF-wireguardVPN');
demo.addStatusCallback(function(ret){
    alert(JSON.stringify(ret));
});

可用性

iOS、Android系统

可提供的1.0.0及更高版本

isConnected

VPN是否连接

isConnected()

ret：

• 类型：布尔对象

示例代码

var demo = uni.requireNativePlugin('XF-wireguardVPN');
var isConnected = demo.isConnected();

可用性

iOS、Android系统

可提供的1.0.0及更高版本

getStatistics

获取流量信息

getStatistics(callback(ret))

callback(ret)

ret：

• 类型：JSON对象
• 内部字段：

{
    status : true,
    rx_bytes : -1,
    tx_bytes : -1
}

示例代码

var demo = uni.requireNativePlugin('XF-wireguardVPN');
demo.getStatistics(function(ret) {});

可用性

iOS、Android系统

可提供的1.0.0及更高版本