普通APP如何使得系统休眠

---

---

引言

Android 系统休眠，常见的接口是PowerManager提供的goToSleep，但是很遗憾，调用这个接口需要System 权限；即用Platform key签名的APP才可以；

那么普通APP 可否使得系统suspend呢？

lockNow函数的作用

lockNow定义于文件DevicePolicyManager.java中，实现如下：

mService即IDevicePolicyManager，由DevicePolicyManagerService实现；

public void lockNow() {    if (mService != null) {        try {                mService.lockNow();            } catch (RemoteException e) {                Log.w(TAG, "Failed talking with device policy service", e);            }        }    }

mService即IDevicePolicyManager，由DevicePolicyManagerService实现；
所以lockNow的具体实现在DevicePolicyManagerService中

public void lockNow() {    if (!mHasFeature) {        return;    }    synchronized (this) {        // This API can only be called by an active device admin,        // so try to retrieve it to check that the caller is one.       getActiveAdminForCallerLocked(null,           DeviceAdminInfo.USES_POLICY_FORCE_LOCK);       lockNowUnchecked();    }}private void lockNowUnchecked() {    long ident = Binder.clearCallingIdentity();    try {        // Power off the display                mPowerManager.goToSleep(SystemClock.uptimeMillis(),                           PowerManager.GO_TO_SLEEP_REASON_DEVICE_ADMIN, 0);        // Ensure the device is locked        new LockPatternUtils(mContext).requireCredentialEntry(UserHandle.USER_ALL);        getWindowManager().lockNow(null);    } catch (RemoteException e) {    } finally {        Binder.restoreCallingIdentity(ident);    } }

getActiveAdminForCallerLocked检查当前的调用者是否为Device admin，如果是的，则执行lockNowUnchecked，否则会在getActiveAdminForCallerLocked执行过程中抛出SecurityException;

而lockNowUnchecked函数实际上调用了goToSleep使得系统suspend；

总的来说，lockNow是对goToSleep降低权限的封装，所以我们可以通过调用lockNow来实现系统suspend

普通APP如何使得系统休眠

在Android系统中，APP根据签名不同分为system app或者普通app，system app使用platform key签名，具备system权限，可以做一些系统级别的操作，例如调用goToSleep，调用reboot等；普通APP即用没有用哦platform key签名的app；那么这样的APP 如何实现系统休眠呢？我们刚刚提到的lockNow函数就是一种办法；但是问题是，嗲用lockNow之前得先具备device admin权限；

普通APP如何成为device admin

1.. 在AndroidManifest.xml中添加receiver类继承自DeviceAdminReceiver

<application        android:allowBackup="true"        android:icon="@drawable/ic_launcher"        android:label="@string/app_name"        android:theme="@style/AppTheme" >        <activity            android:name="com.example.suspendappnormal.MainActivity"            android:label="@string/app_name" >            <intent-filter>                <action android:name="android.intent.action.MAIN" />                <category android:name="android.intent.category.LAUNCHER" />            </intent-filter>        </activity>        <receiver            android:name="com.example.suspendappnormal.MyAdmin"            android:label="@string/app_name"            android:permission="android.permission.BIND_DEVICE_ADMIN" >            <meta-data                android:name="android.app.device_admin"                android:resource="@xml/device_admin" />            <intent-filter>                <action                    android:name="android.app.action.DEVICE_ADMIN_ENABLED" />            </intent-filter>        </receiver>    </application>

MyAdmin即为添加的receiver

2.. 为MyAdmin添加java code

package com.example.suspendappnormal;import android.app.admin.DeviceAdminReceiver;public class MyAdmin extends DeviceAdminReceiver {}

很简单，就是一个继承自DeviceAdminReceiver的类，不用实现任何函数

3.. 在Activity中实现device admin的添加
activity_main.xml文件

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"    xmlns:tools="http://schemas.android.com/tools"    android:layout_width="match_parent"    android:layout_height="match_parent"    android:orientation="vertical"    android:paddingBottom="@dimen/activity_vertical_margin"    android:paddingLeft="@dimen/activity_horizontal_margin"    android:paddingRight="@dimen/activity_horizontal_margin"    android:paddingTop="@dimen/activity_vertical_margin"    tools:context="com.example.suspendappnormal.MainActivity" >    <Button         android:id="@+id/admin_add_btn"        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:text="AddToAdminDevice"/>    <Button         android:id="@+id/suspend_btn"        android:layout_height="wrap_content"        android:layout_width="wrap_content"        android:text="suspend"/></LinearLayout>

id 为admin_add_btn的button，做 device admin的添加，如果添加成功之后，该按钮编程灰色，不可点击；如果已经具备device admin权限，该按钮也是灰色，不可点击；

id为suspend_btn的Button，完成lockNow函数的执行；

onCreate函数

protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.activity_main);        mAdminName = new ComponentName(this, MyAdmin.class);        mDm = (DevicePolicyManager) getSystemService(DEVICE_POLICY_SERVICE);        mAdminAddBtn = (Button)findViewById(R.id.admin_add_btn);        mAdminAddBtn.setOnClickListener(this);        mSuspendBtn = (Button)findViewById(R.id.suspend_btn);        mSuspendBtn.setOnClickListener(this);        if (!mDm.isAdminActive(mAdminName)) {            mAdminAddBtn.setEnabled(true);        } else {            mAdminAddBtn.setEnabled(false);        }    }

new 出mAdminName的component组件，就是为该组件所在的process添加admin权限；

点击AddToAdminDevice button，则添加admin权限，button的click相应事件如下：

@Override    public void onClick(View v) {        // TODO Auto-generated method stub        switch(v.getId()) {        case R.id.admin_add_btn:            if (mDm != null) {                if (!mDm.isAdminActive(mAdminName)) {                    Log.i(TAG, "has no admin, add it");                    Intent intent = new Intent(DevicePolicyManager.ACTION_ADD_DEVICE_ADMIN);                    intent.putExtra (DevicePolicyManager.EXTRA_DEVICE_ADMIN, mAdminName);                    intent.putExtra(DevicePolicyManager.EXTRA_ADD_EXPLANATION, "sara sara sara");                    startActivityForResult(intent, 0);                    mAdminAddBtn.setEnabled(false);                }            }            break;        case R.id.suspend_btn:            if (mDm != null) {                if (mDm.isAdminActive(mAdminName)) {                    Log.i(TAG, "lockNow");                    mDm.lockNow();                } else {                    Log.i(TAG, "admin not active");                }            }            break;        default:            break;        }    }

4.. 运行效果如下：
第一次运行该APP时：

点击ADDTOADMIN button

点击Active

此时ADDTOADMIN button是disable的，因为此时APP已经获得了admin权限；
点击Suspend即会使得系统suspend

结束语

device admin权限，只用申请一次，该APP就一直拥有，所以不用每次调用lockNow时，都去为该APP申请；

此外Android系统中，admin权限的管理在Setting app中；
Setting->security->Device Adminstrators;

如果要删除具备admin权限的APP，需要先到Setting中，将该权限移除；否则无法删除该APP；