Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jaredrummler/androidprocesses
DEPRECATED
https://github.com/jaredrummler/androidprocesses
android android-library androidprocesses process-monitor processes usagestatsmanager
Last synced: 3 days ago
JSON representation
DEPRECATED
- Host: GitHub
- URL: https://github.com/jaredrummler/androidprocesses
- Owner: jaredrummler
- License: apache-2.0
- Created: 2015-10-20T13:24:30.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2022-03-02T01:56:05.000Z (over 2 years ago)
- Last Synced: 2024-04-07T15:36:04.194Z (7 months ago)
- Topics: android, android-library, androidprocesses, process-monitor, processes, usagestatsmanager
- Language: Java
- Homepage:
- Size: 523 KB
- Stars: 1,801
- Watchers: 92
- Forks: 382
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
AndroidProcesses
A small Android library to get the current running processes
___
# PLEASE NOTE, THIS PROJECT IS NO LONGER BEING MAINTAINED
Google has significantly restricted access to `/proc` in Android Nougat. This library will not work on Android 7.0. Please [star this issue](https://code.google.com/p/android/issues/detail?id=205565).
More details can be found at:
* https://jaredrummler.com/2017/09/13/android-processes/
* https://code.google.com/p/android/issues/detail?id=205565
---
# DONATIONS
Give back to the author of the library: bc1qm33s8s0hh5dqffpvv5ahmgyte2sy7g7pjftl43 🖖
What is this library for?
-------------------------
This small library can get a list of running apps and does not require any permissions.
Why would I need this?
----------------------
Android 5.0+ killed [`getRunningTasks(int)`](http://developer.android.com/intl/zh-cn/reference/android/app/ActivityManager.html#getRunningTasks(int)) and [`getRunningAppProcesses()`](http://developer.android.com/intl/zh-cn/reference/android/app/ActivityManager.html#getRunningAppProcesses()). Both of these methods are now deprecated and only return the caller’s application process.
Android 5.0 introduced [UsageStatsManager](https://developer.android.com/reference/android/app/usage/UsageStatsManager.html) which provides access to device usage history and statistics. This API requires the permission `android.permission.PACKAGE_USAGE_STATS`, which is a system-level permission and will not be granted to third-party apps. However, declaring the permission implies intention to use the API and the user of the device can grant permission through the Settings application.
Usage
-----
**Get a list of running apps:**
```java
// Get a list of running apps
List processes = AndroidProcesses.getRunningAppProcesses();
for (AndroidAppProcess process : processes) {
// Get some information about the process
String processName = process.name;
Stat stat = process.stat();
int pid = stat.getPid();
int parentProcessId = stat.ppid();
long startTime = stat.stime();
int policy = stat.policy();
char state = stat.state();
Statm statm = process.statm();
long totalSizeOfProcess = statm.getSize();
long residentSetSize = statm.getResidentSetSize();
PackageInfo packageInfo = process.getPackageInfo(context, 0);
String appName = packageInfo.applicationInfo.loadLabel(pm).toString();
}
```
Limitations
-----------
* System apps will not be included on some Android versions because they have a higher SELinux context.
* This is not a full replacement of [getRunningAppProcesses()](http://developer.android.com/intl/zh-cn/reference/android/app/ActivityManager.html#getRunningAppProcesses()). The library does not provide a processes' [pkgList](http://developer.android.com/reference/android/app/ActivityManager.RunningAppProcessInfo.html#pkgList), [lru](http://developer.android.com/intl/zh-cn/reference/android/app/ActivityManager.RunningAppProcessInfo.html#lru), or [importance](http://developer.android.com/intl/zh-cn/reference/android/app/ActivityManager.RunningAppProcessInfo.html#importance).
* This is currently not working on the N developer preview.
Download
--------
Download [the latest AAR](https://repo1.maven.org/maven2/com/jaredrummler/android-processes/1.1.1/android-processes-1.1.1.aar) or grab via Gradle:
```groovy
compile 'com.jaredrummler:android-processes:1.1.1'
```
or Maven:
```xml
com.jaredrummler
android-processes
1.1.1
aar
```
Adoption
--------
In 2017 I decompiled the top 150 free apps on Google Play and found numerous apps using this library. Companies using the library include Cheetah Mobile and Baidu. Apps using this library include [ES File Explorer](https://play.google.com/store/apps/details?id=com.estrongs.android.pop&hl=en), [Clean Master](https://play.google.com/store/apps/details?id=com.cleanmaster.mguard&hl=en), [Security Master](https://play.google.com/store/apps/details?id=com.cleanmaster.security&hl=en), [CM Launcher 3D](https://play.google.com/store/apps/details?id=com.ksmobile.launcher&hl=en), [Virus Cleaner](https://play.google.com/store/apps/details?id=com.ehawk.antivirus.applock.wifi&hl=en) by Hi Security, and [Super Cleaner](https://play.google.com/store/apps/details?id=com.apps.go.clean.boost.master&hl=en). Combined, these apps have at least **1.2 billion downloads**!
License
--------
Copyright (C) 2015 Jared Rummler
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.