SecurityManager

SecurityManager类提供用于与权限进行交互的API。

构造函数

new SecurityManager()

new SecurityManager(): SecurityManager

返回值

SecurityManager

方法

getCurrentContextCredential()

static getCurrentContextCredential(): SecurityManagerTypes.ICredential

返回值

SecurityManagerTypes.ICredential

---

getMajorVersion()

static getMajorVersion(): number

获取主版本号主版本号

返回值

number

---

getMinorVersion()

static getMinorVersion(): number

获取次版本号次版本号

返回值

number

---

getPatchVersion()

static getPatchVersion(): number

获取补丁版本号补丁版本号

返回值

number

---

getPrivilegeState()

static getPrivilegeState(privilege: string, packageId?: string | undefined): Promise<SecurityManagerTypes.PrivilegeState>

参数

privilege

string

packageId?

string | undefined

返回值

Promise<SecurityManagerTypes.PrivilegeState>

---

getRuntimePrivilegeStates()

static getRuntimePrivilegeStates(credential: SecurityManagerTypes.ICredential): Promise<SecurityManagerTypes.IRuntimePrivilege[]>

参数

credential

SecurityManagerTypes.ICredential

返回值

Promise<SecurityManagerTypes.IRuntimePrivilege[]>

---

requestPrivilege()

static requestPrivilege(privilege: string): Promise<SecurityManagerTypes.PrivilegeState>

请求使用运行时权限的权限

参数

privilege

字符串

用于请求访问权限的运行时权限。

返回值

Promise<SecurityManagerTypes.PrivilegeState>

PromiseSecurityManagerTypes.PrivilegeState 成功后，将使用调用程序包的权限的新状态来解析Promise。出现错误时，Promise会被拒绝，并显示以下错误消息之一：

• “Failed to get privilege state”（无法获取权限状态）- 检索新权限状态时出错
• “Failed to launch privilege request handler”（无法启动权限请求处理程序）- 尝试启动系统组件以获得用户同意时出错

---

requestPrivileges()

static requestPrivileges(privileges: string[]): Promise<boolean[]>

参数

权限

string[]

返回值

Promise<boolean[]>

---

setPrivilegeState()

static setPrivilegeState(packageId: string, privilege: string, state: SecurityManagerTypes.PrivilegeState): Promise<string>

将指定程序包的运行时权限设置为特定状态。

参数

packageId

字符串

指定程序包的packageId值。

privilege

字符串

要修改的运行时权限。

state

SecurityManagerTypes.PrivilegeState

对运行时权限设置的状态。

返回值

Promise<string>

Promise 成功后，即会解析Promise。如果发生错误，Promise将被拒绝，并显示一条错误消息。 “Failed to set privilege state”（无法设置权限状态）。

---

setRuntimePrivilegeStates()

static setRuntimePrivilegeStates(credential: SecurityManagerTypes.ICredential, states: SecurityManagerTypes.IRuntimePrivilege[]): Promise<void>

参数

credential

SecurityManagerTypes.ICredential

states

SecurityManagerTypes.IRuntimePrivilege[]

返回值

Promise<void>

---

Last updated: 2026年7月22日