🏠 Home（桌面管理）模块 · 开发者指南

---

🧠 模块介绍

Home（桌面管理）模块，用于控制和管理设备桌面应用、桌面锁定等功能，适合企业级定制、批量运维和安全场景。

---

🛠️ PanelSDK 初始化

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

---

🧩 核心方法 · 专业解读

🚦 setHomePackage — 设置默认桌面

int setHomePackage(String packageName)

参数说明

参数	类型	说明
packageName	String	目标桌面应用包名

返回值说明

返回值	说明
0	设置成功
-1	未知错误（SYSTECH_COMMON_ERROR_UNKNOWN）
-2	设备不支持该功能
-3	SDK版本不支持该功能
-4	写入系统设置失败
-5	服务未启动
其他	参考 StErrorCode.md

典型场景代码

int result = panelSDK.setHomePackage("com.xxx.launcher");
if (result == 0) {
    // 🎉 设置成功，默认桌面已切换
} else if (result == -1) {
    // ❗ 未知错误，建议检查日志
} else if (result == -2) {
    // 🚫 设备不支持该功能
} else if (result == -3) {
    // ⚠️ SDK版本不支持该功能
} else if (result == -4) {
    // ⚠️ 写入系统设置失败，需系统权限
} else if (result == -5) {
    // 🔒 服务未启动，请检查系统服务状态
} else {
    // ❗ 其他错误，参考 StErrorCode.md
}

---

🔍 getHomePackage — 获取当前默认桌面

String getHomePackage()

参数说明

参数	类型	说明
无		无参数

返回值说明

返回值	说明
String	成功返回包名
null	获取失败

典型场景代码

String launcher = panelSDK.getHomePackage();
if (launcher != null) {
    // 🎉 获取成功，当前桌面：${launcher}
} else {
    // ❗ 获取失败，建议检查设备兼容性
}

---

🚀 startRawLauncher — 立即启动默认Lanuncher3桌面应用

int startRawLauncher()

参数说明

参数	类型	说明
无		无参数

返回值说明

返回值	说明
0	启动成功
-1	未知错误（SYSTECH_COMMON_ERROR_UNKNOWN）
-2	设备不支持该功能
-3	SDK版本不支持该功能
-5	服务未启动
其他	参考 StErrorCode.md

典型场景代码

int result = panelSDK.startRawLauncher();
if (result == 0) {
    // 🎉 启动成功
} else if (result == -1) {
    // ❗ 未知错误，建议检查日志
} else if (result == -2) {
    // 🚫 设备不支持该功能
} else if (result == -3) {
    // ⚠️ SDK版本不支持该功能
} else if (result == -5) {
    // 🔒 服务未启动，请检查系统服务状态
} else {
    // ❗ 其他错误，参考 StErrorCode.md
}

---

⚡ 专业进阶 · 技术要点

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

---

🏆 专业总结

只需一个 PanelSDK 实例，桌面管理随心掌控。无论是品牌定制、批量运维还是安全锁定，Home 模块让你的设备体验更专业、更高效！

---