JarCasting
JarCasting JarCasting

Android Processes

Run ps in a root shell on Android

License

License
GroupId

GroupId

com.jaredrummler
ArtifactId

ArtifactId

sups
Last Version

Last Version

0.0.2
Release Date

Release Date
Type

Type

aar
Description

Description

Android Processes
Run ps in a root shell on Android
Project URL

Project URL

https://github.com/jaredrummler/AndroidProcesses
Source Code Management

Source Code Management

https://github.com/jaredrummler/AndroidProcesses

Download sups

Filename Size
sups-0.0.2.pom
sups-0.0.2.aar 6 KB
sups-0.0.2-sources.jar 4 KB
sups-0.0.2-javadoc.jar 23 KB
Browse

How to add to project

<!-- https://jarcasting.com/artifacts/com.jaredrummler/sups/ -->
<dependency>
    <groupId>com.jaredrummler</groupId>
    <artifactId>sups</artifactId>
    <version>0.0.2</version>
    <type>aar</type>
</dependency>
// https://jarcasting.com/artifacts/com.jaredrummler/sups/
implementation 'com.jaredrummler:sups:0.0.2'
// https://jarcasting.com/artifacts/com.jaredrummler/sups/
implementation ("com.jaredrummler:sups:0.0.2")
'com.jaredrummler:sups:aar:0.0.2'
<dependency org="com.jaredrummler" name="sups" rev="0.0.2">
  <artifact name="sups" type="aar" />
</dependency>
@Grapes(
@Grab(group='com.jaredrummler', module='sups', version='0.0.2')
)
libraryDependencies += "com.jaredrummler" % "sups" % "0.0.2"
[com.jaredrummler/sups "0.0.2"]

Dependencies

compile (1)

Group / Artifact Type Version
com.jaredrummler : android-shell jar 1.0.0

Project Modules

There are no modules declared in this project.

AndroidProcesses

A small Android library to get the current running processes

API License Maven Central

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.

More details can be found at:

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) and getRunningAppProcesses(). Both of these methods are now deprecated and only return the caller’s application process.

Android 5.0 introduced UsageStatsManager 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:

// Get a list of running apps
List<AndroidAppProcess> 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(). The library does not provide a processes' pkgList, lru, or importance.
  • This is currently not working on the N developer preview.

Download

Download the latest AAR or grab via Gradle:

compile 'com.jaredrummler:android-processes:1.1.1'

or Maven:

<dependency>
  <groupId>com.jaredrummler</groupId>
  <artifactId>android-processes</artifactId>
  <version>1.1.1</version>
  <type>aar</type>
</dependency>

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, Clean Master, Security Master, CM Launcher 3D, Virus Cleaner by Hi Security, and Super Cleaner. 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.

Versions

Version
0.0.2
0.0.1