Panel SDK

Appearance

🔐 Secure（安全权限）模块 · 开发者指南 ​

🧠 模块介绍 ​

Secure（安全权限）模块，用于安全密码管理、应用注册与注销、权限状态查询等，保障系统安全与权限合规。

🛠️ PanelSDK 初始化 ​

java
// 推荐在 Application 或 Activity 中初始化，确保全局唯一
PanelSDK panelSDK = new PanelSDK(this);

🧩 核心方法 · 专业解读 ​

🟢 getSecurePasswdStatus — 获取安全密码状态 ​

java
int getSecurePasswdStatus()
返回值说明
返回值说明
1密码已存在
0密码为空
2未知密码错误
典型场景代码
java
// 获取安全密码状态
int status = panelSDK.getSecurePasswdStatus();
if (status == 1) {
    // ✅ 密码已存在
    Log.d("Secure", "安全密码已存在");
} else if (status == 0) {
    // ⚠️ 密码为空
    Log.w("Secure", "安全密码为空");
} else if (status == 2) {
    // ❌ 未知密码错误
    Log.e("Secure", "未知密码错误");
} else {
    // ❌ 其他错误
    Log.e("Secure", "获取失败，错误码: " + status);
}

📝 setSecurePasswd — 设置权限密码 ​

java
int setSecurePasswd(String oldPasswd, String newPasswd)
参数说明
参数类型说明
oldPasswdString旧密码
newPasswdString新密码
返回值说明
返回值说明
0成功
其他失败，见错误码
典型场景代码
java
// 设置或修改安全密码
int result = panelSDK.setSecurePasswd("old123", "new456");
if (result == 0) {
    // ✅ 设置成功
    Log.d("Secure", "安全密码设置成功");
} else {
    // ❌ 设置失败
    Log.e("Secure", "设置失败，错误码: " + result);
}

♻️ resetSecurePasswd — 重置权限密码 ​

java
int resetSecurePasswd(String oldPasswd)
参数说明
参数类型说明
oldPasswdString旧密码
返回值说明
返回值说明
0成功
其他失败，见错误码
典型场景代码
java
// 重置安全密码
int result = panelSDK.resetSecurePasswd("old123");
if (result == 0) {
    // ✅ 重置成功
    Log.d("Secure", "安全密码已重置");
} else {
    // ❌ 重置失败
    Log.e("Secure", "重置失败，错误码: " + result);
}

🏷️ registSafeProgram — 注册安全应用 ​

java
int registSafeProgram(String securePasswd)
参数说明
参数类型说明
securePasswdString权限密码（默认密码为Abc12345）
返回值说明
返回值说明
0注册成功
其他失败，见错误码
典型场景代码
java
// 注册当前应用为安全应用
int result = panelSDK.registSafeProgram("new456");
if (result == 0) {
    // ✅ 注册成功
    Log.d("Secure", "安全应用注册成功");
} else {
    // ❌ 注册失败
    Log.e("Secure", "注册失败，错误码: " + result);
}

❌ unregistSafeProgram — 注销安全应用 ​

java
int unregistSafeProgram()
返回值说明
返回值说明
0注销成功
其他失败，见错误码
典型场景代码
java
// 注销当前应用的安全应用状态
int result = panelSDK.unregistSafeProgram();
if (result == 0) {
    // ✅ 注销成功
    Log.d("Secure", "安全应用已注销");
} else {
    // ❌ 注销失败
    Log.e("Secure", "注销失败，错误码: " + result);
}

🔍 checkSafeProgramOfSelf — 检查当前应用是否为安全应用 ​

java
Boolean checkSafeProgramOfSelf()
返回值说明
返回值说明
true/falsetrue 在列表，false 不在
典型场景代码
java
// 检查当前应用是否为安全应用
Boolean isSafe = panelSDK.checkSafeProgramOfSelf();
if (isSafe != null && isSafe) {
    // ✅ 当前应用是安全应用
    Log.d("Secure", "当前应用是安全应用");
} else {
    // ⚠️ 当前应用不是安全应用或查询失败
    Log.w("Secure", "当前应用不是安全应用");
}

⚡ 专业进阶 · 技术要点 ​

所有方法均为同步调用，返回值可直接判断结果，适合批量自动化脚本。 推荐在具备系统权限的环境下调用，部分功能需 Root 或系统签名。 依赖底层 StSecureManager，请确保相关依赖已集成并兼容目标设备。 支持企业级批量权限策略下发、应用注册。

🏆 专业总结 ​

只需一个 PanelSDK 实例，安全密码与权限注册一站式搞定。无论是权限加固、批量运维还是合规管理，Secure 模块让你的设备更安全、更合规！