1/*
2 * Copyright (C) 2013 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
17package android.app;
18
19import android.accessibilityservice.IAccessibilityServiceClient;
20import android.graphics.Bitmap;
21import android.graphics.Rect;
22import android.view.InputEvent;
23import android.view.WindowContentFrameStats;
24import android.view.WindowAnimationFrameStats;
25import android.os.ParcelFileDescriptor;
26
27/**
28 * This interface contains privileged operations a shell program can perform
29 * on behalf of an instrumentation that it runs. These operations require
30 * special permissions which the shell user has but the instrumentation does
31 * not. Running privileged operations by the shell user on behalf of an
32 * instrumentation is needed for running UiTestCases.
33 *
34 * {@hide}
35 */
36interface IUiAutomationConnection {
37    void connect(IAccessibilityServiceClient client, int flags);
38    void disconnect();
39    boolean injectInputEvent(in InputEvent event, boolean sync);
40    boolean setRotation(int rotation);
41    Bitmap takeScreenshot(in Rect crop, int rotation);
42    boolean clearWindowContentFrameStats(int windowId);
43    WindowContentFrameStats getWindowContentFrameStats(int windowId);
44    void clearWindowAnimationFrameStats();
45    WindowAnimationFrameStats getWindowAnimationFrameStats();
46    void executeShellCommand(String command, in ParcelFileDescriptor sink,
47            in ParcelFileDescriptor source);
48    void grantRuntimePermission(String packageName, String permission, int userId);
49    void revokeRuntimePermission(String packageName, String permission, int userId);
50
51    // Called from the system process.
52    oneway void shutdown();
53}
54