circle-nodesAPP VPN SDK_让APP自带VPN/防域名屏蔽/防DNS污染

APP打包封装 https://cloud.nextcli.com/app/myapp

circle-check

一、APP打包,SDK集成

字段
说明

APP包名/APP ID

包名? 是APP的唯一ID,通常以 com.开头,如: com.x.app 不建议使用主流APP的名字,包名冲突,会覆盖已安装的同包名ID的APP;

APP适用系统

普通用户可选择打包Android APK、Windows EXE; 安卓AAR、Windows DLL 则是面向专业开发者的SDK。

APP主页链接

打开APP时,主页显示内容所在的链接网址;

APP图标

APP安装在桌面上显示的图标; Android推荐使用 512×512px 的图标以获得最佳效果; Windows同样512×512px 的图标,也可以直接使用网站的favicon.ico链接。

1.2. 打包与下载

  • 点击“打包”后,预计 1~5 分钟完成。需手动刷新查看进度。

  • 打包产物下载链接有效期为 1小时,过期后需重新打包。

  • 如果打包失败,请检查错误提示;如无法解决可联系客服。

1.3. 其他说明

  • 新用户在创建第一个应用后,可获得 1年 的每月 1G 流量套餐。

2.1 流量加速

  • 开启流量加速后,白名单中的域名将启用防屏蔽功能。

  • 如果当月流量用完,需要再次购买套餐或流量包才能继续使用流量加速。

2.2 什么是加速白名单?

  • 流量加速开启后,白名单中的域名会通过加速通道,消耗套餐流量;其他域名则使用普通网络。

  • 创建应用后,系统会自动将应用主页链接的域名加入到加速白名单。

    例如,若应用主页链接为 abc.x.com,则默认将 abc.x.com 添加到白名单。

  • 您还可以手动添加更多域名到白名单,例如添加 123.x.com 、www.google.com,则该域名流量将走加速通道。

2.3 白名单规则

  1. 仅可添加域名(不能包含 http 或 https)。

  2. 若添加一级域名(如 x.com),其所有二级或子域名(如 m.x.com, www.x.com)皆自动纳入白名单。

  3. 若只添加二级域名(如 m.x.com),则不包含 x.com。

  • 新用户创建第一个应用后,系统会免费提供 1年 的每月 1G 流量套餐。

  • 您可多次购买同一套餐,后购买的套餐将覆盖之前的套餐,同时重置 App 的流量用量和到期时间。

  • ⚠️注意,必须先拥有一个套餐,才能购买流量包。流量包的有效期与当月套餐同步。

  • 如需更多套餐选项,请联系客服。

四、开发者文档

4.1 生成AAR

  1. 在创建应用时选择 AAR 作为目标产物,主页链接可先填后端 API 地址(后续可于白名单中修改)。

  2. 打包产物解压后将获得 checksum 文件与 xxx.aar 文件。

  3. sdk调用前需要把checksum复制到app的内部存储文件夹下,因为sdk需要校验这个文件,然后初始化sdk,参考以下demo

  1. 应用层示例,这里以网络请求为例,更多使用示例请查看demo;

五、错误码

code
备注

1

成功

101

包名错误、不匹配

103

checksum文件不存在(默认的域名白名单文件)

104

checksum文件解密失败

105

下载配置文件失败

106、206

解密配置文件失败

107、207

json解析配置文件失败

108

未找到可用tag

109

已开启

111

已经close

110

start失败

112

端口开启错误

208

yaml解析失败

209

Options对象序列化为JSON 失败

210

加密JSON失败

211

创建box实例失败

比如:105 下载配置文件失败,可能是因为请求IP在国外,我们的配置文件在国内,国内不会异常!

更多问题请联系客服 @NextCLiCloudBOT >>arrow-up-right


参考链接

Android 开发者文档(英文)arrow-up-right

Windows 应用打包(Microsoft 官方文档)arrow-up-right

最后更新于