1 /*
2  * Copyright (C) 2014 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 package android.app;
18 
19 import android.annotation.NonNull;
20 import android.content.ComponentName;
21 
22 /**
23  * Activity manager local system service interface.
24  *
25  * @hide Only for use within the system server.
26  */
27 public abstract class ActivityManagerInternal {
28     // Called by the power manager.
onWakefulnessChanged(int wakefulness)29     public abstract void onWakefulnessChanged(int wakefulness);
30 
startIsolatedProcess(String entryPoint, String[] mainArgs, String processName, String abiOverride, int uid, Runnable crashHandler)31     public abstract int startIsolatedProcess(String entryPoint, String[] mainArgs,
32             String processName, String abiOverride, int uid, Runnable crashHandler);
33 
34     /**
35      * Acquires a sleep token with the specified tag.
36      *
37      * @param tag A string identifying the purpose of the token (eg. "Dream").
38      */
acquireSleepToken(@onNull String tag)39     public abstract SleepToken acquireSleepToken(@NonNull String tag);
40 
41     /**
42      * Sleep tokens cause the activity manager to put the top activity to sleep.
43      * They are used by components such as dreams that may hide and block interaction
44      * with underlying activities.
45      */
46     public static abstract class SleepToken {
47         /**
48          * Releases the sleep token.
49          */
release()50         public abstract void release();
51     }
52 
53     /**
54      * Returns home activity for the specified user.
55      * @param userId ID of the user or {@link android.os.UserHandle#USER_ALL}
56      */
getHomeActivityForUser(int userId)57     public abstract ComponentName getHomeActivityForUser(int userId);
58 }
59