/* * Copyright 2016 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package android.os; import android.app.Activity; import android.app.GameManager; import android.content.BroadcastReceiver; import android.content.ContentResolver; import android.content.Context; import android.content.Intent; import android.content.pm.ApplicationInfo; import android.content.pm.IPackageManager; import android.content.pm.PackageInfo; import android.content.pm.PackageManager; import android.content.pm.ResolveInfo; import android.provider.Settings; import android.text.TextUtils; import android.util.Log; import android.widget.Toast; import dalvik.system.VMRuntime; import java.io.BufferedReader; import java.io.File; import java.io.IOException; import java.io.InputStreamReader; import java.util.ArrayList; import java.util.Arrays; import java.util.List; /** * GraphicsEnvironment sets up necessary properties for the graphics environment of the * application process. * GraphicsEnvironment uses a bunch of settings global variables to determine the setup, * the change of settings global variables will only take effect before setup() is called, * and any subsequent change will not impact the current running processes. * * @hide */ public class GraphicsEnvironment { private static final GraphicsEnvironment sInstance = new GraphicsEnvironment(); /** * Returns the shared {@link GraphicsEnvironment} instance. */ public static GraphicsEnvironment getInstance() { return sInstance; } private static final boolean DEBUG = false; private static final String TAG = "GraphicsEnvironment"; private static final String SYSTEM_DRIVER_NAME = "system"; private static final String SYSTEM_DRIVER_VERSION_NAME = ""; private static final long SYSTEM_DRIVER_VERSION_CODE = 0; private static final String ANGLE_DRIVER_NAME = "angle"; private static final String ANGLE_DRIVER_VERSION_NAME = ""; private static final long ANGLE_DRIVER_VERSION_CODE = 0; // System properties related to updatable graphics drivers. private static final String PROPERTY_GFX_DRIVER_PRODUCTION = "ro.gfx.driver.0"; private static final String PROPERTY_GFX_DRIVER_PRERELEASE = "ro.gfx.driver.1"; private static final String PROPERTY_GFX_DRIVER_BUILD_TIME = "ro.gfx.driver_build_time"; // Metadata flags within the tag in the AndroidManifest.xml file. private static final String METADATA_DRIVER_BUILD_TIME = "com.android.graphics.driver.build_time"; private static final String METADATA_DEVELOPER_DRIVER_ENABLE = "com.android.graphics.developerdriver.enable"; private static final String METADATA_INJECT_LAYERS_ENABLE = "com.android.graphics.injectLayers.enable"; private static final String UPDATABLE_DRIVER_ALLOWLIST_ALL = "*"; private static final String UPDATABLE_DRIVER_SPHAL_LIBRARIES_FILENAME = "sphal_libraries.txt"; private static final String ACTION_ANGLE_FOR_ANDROID = "android.app.action.ANGLE_FOR_ANDROID"; private static final String ACTION_ANGLE_FOR_ANDROID_TOAST_MESSAGE = "android.app.action.ANGLE_FOR_ANDROID_TOAST_MESSAGE"; private static final String INTENT_KEY_A4A_TOAST_MESSAGE = "A4A Toast Message"; private static final int VULKAN_1_0 = 0x00400000; private static final int VULKAN_1_1 = 0x00401000; private static final int VULKAN_1_2 = 0x00402000; private static final int VULKAN_1_3 = 0x00403000; // Values for UPDATABLE_DRIVER_ALL_APPS // 0: Default (Invalid values fallback to default as well) // 1: All apps use updatable production driver // 2: All apps use updatable prerelease driver // 3: All apps use system graphics driver private static final int UPDATABLE_DRIVER_GLOBAL_OPT_IN_DEFAULT = 0; private static final int UPDATABLE_DRIVER_GLOBAL_OPT_IN_PRODUCTION_DRIVER = 1; private static final int UPDATABLE_DRIVER_GLOBAL_OPT_IN_PRERELEASE_DRIVER = 2; private static final int UPDATABLE_DRIVER_GLOBAL_OPT_IN_OFF = 3; // Values for ANGLE_GL_DRIVER_ALL_ANGLE private static final int ANGLE_GL_DRIVER_ALL_ANGLE_ON = 1; private static final int ANGLE_GL_DRIVER_ALL_ANGLE_OFF = 0; // Values for ANGLE_GL_DRIVER_SELECTION_VALUES private static final String ANGLE_GL_DRIVER_CHOICE_DEFAULT = "default"; private static final String ANGLE_GL_DRIVER_CHOICE_ANGLE = "angle"; private static final String ANGLE_GL_DRIVER_CHOICE_NATIVE = "native"; private static final String SYSTEM_ANGLE_STRING = "system"; private ClassLoader mClassLoader; private String mLibrarySearchPaths; private String mLibraryPermittedPaths; private int mAngleOptInIndex = -1; private boolean mShouldUseAngle = false; /** * Set up GraphicsEnvironment */ public void setup(Context context, Bundle coreSettings) { final PackageManager pm = context.getPackageManager(); final String packageName = context.getPackageName(); final ApplicationInfo appInfoWithMetaData = getAppInfoWithMetadata(context, pm, packageName); Trace.traceBegin(Trace.TRACE_TAG_GRAPHICS, "setupGpuLayers"); setupGpuLayers(context, coreSettings, pm, packageName, appInfoWithMetaData); Trace.traceEnd(Trace.TRACE_TAG_GRAPHICS); // Setup ANGLE and pass down ANGLE details to the C++ code Trace.traceBegin(Trace.TRACE_TAG_GRAPHICS, "setupAngle"); if (setupAngle(context, coreSettings, pm, packageName)) { mShouldUseAngle = true; setGpuStats(ANGLE_DRIVER_NAME, ANGLE_DRIVER_VERSION_NAME, ANGLE_DRIVER_VERSION_CODE, 0, packageName, getVulkanVersion(pm)); } Trace.traceEnd(Trace.TRACE_TAG_GRAPHICS); Trace.traceBegin(Trace.TRACE_TAG_GRAPHICS, "chooseDriver"); if (!chooseDriver(context, coreSettings, pm, packageName, appInfoWithMetaData)) { if (!mShouldUseAngle) { setGpuStats(SYSTEM_DRIVER_NAME, SYSTEM_DRIVER_VERSION_NAME, SYSTEM_DRIVER_VERSION_CODE, SystemProperties.getLong(PROPERTY_GFX_DRIVER_BUILD_TIME, 0), packageName, getVulkanVersion(pm)); } } Trace.traceEnd(Trace.TRACE_TAG_GRAPHICS); Trace.traceBegin(Trace.TRACE_TAG_GRAPHICS, "notifyGraphicsEnvironmentSetup"); if (appInfoWithMetaData.category == ApplicationInfo.CATEGORY_GAME) { final GameManager gameManager = context.getSystemService(GameManager.class); if (gameManager != null) { gameManager.notifyGraphicsEnvironmentSetup(); } } Trace.traceEnd(Trace.TRACE_TAG_GRAPHICS); } /** * Switch the system to use ANGLE as the default GLES driver. */ public void toggleAngleAsSystemDriver(boolean enabled) { nativeToggleAngleAsSystemDriver(enabled); } /** * Query to determine the ANGLE driver choice. */ private String queryAngleChoice(Context context, Bundle coreSettings, String packageName) { if (TextUtils.isEmpty(packageName)) { Log.v(TAG, "No package name specified; use the system driver"); return ANGLE_GL_DRIVER_CHOICE_DEFAULT; } return queryAngleChoiceInternal(context, coreSettings, packageName); } private int getVulkanVersion(PackageManager pm) { // PackageManager doesn't have an API to retrieve the version of a specific feature, and we // need to avoid retrieving all system features here and looping through them. if (pm.hasSystemFeature(PackageManager.FEATURE_VULKAN_HARDWARE_VERSION, VULKAN_1_3)) { return VULKAN_1_3; } if (pm.hasSystemFeature(PackageManager.FEATURE_VULKAN_HARDWARE_VERSION, VULKAN_1_2)) { return VULKAN_1_2; } if (pm.hasSystemFeature(PackageManager.FEATURE_VULKAN_HARDWARE_VERSION, VULKAN_1_1)) { return VULKAN_1_1; } if (pm.hasSystemFeature(PackageManager.FEATURE_VULKAN_HARDWARE_VERSION, VULKAN_1_0)) { return VULKAN_1_0; } return 0; } /** * Check whether application is has set the manifest metadata for layer injection. */ private boolean canInjectLayers(ApplicationInfo ai) { return (ai.metaData != null && ai.metaData.getBoolean(METADATA_INJECT_LAYERS_ENABLE) && setInjectLayersPrSetDumpable()); } /** * Store the class loader for namespace lookup later. */ public void setLayerPaths(ClassLoader classLoader, String searchPaths, String permittedPaths) { // We have to store these in the class because they are set up before we // have access to the Context to properly set up GraphicsEnvironment mClassLoader = classLoader; mLibrarySearchPaths = searchPaths; mLibraryPermittedPaths = permittedPaths; } /** * Returns the debug layer paths from settings. * Returns null if: * 1) The application process is not debuggable or layer injection metadata flag is not * true; Or * 2) ENABLE_GPU_DEBUG_LAYERS is not true; Or * 3) Package name is not equal to GPU_DEBUG_APP. */ public String getDebugLayerPathsFromSettings( Bundle coreSettings, IPackageManager pm, String packageName, ApplicationInfo ai) { if (!debugLayerEnabled(coreSettings, packageName, ai)) { return null; } Log.i(TAG, "GPU debug layers enabled for " + packageName); String debugLayerPaths = ""; // Grab all debug layer apps and add to paths. final String gpuDebugLayerApps = coreSettings.getString(Settings.Global.GPU_DEBUG_LAYER_APP, ""); if (!gpuDebugLayerApps.isEmpty()) { Log.i(TAG, "GPU debug layer apps: " + gpuDebugLayerApps); // If a colon is present, treat this as multiple apps, so Vulkan and GLES // layer apps can be provided at the same time. final String[] layerApps = gpuDebugLayerApps.split(":"); for (int i = 0; i < layerApps.length; i++) { String paths = getDebugLayerAppPaths(pm, layerApps[i]); if (!paths.isEmpty()) { // Append the path so files placed in the app's base directory will // override the external path debugLayerPaths += paths + File.pathSeparator; } } } return debugLayerPaths; } /** * Return the debug layer app's on-disk and in-APK lib directories */ private String getDebugLayerAppPaths(IPackageManager pm, String packageName) { final ApplicationInfo appInfo; try { appInfo = pm.getApplicationInfo(packageName, PackageManager.MATCH_ALL, UserHandle.myUserId()); } catch (RemoteException e) { return ""; } if (appInfo == null) { Log.w(TAG, "Debug layer app '" + packageName + "' not installed"); return ""; } final String abi = chooseAbi(appInfo); final StringBuilder sb = new StringBuilder(); sb.append(appInfo.nativeLibraryDir) .append(File.pathSeparator) .append(appInfo.sourceDir) .append("!/lib/") .append(abi); final String paths = sb.toString(); if (DEBUG) Log.v(TAG, "Debug layer app libs: " + paths); return paths; } private boolean debugLayerEnabled(Bundle coreSettings, String packageName, ApplicationInfo ai) { // Only enable additional debug functionality if the following conditions are met: // 1. App is debuggable or device is rooted or layer injection metadata flag is true // 2. ENABLE_GPU_DEBUG_LAYERS is true // 3. Package name is equal to GPU_DEBUG_APP if (!isDebuggable() && !canInjectLayers(ai)) { return false; } final int enable = coreSettings.getInt(Settings.Global.ENABLE_GPU_DEBUG_LAYERS, 0); if (enable == 0) { return false; } final String gpuDebugApp = coreSettings.getString(Settings.Global.GPU_DEBUG_APP, ""); if (packageName == null || (gpuDebugApp.isEmpty() || packageName.isEmpty()) || !gpuDebugApp.equals(packageName)) { return false; } return true; } /** * Set up layer search paths for all apps */ private void setupGpuLayers( Context context, Bundle coreSettings, PackageManager pm, String packageName, ApplicationInfo ai) { final boolean enabled = debugLayerEnabled(coreSettings, packageName, ai); String layerPaths = ""; if (enabled) { layerPaths = mLibraryPermittedPaths; final String layers = coreSettings.getString(Settings.Global.GPU_DEBUG_LAYERS); Log.i(TAG, "Vulkan debug layer list: " + layers); if (layers != null && !layers.isEmpty()) { setDebugLayers(layers); } final String layersGLES = coreSettings.getString(Settings.Global.GPU_DEBUG_LAYERS_GLES); Log.i(TAG, "GLES debug layer list: " + layersGLES); if (layersGLES != null && !layersGLES.isEmpty()) { setDebugLayersGLES(layersGLES); } } // Include the app's lib directory in all cases layerPaths += mLibrarySearchPaths; setLayerPaths(mClassLoader, layerPaths); } private static List getGlobalSettingsString(ContentResolver contentResolver, Bundle bundle, String globalSetting) { final List valueList; final String settingsValue; if (bundle != null) { settingsValue = bundle.getString(globalSetting); } else { settingsValue = Settings.Global.getString(contentResolver, globalSetting); } if (settingsValue != null) { valueList = new ArrayList<>(Arrays.asList(settingsValue.split(","))); } else { valueList = new ArrayList<>(); } return valueList; } private static int getPackageIndex(String packageName, List packages) { for (int idx = 0; idx < packages.size(); idx++) { if (packages.get(idx).equals(packageName)) { return idx; } } return -1; } private static ApplicationInfo getAppInfoWithMetadata(Context context, PackageManager pm, String packageName) { ApplicationInfo ai; try { // Get the ApplicationInfo from PackageManager so that metadata fields present. ai = pm.getApplicationInfo(packageName, PackageManager.GET_META_DATA); } catch (PackageManager.NameNotFoundException e) { // Unlikely to fail for applications, but in case of failure, fall back to use the // ApplicationInfo from context directly. ai = context.getApplicationInfo(); } return ai; } /* * Determine which GLES "driver" should be used for the package, taking into account the * following factors (in priority order): * * 1) The semi-global switch (i.e. Settings.Global.ANGLE_GL_DRIVER_ALL_ANGLE; which is set by * the "angle_gl_driver_all_angle" setting; which forces a driver for all processes that * start after the Java run time is up), if it forces a choice; * 2) The per-application switch (i.e. Settings.Global.ANGLE_GL_DRIVER_SELECTION_PKGS and * Settings.Global.ANGLE_GL_DRIVER_SELECTION_VALUES; which corresponds to the * “angle_gl_driver_selection_pkgs” and “angle_gl_driver_selection_values” settings); if it * forces a choice. */ private String queryAngleChoiceInternal(Context context, Bundle bundle, String packageName) { // Make sure we have a good package name if (TextUtils.isEmpty(packageName)) { return ANGLE_GL_DRIVER_CHOICE_DEFAULT; } // Check the semi-global switch (i.e. once system has booted enough) for whether ANGLE // should be forced on or off for "all appplications" final int allUseAngle; if (bundle != null) { allUseAngle = bundle.getInt(Settings.Global.ANGLE_GL_DRIVER_ALL_ANGLE); } else { ContentResolver contentResolver = context.getContentResolver(); allUseAngle = Settings.Global.getInt(contentResolver, Settings.Global.ANGLE_GL_DRIVER_ALL_ANGLE, ANGLE_GL_DRIVER_ALL_ANGLE_OFF); } if (allUseAngle == ANGLE_GL_DRIVER_ALL_ANGLE_ON) { Log.v(TAG, "Turn on ANGLE for all applications."); return ANGLE_GL_DRIVER_CHOICE_ANGLE; } // Get the per-application settings lists final ContentResolver contentResolver = context.getContentResolver(); final List optInPackages = getGlobalSettingsString( contentResolver, bundle, Settings.Global.ANGLE_GL_DRIVER_SELECTION_PKGS); final List optInValues = getGlobalSettingsString( contentResolver, bundle, Settings.Global.ANGLE_GL_DRIVER_SELECTION_VALUES); Log.v(TAG, "Currently set values for:"); Log.v(TAG, " angle_gl_driver_selection_pkgs=" + optInPackages); Log.v(TAG, " angle_gl_driver_selection_values=" + optInValues); // Make sure we have good settings to use if (optInPackages.size() == 0 || optInPackages.size() != optInValues.size()) { Log.v(TAG, "Global.Settings values are invalid: " + "number of packages: " + optInPackages.size() + ", " + "number of values: " + optInValues.size()); return ANGLE_GL_DRIVER_CHOICE_DEFAULT; } // See if this application is listed in the per-application settings list final int pkgIndex = getPackageIndex(packageName, optInPackages); if (pkgIndex < 0) { Log.v(TAG, packageName + " is not listed in per-application setting"); return ANGLE_GL_DRIVER_CHOICE_DEFAULT; } mAngleOptInIndex = pkgIndex; // The application IS listed in the per-application settings list; and so use the // setting--choosing the current system driver if the setting is "default" String optInValue = optInValues.get(pkgIndex); Log.v(TAG, "ANGLE Developer option for '" + packageName + "' " + "set to: '" + optInValue + "'"); if (optInValue.equals(ANGLE_GL_DRIVER_CHOICE_ANGLE)) { return ANGLE_GL_DRIVER_CHOICE_ANGLE; } else if (optInValue.equals(ANGLE_GL_DRIVER_CHOICE_NATIVE)) { return ANGLE_GL_DRIVER_CHOICE_NATIVE; } // The user either chose default or an invalid value; go with the default driver. return ANGLE_GL_DRIVER_CHOICE_DEFAULT; } /** * Get the ANGLE package name. */ private String getAnglePackageName(PackageManager pm) { final Intent intent = new Intent(ACTION_ANGLE_FOR_ANDROID); final List resolveInfos = pm.queryIntentActivities(intent, PackageManager.MATCH_SYSTEM_ONLY); if (resolveInfos.size() != 1) { Log.v(TAG, "Invalid number of ANGLE packages. Required: 1, Found: " + resolveInfos.size()); if (DEBUG) { for (ResolveInfo resolveInfo : resolveInfos) { Log.d(TAG, "Found ANGLE package: " + resolveInfo.activityInfo.packageName); } } return ""; } // Must be exactly 1 ANGLE PKG found to get here. return resolveInfos.get(0).activityInfo.packageName; } /** * Check for ANGLE debug package, but only for apps that can load them. * An application can load ANGLE debug package if it is a debuggable application, or * the device is debuggable. */ private String getAngleDebugPackage(Context context, Bundle coreSettings) { if (!isDebuggable()) { return ""; } final String debugPackage; if (coreSettings != null) { debugPackage = coreSettings.getString(Settings.Global.ANGLE_DEBUG_PACKAGE); } else { ContentResolver contentResolver = context.getContentResolver(); debugPackage = Settings.Global.getString(contentResolver, Settings.Global.ANGLE_DEBUG_PACKAGE); } if (TextUtils.isEmpty(debugPackage)) { return ""; } return debugPackage; } /** * Determine whether ANGLE should be used, attempt to set up from apk first, if ANGLE can be * set up from apk, pass ANGLE details down to the C++ GraphicsEnv class via * GraphicsEnv::setAngleInfo(). If apk setup fails, attempt to set up to use system ANGLE. * Return false if both fail. * * @param context - Context of the application. * @param bundle - Bundle of the application. * @param packageManager - PackageManager of the application process. * @param packageName - package name of the application. * @return true: can set up to use ANGLE successfully. * false: can not set up to use ANGLE (not on allowlist, ANGLE not present, etc.) */ private boolean setupAngle(Context context, Bundle bundle, PackageManager packageManager, String packageName) { final String angleChoice = queryAngleChoice(context, bundle, packageName); if (angleChoice.equals(ANGLE_GL_DRIVER_CHOICE_DEFAULT)) { return false; } if (angleChoice.equals(ANGLE_GL_DRIVER_CHOICE_NATIVE)) { nativeSetAngleInfo("", true, packageName, null); return false; } return setupAngleFromApk(context, bundle, packageManager, packageName) || setupAngleFromSystem(context, bundle, packageName); } /** * Attempt to set up ANGLE from the packaged apk, if the apk can be found, pass ANGLE details to * the C++ GraphicsEnv class. * * @param context - Context of the application. * @param bundle - Bundle of the application. * @param packageManager - PackageManager of the application process. * @param packageName - package name of the application. * @return true: can set up to use ANGLE apk. * false: can not set up to use ANGLE apk (ANGLE apk not present, etc.) */ private boolean setupAngleFromApk(Context context, Bundle bundle, PackageManager packageManager, String packageName) { ApplicationInfo angleInfo = null; // If the developer has specified a debug package over ADB, attempt to find it String anglePkgName = getAngleDebugPackage(context, bundle); if (!anglePkgName.isEmpty()) { Log.v(TAG, "ANGLE debug package enabled: " + anglePkgName); try { // Note the debug package does not have to be pre-installed angleInfo = packageManager.getApplicationInfo(anglePkgName, 0); } catch (PackageManager.NameNotFoundException e) { // If the debug package is specified but not found, abort. Log.v(TAG, "ANGLE debug package '" + anglePkgName + "' not installed"); return false; } } // Otherwise, check to see if ANGLE is properly installed if (angleInfo == null) { anglePkgName = getAnglePackageName(packageManager); if (TextUtils.isEmpty(anglePkgName)) { Log.v(TAG, "Failed to find ANGLE package."); return false; } Log.v(TAG, "ANGLE package enabled: " + anglePkgName); try { // Production ANGLE libraries must be pre-installed as a system app angleInfo = packageManager.getApplicationInfo(anglePkgName, PackageManager.MATCH_SYSTEM_ONLY); } catch (PackageManager.NameNotFoundException e) { Log.v(TAG, "ANGLE package '" + anglePkgName + "' not installed"); return false; } } final String abi = chooseAbi(angleInfo); // Build a path that includes installed native libs and APK final String paths = angleInfo.nativeLibraryDir + File.pathSeparator + angleInfo.sourceDir + "!/lib/" + abi; if (DEBUG) { Log.d(TAG, "ANGLE package libs: " + paths); } // If we make it to here, ANGLE apk will be used. Call nativeSetAngleInfo() with the // application package name and ANGLE features to use. final String[] features = getAngleEglFeatures(context, bundle); nativeSetAngleInfo(paths, false, packageName, features); return true; } /** * Set up ANGLE from system. * * @param context - Context of the application. * @param bundle - Bundle of the application. * @param packageName - package name of the application. * @return true: can set up to use system ANGLE. * false: can not set up to use system ANGLE because it doesn't exist. */ private boolean setupAngleFromSystem(Context context, Bundle bundle, String packageName) { // System ANGLE always exists, call nativeSetAngleInfo() with the application package // name and ANGLE features to use. final String[] features = getAngleEglFeatures(context, bundle); nativeSetAngleInfo(SYSTEM_ANGLE_STRING, false, packageName, features); return true; } /** * Determine if the "ANGLE In Use" dialog box should be shown. */ private boolean shouldShowAngleInUseDialogBox(Context context) { try { ContentResolver contentResolver = context.getContentResolver(); final int showDialogBox = Settings.Global.getInt(contentResolver, Settings.Global.SHOW_ANGLE_IN_USE_DIALOG_BOX); return (showDialogBox == 1); } catch (Settings.SettingNotFoundException | SecurityException e) { // Do nothing and move on } // No setting, so assume false return false; } /** * Show the ANGLE in use dialog box. * The ANGLE in use dialog box will show up as long as the application * should use ANGLE. It does not mean the application has successfully * loaded ANGLE because this check happens before the loading completes. * @param context */ public void showAngleInUseDialogBox(Context context) { if (!shouldShowAngleInUseDialogBox(context)) { return; } if (!mShouldUseAngle) { return; } final Intent intent = new Intent(ACTION_ANGLE_FOR_ANDROID_TOAST_MESSAGE); final String anglePkg = getAnglePackageName(context.getPackageManager()); if (anglePkg.isEmpty()) { return; } intent.setPackage(anglePkg); context.sendOrderedBroadcast(intent, null, new BroadcastReceiver() { @Override public void onReceive(Context context, Intent intent) { final Bundle results = getResultExtras(true); final String toastMsg = results.getString(INTENT_KEY_A4A_TOAST_MESSAGE); final Toast toast = Toast.makeText(context, toastMsg, Toast.LENGTH_LONG); toast.show(); } }, null, Activity.RESULT_OK, null, null); } private String[] getAngleEglFeatures(Context context, Bundle coreSettings) { if (mAngleOptInIndex < 0) { return null; } final List featuresLists = getGlobalSettingsString( context.getContentResolver(), coreSettings, Settings.Global.ANGLE_EGL_FEATURES); if (featuresLists.size() <= mAngleOptInIndex) { return null; } return featuresLists.get(mAngleOptInIndex).split(":"); } /** * Return the driver package name to use. Return null for system driver. */ private String chooseDriverInternal(Bundle coreSettings, ApplicationInfo ai) { final String productionDriver = SystemProperties.get(PROPERTY_GFX_DRIVER_PRODUCTION); final boolean hasProductionDriver = productionDriver != null && !productionDriver.isEmpty(); final String prereleaseDriver = SystemProperties.get(PROPERTY_GFX_DRIVER_PRERELEASE); final boolean hasPrereleaseDriver = prereleaseDriver != null && !prereleaseDriver.isEmpty(); if (!hasProductionDriver && !hasPrereleaseDriver) { Log.v(TAG, "Neither updatable production driver nor prerelease driver is supported."); return null; } // To minimize risk of driver updates crippling the device beyond user repair, never use the // updatable drivers for privileged or non-updated system apps. Presumably pre-installed // apps were tested thoroughly with the system driver. if (ai.isPrivilegedApp() || (ai.isSystemApp() && !ai.isUpdatedSystemApp())) { if (DEBUG) { Log.v(TAG, "Ignore updatable driver package for privileged/non-updated system app."); } return null; } final boolean enablePrereleaseDriver = (ai.metaData != null && ai.metaData.getBoolean(METADATA_DEVELOPER_DRIVER_ENABLE)) || isDebuggable(); // Priority of updatable driver settings on confliction (Higher priority comes first): // 1. UPDATABLE_DRIVER_ALL_APPS // 2. UPDATABLE_DRIVER_PRODUCTION_OPT_OUT_APPS // 3. UPDATABLE_DRIVER_PRERELEASE_OPT_IN_APPS // 4. UPDATABLE_DRIVER_PRODUCTION_OPT_IN_APPS // 5. UPDATABLE_DRIVER_PRODUCTION_DENYLIST // 6. UPDATABLE_DRIVER_PRODUCTION_ALLOWLIST switch (coreSettings.getInt(Settings.Global.UPDATABLE_DRIVER_ALL_APPS, 0)) { case UPDATABLE_DRIVER_GLOBAL_OPT_IN_OFF: Log.v(TAG, "The updatable driver is turned off on this device."); return null; case UPDATABLE_DRIVER_GLOBAL_OPT_IN_PRODUCTION_DRIVER: Log.v(TAG, "All apps opt in to use updatable production driver."); return hasProductionDriver ? productionDriver : null; case UPDATABLE_DRIVER_GLOBAL_OPT_IN_PRERELEASE_DRIVER: Log.v(TAG, "All apps opt in to use updatable prerelease driver."); return hasPrereleaseDriver && enablePrereleaseDriver ? prereleaseDriver : null; case UPDATABLE_DRIVER_GLOBAL_OPT_IN_DEFAULT: default: break; } final String appPackageName = ai.packageName; if (getGlobalSettingsString(null, coreSettings, Settings.Global.UPDATABLE_DRIVER_PRODUCTION_OPT_OUT_APPS) .contains(appPackageName)) { Log.v(TAG, "App opts out for updatable production driver."); return null; } if (getGlobalSettingsString( null, coreSettings, Settings.Global.UPDATABLE_DRIVER_PRERELEASE_OPT_IN_APPS) .contains(appPackageName)) { Log.v(TAG, "App opts in for updatable prerelease driver."); return hasPrereleaseDriver && enablePrereleaseDriver ? prereleaseDriver : null; } // Early return here since the rest logic is only for updatable production Driver. if (!hasProductionDriver) { Log.v(TAG, "Updatable production driver is not supported on the device."); return null; } final boolean isOptIn = getGlobalSettingsString(null, coreSettings, Settings.Global.UPDATABLE_DRIVER_PRODUCTION_OPT_IN_APPS) .contains(appPackageName); final List allowlist = getGlobalSettingsString(null, coreSettings, Settings.Global.UPDATABLE_DRIVER_PRODUCTION_ALLOWLIST); if (!isOptIn && allowlist.indexOf(UPDATABLE_DRIVER_ALLOWLIST_ALL) != 0 && !allowlist.contains(appPackageName)) { Log.v(TAG, "App is not on the allowlist for updatable production driver."); return null; } // If the application is not opted-in, then check whether it's on the denylist, // terminate early if it's on the denylist and fallback to system driver. if (!isOptIn && getGlobalSettingsString( null, coreSettings, Settings.Global.UPDATABLE_DRIVER_PRODUCTION_DENYLIST) .contains(appPackageName)) { Log.v(TAG, "App is on the denylist for updatable production driver."); return null; } return productionDriver; } /** * Choose whether the current process should use the builtin or an updated driver. */ private boolean chooseDriver( Context context, Bundle coreSettings, PackageManager pm, String packageName, ApplicationInfo ai) { final String driverPackageName = chooseDriverInternal(coreSettings, ai); if (driverPackageName == null) { return false; } final PackageInfo driverPackageInfo; try { driverPackageInfo = pm.getPackageInfo(driverPackageName, PackageManager.MATCH_SYSTEM_ONLY | PackageManager.GET_META_DATA); } catch (PackageManager.NameNotFoundException e) { Log.w(TAG, "updatable driver package '" + driverPackageName + "' not installed"); return false; } // O drivers are restricted to the sphal linker namespace, so don't try to use // packages unless they declare they're compatible with that restriction. final ApplicationInfo driverAppInfo = driverPackageInfo.applicationInfo; if (driverAppInfo.targetSdkVersion < Build.VERSION_CODES.O) { if (DEBUG) { Log.w(TAG, "updatable driver package is not compatible with O"); } return false; } final String abi = chooseAbi(driverAppInfo); if (abi == null) { if (DEBUG) { // This is the normal case for the pre-installed empty driver package, don't spam if (driverAppInfo.isUpdatedSystemApp()) { Log.w(TAG, "Updatable driver package has no compatible native libraries"); } } return false; } final StringBuilder sb = new StringBuilder(); sb.append(driverAppInfo.nativeLibraryDir) .append(File.pathSeparator); sb.append(driverAppInfo.sourceDir) .append("!/lib/") .append(abi); final String paths = sb.toString(); final String sphalLibraries = getSphalLibraries(context, driverPackageName); Log.v(TAG, "Updatable driver package search path: " + paths + ", required sphal libraries: " + sphalLibraries); setDriverPathAndSphalLibraries(paths, sphalLibraries); if (driverAppInfo.metaData == null) { throw new NullPointerException("apk's meta-data cannot be null"); } String driverBuildTime = driverAppInfo.metaData.getString(METADATA_DRIVER_BUILD_TIME); if (driverBuildTime == null || driverBuildTime.length() <= 1) { Log.w(TAG, "com.android.graphics.driver.build_time is not set"); driverBuildTime = "L0"; } // driver_build_time in the meta-data is in "L" format. e.g. L123456. // Long.parseLong will throw if the meta-data "driver_build_time" is not set properly. setGpuStats(driverPackageName, driverPackageInfo.versionName, driverAppInfo.longVersionCode, Long.parseLong(driverBuildTime.substring(1)), packageName, 0); return true; } private static String chooseAbi(ApplicationInfo ai) { final String isa = VMRuntime.getCurrentInstructionSet(); if (ai.primaryCpuAbi != null && isa.equals(VMRuntime.getInstructionSet(ai.primaryCpuAbi))) { return ai.primaryCpuAbi; } if (ai.secondaryCpuAbi != null && isa.equals(VMRuntime.getInstructionSet(ai.secondaryCpuAbi))) { return ai.secondaryCpuAbi; } return null; } private String getSphalLibraries(Context context, String driverPackageName) { try { final Context driverContext = context.createPackageContext(driverPackageName, Context.CONTEXT_RESTRICTED); final BufferedReader reader = new BufferedReader(new InputStreamReader( driverContext.getAssets().open(UPDATABLE_DRIVER_SPHAL_LIBRARIES_FILENAME))); final ArrayList assetStrings = new ArrayList<>(); for (String assetString; (assetString = reader.readLine()) != null;) { assetStrings.add(assetString); } return String.join(":", assetStrings); } catch (PackageManager.NameNotFoundException e) { if (DEBUG) { Log.w(TAG, "Driver package '" + driverPackageName + "' not installed"); } } catch (IOException e) { if (DEBUG) { Log.w(TAG, "Failed to load '" + UPDATABLE_DRIVER_SPHAL_LIBRARIES_FILENAME + "'"); } } return ""; } private static native boolean isDebuggable(); private static native void setLayerPaths(ClassLoader classLoader, String layerPaths); private static native void setDebugLayers(String layers); private static native void setDebugLayersGLES(String layers); private static native void setDriverPathAndSphalLibraries(String path, String sphalLibraries); private static native void setGpuStats(String driverPackageName, String driverVersionName, long driverVersionCode, long driverBuildTime, String appPackageName, int vulkanVersion); private static native void nativeSetAngleInfo(String path, boolean useNativeDriver, String packageName, String[] features); private static native boolean setInjectLayersPrSetDumpable(); private static native void nativeToggleAngleAsSystemDriver(boolean enabled); /** * Hint for GraphicsEnvironment that an activity is launching on the process. * Then the app process is allowed to send stats to GpuStats module. */ public static native void hintActivityLaunch(); }