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

Commit 6e5bd3f9 authored by Dianne Hackborn's avatar Dianne Hackborn
Browse files

Add documentation for MIN notification interaction with fg services. 

Don't do this, you won't get what you want.

Test: built

Change-Id: I57ae93ced2b9ad563197c00ad8d94f7b492dff0c
parent 3072aa76

core/java/android/app/NotificationManager.java

+6 −1
Original line number Diff line number Diff line
@@ -204,7 +204,12 @@ public class NotificationManager { 
    public static final int IMPORTANCE_NONE = 0;



    /**

     * Min notification importance: only shows in the shade, below the fold.

     * Min notification importance: only shows in the shade, below the fold.  This should

     * not be used with {@link Service#startForeground(int, Notification) Service.startForeground}

     * since a foreground service is supposed to be something the user cares about so it does

     * not make semantic sense to mark its notification as minimum importance.  If you do this

     * as of Android version {@link android.os.Build.VERSION_CODES#O}, the system will show

     * a higher-priority notification about your app running in the background.

     */

    public static final int IMPORTANCE_MIN = 1;