Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit aea74a59 authored by Craig Mautner's avatar Craig Mautner
Browse files

Add Lock Task Mode. 

When in lock task mode only the specified task may run. All
attempts to switch to another task are ignored until the task
finishes or a call to stopLockTaskMode() is made.

Change-Id: I6cfe92fe1bcf22cd47b5398c08e23c52a4092dda
parent 1cb98aea

cmds/am/src/com/android/commands/am/Am.java

+21 −0
Original line number Diff line number Diff line
@@ -114,6 +114,8 @@ public class Am extends BaseCommand { 
                "       am stack resize <STACK_ID> <LEFT,TOP,RIGHT,BOTTOM>\n" +

                "       am stack list\n" +

                "       am stack info <STACK_ID>\n" +

                "       am lock-task <TASK_ID>\n" +

                "       am lock-task stop\n" +

                "\n" +

                "am start: start an Activity.  Options are:\n" +

                "    -D: enable debugging\n" +
@@ -218,6 +220,8 @@ public class Am extends BaseCommand { 
                "\n" +

                "am stack info: display the information about activity stack <STACK_ID>.\n" +

                "\n" +

                "am lock-task: bring <TASK_ID> to the front and don't allow other tasks to run\n" +

                "\n" +

                "<INTENT> specifications include these flags and arguments:\n" +

                "    [-a <ACTION>] [-d <DATA_URI>] [-t <MIME_TYPE>]\n" +

                "    [-c <CATEGORY> [-c <CATEGORY>] ...]\n" +
@@ -309,6 +313,8 @@ public class Am extends BaseCommand { 
            runStopUser();

        } else if (op.equals("stack")) {

            runStack();

        } else if (op.equals("lock-task")) {

            runLockTask();

        } else {

            showError("Error: unknown command '" + op + "'");

        }
@@ -1641,4 +1647,19 @@ public class Am extends BaseCommand { 
        } catch (RemoteException e) {

        }

    }



    private void runLockTask() throws Exception {

        String taskIdStr = nextArgRequired();

        try {

            if (taskIdStr.equals("stop")) {

                mAm.stopLockTaskMode();

            } else {

                int taskId = Integer.valueOf(taskIdStr);

                mAm.startLockTaskMode(taskId);

            }

            System.err.println("Activity manager is " + (mAm.isInLockTaskMode() ? "" : "not ") +

                    "in lockTaskMode");

        } catch (RemoteException e) {

        }

    }

}

core/java/android/app/Activity.java

+16 −0
Original line number Diff line number Diff line
@@ -5606,6 +5606,22 @@ public class Activity extends ContextThemeWrapper 
        }

    }



    /** @hide */

    public void startLockTask() {

        try {

            ActivityManagerNative.getDefault().startLockTaskMode(mToken);

        } catch (RemoteException e) {

        }

    }



    /** @hide */

    public void stopLockTask() {

        try {

            ActivityManagerNative.getDefault().stopLockTaskMode();

        } catch (RemoteException e) {

        }

    }



    /**

     * Interface for informing a translucent {@link Activity} once all visible activities below it

     * have completed drawing. This is necessary only after an {@link Activity} has been made

core/java/android/app/ActivityManager.java

+38 −0
Original line number Diff line number Diff line
@@ -154,6 +154,13 @@ public class ActivityManager { 
     */

    public static final int START_SWITCHES_CANCELED = 4;



    /**

     * Result for IActivityManaqer.startActivity: a new activity was attempted to be started

     * while in Lock Task Mode.

     * @hide

     */

    public static final int START_RETURN_LOCK_TASK_MODE_VIOLATION = 5;



    /**

     * Flag for IActivityManaqer.startActivity: do special start mode where

     * a new activity is launched only if it is needed.
@@ -2232,4 +2239,35 @@ public class ActivityManager { 
            e.printStackTrace(pw);

        }

    }



    /**

     * @hide

     */

    public void startLockTaskMode(int taskId) {

        try {

            ActivityManagerNative.getDefault().startLockTaskMode(taskId);

        } catch (RemoteException e) {

        }

    }



    /**

     * @hide

     */

    public void stopLockTaskMode() {

        try {

            ActivityManagerNative.getDefault().stopLockTaskMode();

        } catch (RemoteException e) {

        }

    }



    /**

     * @hide

     */

    public boolean isInLockTaskMode() {

        try {

            return ActivityManagerNative.getDefault().isInLockTaskMode();

        } catch (RemoteException e) {

            return false;

        }

    }

}

core/java/android/app/ActivityManagerNative.java

