# ohosProcess

**Repository Path**: hihopeorg/ohosProcess

## Basic Information

- **Project Name**: ohosProcess
- **Description**: 判断应用处于前后台的库
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-09-23
- **Last Updated**: 2021-11-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ohosProcess

**本项目是基于开源项目AndroidProcess进行ohos化的移植和开发的，可以通过项目标签以及github地址（https://github.com/wenmingvs/AndroidProcess ）追踪到原项目版本**

## 项目介绍

- 项目名称：ohosProcess
- 所属系列：ohos的第三方组件适配移植
- 功能：判断应用处于前后台。
- 项目移植状态：完成
- 调用差异：无
- 项目作者和维护人：hihope
- 联系方式：hihope@hoperun.com
- 原项目Doc地址：https://github.com/wenmingvs/AndroidProcess
- 原项目基线版本：无, sha1:0c05dd14279cc3dc32baffdbb94e76d5ead56f33
- 编程语言：Java
- 外部库依赖：无

#### 效果展示

![gif](screenshots/operation.gif)

## 安装教程

方法1.

1. 编译library的har包ohosProcess.har。
2. 启动 DevEco Studio，将编译的har包，导入工程目录“entry->libs”下。
3. 在moudle级别下的build.gradle文件中添加依赖，在dependences标签中增加对libs目录下har包的引用。
```
dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar', '*.har'])
	……
}
```
4. 在导入的har包上点击右键，选择“Add as Library”对包进行引用，选择需要引用的模块，并点击“OK”即引用成功。

方法2.

1. 在工程的build.gradle的allprojects中，添加HAR所在的Maven仓地址
```
repositories {
    maven {
        url 'http://106.15.92.248:8081/repository/Releases/'
    }
}
```
2. 在应用模块的build.gradle的dependencies闭包中，添加如下代码:
```
dependencies {
    implementation 'com.wenming.ohos:ohosProcess:1.0.0'
}
```

## 使用说明

1. gradle中添加依赖:
```
implementation 'com.wenming.ohos:ohosProcess:1.0.0'
```
2. 调用对应函数
``` java
//使用方法一
Boolean isForeground = BackgroundUtil.getRunningTask(context, packageName);

//使用方法二
Boolean isForeground = BackgroundUtil.getRunningAppProcesses(context, packageName);

//使用方法三
Boolean isForeground = BackgroundUtil.getApplicationValue(myApplication);

返回值true/false表示应用是否位于前台
```

## 版本迭代

- 1.0.0

- 支持通过RunningAbilityMissionInfo判断
- 支持通过getAllRunningProcesses判断
- 支持通过AbilityLifecycleCallbacks判断
- 不支持通过BundleActiveInfosMgr判断
- 不支持通过系统无障碍功能实现
- 不支持通过读取/proc目录下的信息判断

## 版权和许可信息

    Apache-2.0 License