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 17 package android.app; 18 19 import android.accessibilityservice.IAccessibilityServiceClient; 20 import android.graphics.Bitmap; 21 import android.graphics.Rect; 22 import android.view.InputEvent; 23 import android.view.SurfaceControl; 24 import android.view.WindowContentFrameStats; 25 import android.view.WindowAnimationFrameStats; 26 import android.os.ParcelFileDescriptor; 27 import android.window.ScreenCapture.ScreenCaptureListener; 28 import android.window.ScreenCapture.LayerCaptureArgs; 29 30 import java.util.List; 31 32 /** 33 * This interface contains privileged operations a shell program can perform 34 * on behalf of an instrumentation that it runs. These operations require 35 * special permissions which the shell user has but the instrumentation does 36 * not. Running privileged operations by the shell user on behalf of an 37 * instrumentation is needed for running UiTestCases. 38 * 39 * {@hide} 40 */ 41 interface IUiAutomationConnection { connect(IAccessibilityServiceClient client, int flags)42 void connect(IAccessibilityServiceClient client, int flags); disconnect()43 void disconnect(); injectInputEvent(in InputEvent event, boolean sync, boolean waitForAnimations)44 boolean injectInputEvent(in InputEvent event, boolean sync, boolean waitForAnimations); injectInputEventToInputFilter(in InputEvent event)45 void injectInputEventToInputFilter(in InputEvent event); syncInputTransactions(boolean waitForAnimations)46 void syncInputTransactions(boolean waitForAnimations); setRotation(int rotation)47 boolean setRotation(int rotation); takeScreenshot(in Rect crop, in ScreenCaptureListener listener)48 boolean takeScreenshot(in Rect crop, in ScreenCaptureListener listener); takeSurfaceControlScreenshot(in SurfaceControl surfaceControl, in ScreenCaptureListener listener)49 boolean takeSurfaceControlScreenshot(in SurfaceControl surfaceControl, in ScreenCaptureListener listener); clearWindowContentFrameStats(int windowId)50 boolean clearWindowContentFrameStats(int windowId); getWindowContentFrameStats(int windowId)51 WindowContentFrameStats getWindowContentFrameStats(int windowId); clearWindowAnimationFrameStats()52 void clearWindowAnimationFrameStats(); getWindowAnimationFrameStats()53 WindowAnimationFrameStats getWindowAnimationFrameStats(); executeShellCommand(String command, in ParcelFileDescriptor sink, in ParcelFileDescriptor source)54 void executeShellCommand(String command, in ParcelFileDescriptor sink, 55 in ParcelFileDescriptor source); grantRuntimePermission(String packageName, String permission, int userId)56 void grantRuntimePermission(String packageName, String permission, int userId); revokeRuntimePermission(String packageName, String permission, int userId)57 void revokeRuntimePermission(String packageName, String permission, int userId); adoptShellPermissionIdentity(int uid, in String[] permissions)58 void adoptShellPermissionIdentity(int uid, in String[] permissions); dropShellPermissionIdentity()59 void dropShellPermissionIdentity(); 60 // Called from the system process. shutdown()61 oneway void shutdown(); executeShellCommandWithStderr(String command, in ParcelFileDescriptor sink, in ParcelFileDescriptor source, in ParcelFileDescriptor stderrSink)62 void executeShellCommandWithStderr(String command, in ParcelFileDescriptor sink, 63 in ParcelFileDescriptor source, in ParcelFileDescriptor stderrSink); getAdoptedShellPermissions()64 List<String> getAdoptedShellPermissions(); addOverridePermissionState(int uid, String permission, int result)65 void addOverridePermissionState(int uid, String permission, int result); removeOverridePermissionState(int uid, String permission)66 void removeOverridePermissionState(int uid, String permission); clearOverridePermissionStates(int uid)67 void clearOverridePermissionStates(int uid); clearAllOverridePermissionStates()68 void clearAllOverridePermissionStates(); 69 } 70