获取进程相关的信息,提供进程管理的相关功能。
本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
import { process } from '@kit.ArkTS';
系统能力: SystemCapability.Utils.Lang
元服务API: 从API version 11 开始,该接口支持在元服务中使用。
名称 | 类型 | 可读 | 可写 | 说明 |
---|---|---|---|---|
uid | number | 是 | 否 | 进程的用户标识。 |
pid | number | 是 | 否 | 当前进程的pid。 |
tid8+ | number | 是 | 否 | 当前线程的tid。 |
type EventListener = (evt: Object) => void
用户存储的事件
元服务API: 从API version 11 开始,该接口支持在元服务中使用。
系统能力: SystemCapability.Utils.Lang
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
evt | Object | 是 | 用户事件。 |
isIsolatedProcess(): boolean
判断进程是否被隔离。
元服务API: 从API version 11 开始,该接口支持在元服务中使用。
系统能力: SystemCapability.Utils.Lang
返回值:
类型 | 说明 |
---|---|
boolean | 返回判断结果,如果进程被隔离则返回true,否则返回false。 |
示例:
let result = process.isIsolatedProcess();
is64Bit(): boolean
判断运行环境是否64位。
元服务API: 从API version 11 开始,该接口支持在元服务中使用。
系统能力: SystemCapability.Utils.Lang
返回值:
类型 | 说明 |
---|---|
boolean | 返回判断结果,如果运行环境是64位则返回true,否则返回false。 |
示例:
let result = process.is64Bit();
getStartRealtime(): number
获取从系统启动到进程启动所经过的实时时间(以毫秒为单位)。
元服务API: 从API version 11 开始,该接口支持在元服务中使用。
系统能力: SystemCapability.Utils.Lang
返回值:
类型 | 说明 |
---|---|
number | 返回经过的实时时间。单位:毫秒 |
示例:
let realtime = process.getStartRealtime();
getPastCpuTime(): number
获取进程启动到当前时间的CPU时间(以毫秒为单位)。
元服务API: 从API version 11 开始,该接口支持在元服务中使用。
系统能力: SystemCapability.Utils.Lang
返回值:
类型 | 说明 |
---|---|
number | 返回经过的CPU时间。单位:毫秒 |
示例:
let result = process.getPastCpuTime() ;
abort(): void
该方法会导致进程立即退出并生成一个核心文件,谨慎使用。
元服务API: 从API version 11 开始,该接口支持在元服务中使用。
系统能力: SystemCapability.Utils.Lang
示例:
process.abort();
uptime(): number
获取当前系统已运行的秒数。
元服务API: 从API version 11 开始,该接口支持在元服务中使用。
系统能力: SystemCapability.Utils.Lang
返回值:
类型 | 说明 |
---|---|
number | 当前系统已运行的秒数。 |
示例:
let time = process.uptime();
kill(signal: number, pid: number): boolean
发送signal到指定的进程,结束指定进程。
说明
从API version 7开始支持,从API version 9开始废弃,建议使用kill9+替代。
系统能力: SystemCapability.Utils.Lang
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
signal | number | 是 | 发送的信号。 |
pid | number | 是 | 进程的id。 |
返回值:
类型 | 说明 |
---|---|
boolean | 信号是否发送成功。如果信号发送成功则返回true,否则返回false。 |
示例:
let pres = process.pid
let result = process.kill(28, pres)
exit(code: number): void
终止程序。
请谨慎使用此接口,此接口调用后应用会退出,如果入参非0会产生数据丢失或者异常情况。
从API version 7开始支持,从API version 9开始废弃,建议使用exit9+替代。
系统能力: SystemCapability.Utils.Lang
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
code | number | 是 | 进程的退出码。 |
示例:
process.exit(0);
getUidForName(v: string): number
根据指定的用户名,从系统的用户数据库中获取该用户uid。
从API version 8开始支持,从API version 9开始废弃,建议使用getUidForName9+替代。
系统能力: SystemCapability.Utils.Lang
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
v | string | 是 | 用户名。 |
返回值:
类型 | 说明 |
---|---|
number | 返回用户uid。 |
示例:
let pres = process.getUidForName("tool")
getThreadPriority(v: number): number
根据指定的tid获取线程优先级。
说明
从API version 8开始支持,从API version 9开始废弃,建议使用getThreadPriority9+替代。
系统能力: SystemCapability.Utils.Lang
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
v | number | 是 | 指定的线程tid。 |
返回值:
类型 | 说明 |
---|---|
number | 返回线程的优先级。优先级顺序取决于当前操作系统。 |
示例:
let tid = process.tid;
let pres = process.getThreadPriority(tid);
isAppUid(v: number): boolean
判断uid是否属于应用程序。
从API version 8开始支持,从API version 9开始废弃,建议使用isAppUid9+替代。
系统能力: SystemCapability.Utils.Lang
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
v | number | 是 | 应用程序的uid。 |
返回值:
类型 | 说明 |
---|---|
boolean | 返回判断结果,如果是应用程序的uid则返回true,否则返回false。 |
示例:
let result = process.isAppUid(688);
getSystemConfig(name: number): number
获取系统配置信息。
说明
从API version 8开始支持,从API version 9开始废弃,建议使用getSystemConfig9+替代。
系统能力: SystemCapability.Utils.Lang
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
name | number | 是 | 指定系统配置参数名。 |
返回值:
类型 | 说明 |
---|---|
number | 返回系统配置信息。 |
示例:
let _SC_ARG_MAX = 0
let pres = process.getSystemConfig(_SC_ARG_MAX)
getEnvironmentVar(name: string): string
获取环境变量对应的值。
从API version 8开始支持,从API version 9开始废弃,建议使用getEnvironmentVar9+替代。
系统能力: SystemCapability.Utils.Lang
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
name | string | 是 | 环境变量名。 |
返回值:
类型 | 说明 |
---|---|
string | 返回环境变量名对应的value。 |
示例:
let pres = process.getEnvironmentVar("PATH")
提供用于新增进程的抛异常接口。
通过自身的构造来获取ProcessManager对象。
isAppUid(v: number): boolean
判断uid是否属于当前应用程序。
元服务API: 从API version 11 开始,该接口支持在元服务中使用。
系统能力: SystemCapability.Utils.Lang
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
v | number | 是 | 应用程序的uid。可通过process.uid获取 |
返回值:
类型 | 说明 |
---|---|
boolean | 返回判断结果,如果是应用程序的uid则返回true,否则返回false。 |
错误码:
以下错误码的详细介绍请参见。
错误码ID | 错误信息 |
---|---|
401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. |
示例:
let pro = new process.ProcessManager();
// uid通过process.uid获取
let pres = process.uid;
let result = pro.isAppUid(pres);
console.log("result: " + result); // result: true
getUidForName(v: string): number
根据指定的用户名,从系统的用户数据库中获取该用户uid。
元服务API: 从API version 11 开始,该接口支持在元服务中使用。
系统能力: SystemCapability.Utils.Lang
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
v | string | 是 | 用户名。 |
返回值:
类型 | 说明 |
---|---|
number | 返回用户uid,当获取的用户不存在时,返回-1。 |
错误码:
以下错误码的详细介绍请参见。
错误码ID | 错误信息 |
---|---|
401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. |
示例:
let pro = new process.ProcessManager();
let pres = pro .getUidForName("tool");
getThreadPriority(v: number): number
根据指定的tid获取线程优先级。
元服务API: 从API version 11 开始,该接口支持在元服务中使用。
系统能力: SystemCapability.Utils.Lang
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
v | number | 是 | 指定的线程tid。 |
返回值:
类型 | 说明 |
---|---|
number | 返回线程的优先级。优先级顺序取决于当前操作系统。 |
错误码:
以下错误码的详细介绍请参见。
错误码ID | 错误信息 |
---|---|
401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. |
示例:
let pro = new process.ProcessManager();
let tid = process.tid;
let pres = pro.getThreadPriority(tid);
getSystemConfig(name: number): number
获取系统配置信息。
元服务API: 从API version 11 开始,该接口支持在元服务中使用。
系统能力: SystemCapability.Utils.Lang
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
name | number | 是 | 指定系统配置参数名。 |
返回值:
类型 | 说明 |
---|---|
number | 返回系统配置信息,当获取的系统配置不存在时,返回-1。 |
错误码:
以下错误码的详细介绍请参见。
错误码ID | 错误信息 |
---|---|
401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. |
示例:
let pro = new process.ProcessManager();
let _SC_ARG_MAX = 0;
let pres = pro.getSystemConfig(_SC_ARG_MAX);
getEnvironmentVar(name: string): string
获取环境变量对应的值。
元服务API: 从API version 11 开始,该接口支持在元服务中使用。
系统能力: SystemCapability.Utils.Lang
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
name | string | 是 | 环境变量名。 |
返回值:
类型 | 说明 |
---|---|
string | 返回环境变量名对应的值。 |
错误码:
以下错误码的详细介绍请参见。
错误码ID | 错误信息 |
---|---|
401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. |
示例:
let pro = new process.ProcessManager();
let pres = pro.getEnvironmentVar("PATH");
exit(code: number): void
终止程序。
请谨慎使用此接口,此接口调用后应用会退出,如果入参非0会产生数据丢失或者异常情况。
元服务API: 从API version 11 开始,该接口支持在元服务中使用。
系统能力: SystemCapability.Utils.Lang
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
code | number | 是 | 进程的退出码。 |
错误码:
以下错误码的详细介绍请参见。
错误码ID | 错误信息 |
---|---|
401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. |
示例:
let pro = new process.ProcessManager();
pro.exit(0);
kill(signal: number, pid: number): boolean
发送signal到指定的进程,结束指定进程。
元服务API: 从API version 11 开始,该接口支持在元服务中使用。
系统能力: SystemCapability.Utils.Lang
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
signal | number | 是 | 发送特定的信号给目标进程。 |
pid | number | 是 | 进程的id。 |
返回值:
类型 | 说明 |
---|---|
boolean | 信号是否发送成功。如果信号发送成功则返回true,否则返回false。 |
错误码:
以下错误码的详细介绍请参见。
错误码ID | 错误信息 |
---|---|
401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. |
示例:
let pro = new process.ProcessManager();
let pres = process.pid;
let result = pro.kill(28, pres);
有很多小伙伴不知道学习哪些鸿蒙开发技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?而且学习时频繁踩坑,最终浪费大量时间。所以有一份实用的鸿蒙(HarmonyOS NEXT)资料用来跟着学习是非常有必要的。
点击领取→(安全链接,放心点击)希望这一份鸿蒙学习资料能够给大家带来帮助,有需要的小伙伴自行领取~限时开源!!
鸿蒙(HarmonyOS NEXT)最新学习路线
有了路线图,怎么能没有学习资料呢,小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙(OpenHarmony )学习手册(共计1236页)与鸿蒙(OpenHarmony )开发入门教学视频,内容包含:ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。
获取以上完整版高清,请点击→
这份鸿蒙(HarmonyOS NEXT)资料包含了鸿蒙开发必掌握的核心知识要点,内容包含了(ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、(南向驱动、嵌入式等)鸿蒙项目实战等等)鸿蒙(HarmonyOS NEXT)技术知识点。
HarmonyOS Next 最新全套视频教程
《鸿蒙 (OpenHarmony)开发基础到实战手册》
OpenHarmony北向、南向开发环境搭建
《鸿蒙开发基础》
《鸿蒙开发进阶》
《鸿蒙进阶实战》
大厂面试必问面试题
鸿蒙南向开发技术
鸿蒙APP开发必备
总的来说,华为鸿蒙不再兼容安卓,对中年程序员来说是一个挑战,也是一个机会。只有积极应对变化,不断学习和提升自己,才能在这个变革的时代中立于不败之地。