AOne Android SDK接入文档 15、SDK 产品功能所需收集的个人信息说明 个人信息类型 可选/必选 处理目的/功能场景 处理方式 获取IP 必选 用于网络变化的时候重新解析DNS获取ip 仅读取,不保存到本地,也不上传服务器 常见问题 引入aar包后,出现Duplicate class 的错误,如下图所示 原因:因为sdk有依赖一些jar包,如果app工程也依赖相同的jar包会导致冲突,这里需要exclude app 工程的相同的类来解决这类问题,目前sdk层依赖的jar包如下表所示: 库名字 版本 okhttp 4.9.3 okio 2.8.0 gson 2.9.0 datastorepreferencescore 1.0.0 datastorecore 1.0.0 convertergson 2.9.0 logginginterceptor 4.9.3 retrofit 2.9.0 commonsvalidator:commonsvalidator 1.7 org.conscrypt:conscryptandroid 2.5.2 androidx.security:securitycrypto 1.1.0alpha06 androidx.lifecycle:lifecycleruntimektx 2.5.1 com.elvishew:xlog 1.11.1 解决方式:使用 exclude 排除重复的类 如果你知道具体哪些类是重复的(通常可以在错误消息中看到),可以使用 exclude 来排除特定的类。例如,如果 commonlib 引入了重复的类 com.okhttp3,你可以排除该类: dependencies { implementation('com.example:commonlib:1.0.0') { exclude group: 'com.squareup.okhttp3', module: 'okhttp' } } 获取设备id 如果需要获取当前sdk指定的设备指纹(唯一id),则可以调用 DeviceIdUtil.Companion.getUniqueId() 获取当前系统的版本,则可以调用 DeviceIdUtil.Companion.getDeviceOs() 日志路径 如果遇到问题需要协助,开发人员可能会寻求日志定位问题,这里日志的路径的获取有三个方式 方式一、使用如下方法获取日志 VPNApplication.get().getFileLogPath() 方式二、在log中获取,启动后会在tag为Sdk中获取到 在用如上的方法获取到日志路径后,到路径下取出今天的日志发给开发者即可 方式三、日志分享 调用AOneSdkClient.Companion.ShareLog(this) 方法,日志会打包成一个zip文件,并弹出分享面板,可以通过微信等方式分享 / 方法名: ShareLog 描述:这个方法用于Sdk日志的分享,方便快速定位问题 使用线程: 主线程 回调线程: 主线程 使用方法: AOneSdkClient.Companion.ShareLog(this); / public void ShareLog(View view) { AOneSdkClient.Companion.ShareLog(this); } 错误码 错误码 错误提示 建议处置方式 0x10301 隧道资源接口请求失败 联系管理员 0x10302 隧道资源不存在 联系管理员 0x10311 aoneid隧道资源接口请求失败 联系管理员 0x10312 aoneid隧道资源不存在 联系管理员 0x10321 获取解析组接口错误 联系管理员 0x10322 获取解析组域名为空 联系管理员 0x10323 获取解析组ip为空 联系管理员 0x103310x10334 隧道配置接口请求失败 联系管理员 0x10335 隧道配置不存在 联系管理员 0x10336 控制中心无法分配足够客户端ip 联系管理员 0x10337 多镜像中心隧道接口内部错误 联系管理员 0x10341 token接口刷新错误 联系管理员 0x10351 添加设备的接口报错 联系管理员 0x10352 设备未激活 联系管理员,增加设备的激活数量 0x10353 未支持的AuthStatus字段 联系管理员 0x11001 配置转换异常 联系管理员 0x11002 数据转换异常 联系管理员 0x12001 开始认证无Token,一般是Token过期了 1、排查是否登录成功 2、是否正确传递token到sdk,或者token超过了有效期 3、如果还是不行,联系管理员 0x12002 开始认证无用户名 1、排查是否正确传递token到sdk 2、正确传递还是报错则联系管理员 0x12003 开始认证无随机数 1、排查是否正确传递token到sdk 2、正确传递还是报错则联系管理员 0x12004 无权限 app申请VPN权限,用户是否同意了 0x12005 无网络 查看网络是否正常 0X12006 无refreshToken 1、排查是否正确传递token到sdk 2、正确传递还是报错则联系管理员 0X12007 aoneId 用户池id是空的 1、排查是否正确传递token到sdk 2、正确传递还是报错则联系管理员 0X12008 租户id是空的 1、排查是否正确传递token到sdk 2、正确传递还是报错则联系管理员 0X12009 token 错误 1、排查是否正确传递token到sdk 2、正确传递还是报错则联系管理员 0X12010 启动VPN一些配置是错误的 联系管理员 0X12011 初始化token已过期 排除token 是否已经过期了 0X13001 状态错误 联系管理员 0X13002 下线失败 联系管理员 0X13003 初始化错误 联系管理员 0X13004 已经在线 VPN已经是在线状态,又调用了SdkStartVPN导致 建议检查下VPN的状态 0X13005 json 序列化错误 联系管理员 0X13006 json 解析失败 联系管理员 0X13007 未知错误 联系管理员 0X13008 服务端响应错误,一般是502等错误状态码 联系管理员 0X13009 服务端无响应 联系管理员 0X13010 请先传入用户是否同意隐私协议再使用sdk 需要弹出隐私协议确认对话框,并调用的方法AOneSdkClient.Companion.updatePrivacyAgree(true)告知sdk 0X13011 需等待用户同意隐私协议后再使用sdk 用户同意隐私协议后需要调用AOneSdkClient.Companion.updatePrivacyAgree(true);