+79 −0
Original line number Diff line number Diff line
@@ -2097,6 +2097,37 @@ public abstract class ActivityManagerNative extends Binder implements IActivityM 
            reply.writeStrongBinder(homeActivityToken);

            return true;

        }



        case START_LOCK_TASK_BY_TASK_ID_TRANSACTION: {

            data.enforceInterface(IActivityManager.descriptor);

            final int taskId = data.readInt();

            startLockTaskMode(taskId);

            reply.writeNoException();

            return true;

        }



        case START_LOCK_TASK_BY_TOKEN_TRANSACTION: {

            data.enforceInterface(IActivityManager.descriptor);

            IBinder token = data.readStrongBinder();

            startLockTaskMode(token);

            reply.writeNoException();

            return true;

        }



        case STOP_LOCK_TASK_MODE_TRANSACTION: {

            data.enforceInterface(IActivityManager.descriptor);

            stopLockTaskMode();

            reply.writeNoException();

            return true;

        }



        case IS_IN_LOCK_TASK_MODE_TRANSACTION: {

            data.enforceInterface(IActivityManager.descriptor);

            final boolean isInLockTaskMode = isInLockTaskMode();

            reply.writeNoException();

            reply.writeInt(isInLockTaskMode ? 1 : 0);

            return true;

        }

        }



        return super.onTransact(code, data, reply, flags);
@@ -4820,5 +4851,53 @@ class ActivityManagerProxy implements IActivityManager 
        return res;

    }



    @Override

    public void startLockTaskMode(int taskId) throws RemoteException {

        Parcel data = Parcel.obtain();

        Parcel reply = Parcel.obtain();

        data.writeInterfaceToken(IActivityManager.descriptor);

        data.writeInt(taskId);

        mRemote.transact(START_LOCK_TASK_BY_TASK_ID_TRANSACTION, data, reply, 0);

        reply.readException();

        data.recycle();

        reply.recycle();

    }



    @Override

    public void startLockTaskMode(IBinder token) throws RemoteException {

        Parcel data = Parcel.obtain();

        Parcel reply = Parcel.obtain();

        data.writeInterfaceToken(IActivityManager.descriptor);

        data.writeStrongBinder(token);

        mRemote.transact(START_LOCK_TASK_BY_TOKEN_TRANSACTION, data, reply, 0);

        reply.readException();

        data.recycle();

        reply.recycle();

    }



    @Override

    public void stopLockTaskMode() throws RemoteException {

        Parcel data = Parcel.obtain();

        Parcel reply = Parcel.obtain();

        data.writeInterfaceToken(IActivityManager.descriptor);

        mRemote.transact(STOP_LOCK_TASK_MODE_TRANSACTION, data, reply, 0);

        reply.readException();

        data.recycle();

        reply.recycle();

    }



    @Override

    public boolean isInLockTaskMode() throws RemoteException {

        Parcel data = Parcel.obtain();

        Parcel reply = Parcel.obtain();

        data.writeInterfaceToken(IActivityManager.descriptor);

        mRemote.transact(IS_IN_LOCK_TASK_MODE_TRANSACTION, data, reply, 0);

        reply.readException();

        boolean isInLockTaskMode = reply.readInt() == 1;

        data.recycle();

        reply.recycle();

        return isInLockTaskMode;

    }



    private IBinder mRemote;

}

core/java/android/app/IActivityManager.java

+16 −0
Original line number Diff line number Diff line
@@ -424,6 +424,18 @@ public interface IActivityManager extends IInterface { 


    public IBinder getHomeActivityToken() throws RemoteException;



    /** @hide */

    public void startLockTaskMode(int taskId) throws RemoteException;



    /** @hide */

    public void startLockTaskMode(IBinder token) throws RemoteException;



    /** @hide */

    public void stopLockTaskMode() throws RemoteException;



    /** @hide */

    public boolean isInLockTaskMode() throws RemoteException;



    /*

     * Private non-Binder interfaces

     */
@@ -719,4 +731,8 @@ public interface IActivityManager extends IInterface { 
    int GET_TAG_FOR_INTENT_SENDER_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+210;

    int START_USER_IN_BACKGROUND_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+211;

    int IS_IN_HOME_STACK_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+212;

    int START_LOCK_TASK_BY_TASK_ID_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+213;

    int START_LOCK_TASK_BY_TOKEN_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+214;

    int STOP_LOCK_TASK_MODE_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+215;

    int IS_IN_LOCK_TASK_MODE_TRANSACTION = IBinder.FIRST_CALL_TRANSACTION+216;

}