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

Commit 929f4d14 authored by Rupesh Bansal's avatar Rupesh Bansal
Browse files

A system API to shutdown the device 

Bug: 365055195
Flag: com.android.server.power.feature.flags.shutdown_system_api
Test: Exempted because it is not feasible to test the shutdown behaviour
Change-Id: I90e7414e21a0fc054062a9a9f5e2a31bcf5fd0e5
parent bde539fd

core/api/system-current.txt

+1 −0
Original line number Diff line number Diff line
@@ -11604,6 +11604,7 @@ package android.os { 
    method @RequiresPermission(anyOf={android.Manifest.permission.MANAGE_LOW_POWER_STANDBY, android.Manifest.permission.DEVICE_POWER}) public void setLowPowerStandbyEnabled(boolean);

    method @RequiresPermission(anyOf={android.Manifest.permission.MANAGE_LOW_POWER_STANDBY, android.Manifest.permission.DEVICE_POWER}) public void setLowPowerStandbyPolicy(@Nullable android.os.PowerManager.LowPowerStandbyPolicy);

    method @RequiresPermission(anyOf={android.Manifest.permission.DEVICE_POWER, android.Manifest.permission.POWER_SAVER}) public boolean setPowerSaveModeEnabled(boolean);

    method @FlaggedApi("com.android.server.power.feature.flags.shutdown_system_api") @RequiresPermission(android.Manifest.permission.REBOOT) public void shutdown(boolean);

    method @RequiresPermission(android.Manifest.permission.WRITE_DREAM_STATE) public void suppressAmbientDisplay(@NonNull String, boolean);

    method @RequiresPermission(anyOf={android.Manifest.permission.DEVICE_POWER, android.Manifest.permission.USER_ACTIVITY}) public void userActivity(long, int, int);

    field @RequiresPermission(android.Manifest.permission.MANAGE_LOW_POWER_STANDBY) public static final String ACTION_LOW_POWER_STANDBY_PORTS_CHANGED = "android.os.action.LOW_POWER_STANDBY_PORTS_CHANGED";

core/java/android/os/IPowerManager.aidl

+2 −0
Original line number Diff line number Diff line
@@ -120,6 +120,8 @@ interface IPowerManager 
    @UnsupportedAppUsage

    void reboot(boolean confirm, String reason, boolean wait);

    void rebootSafeMode(boolean confirm, boolean wait);



    @JavaPassthrough(annotation="@android.annotation.RequiresPermission(android.Manifest.permission.REBOOT)")

    void shutdown(boolean confirm, String reason, boolean wait);

    void crash(String message);

    int getLastShutdownReason();

core/java/android/os/PowerManager.java

+29 −0
Original line number Diff line number Diff line
@@ -18,6 +18,8 @@ package android.os; 


import static android.app.PropertyInvalidatedCache.MODULE_SYSTEM;



import static com.android.server.power.feature.flags.Flags.FLAG_SHUTDOWN_SYSTEM_API;



import android.Manifest.permission;

import android.annotation.CallbackExecutor;

import android.annotation.CurrentTimeMillisLong;
@@ -989,6 +991,13 @@ public final class PowerManager { 
     */

    public static final String SHUTDOWN_LOW_BATTERY = "battery";



    /**

     * The value to pass as the 'reason' argument to android_reboot() when the device shutdown is

     * being requested by a call to {@link PowerManager#shutdown(boolean)}

     * @hide

     */

    public static final String SHUTDOWN_SERVICE_CALL = "service";



    /**

     * @hide

     */
@@ -2766,6 +2775,26 @@ public final class PowerManager { 
        }

    }



    /**

     * Shuts down the Android device.

     *

     * @param wait If true, this call waits for the shutdown to complete and does not return.

     *             Clients can use this to catch exceptions that might be thrown while shutting

     *             down the device

     *

     * @hide

     */

    @SystemApi

    @FlaggedApi(FLAG_SHUTDOWN_SYSTEM_API)

    @RequiresPermission(android.Manifest.permission.REBOOT)

    public void shutdown(boolean wait) {

        try {

            mService.shutdown(false, SHUTDOWN_SERVICE_CALL, wait);

        } catch (RemoteException e) {

            throw e.rethrowFromSystemServer();

        }

    }



    /**

     * This function checks if the device has implemented Sustained Performance

     * Mode. This needs to be checked only once and is constant for a particular

services/core/java/com/android/server/power/PowerManagerService.java

+1 −0
Original line number Diff line number Diff line
@@ -6999,6 +6999,7 @@ public final class PowerManagerService extends SystemService 
         * @param confirm If true, shows a shutdown confirmation dialog.

         * @param wait If true, this call waits for the shutdown to complete and does not return.

         */

        @RequiresPermission(android.Manifest.permission.REBOOT)

        @Override // Binder call

        public void shutdown(boolean confirm, String reason, boolean wait) {

            mContext.enforceCallingOrSelfPermission(android.Manifest.permission.REBOOT, null);

services/core/java/com/android/server/power/feature/power_flags.aconfig

+7 −0
Original line number Diff line number Diff line
@@ -84,3 +84,10 @@ flag { 
    description: "Feature flag to enable a new Perfetto data source for tracing app wakelocks."

    bug: "400774865"

}



flag {

    name: "shutdown_system_api"

    namespace: "power"

    description: "Feature flag to have a system API which shuts down the device."

    bug: "365055195"

}