52

I have this method in one of my Android Activities:

@Override
public boolean onKeyDown(int keyCode, KeyEvent event)
{
    if(keyCode == KeyEvent.KEYCODE_BACK)
    {
        Log.d("Test", "Back button pressed!");
    }
    else if(keyCode == KeyEvent.KEYCODE_HOME)
    {
        Log.d("Test", "Home button pressed!");
    }
    return super.onKeyDown(keyCode, event);
}

But, even though the KEYCODE_HOME is valid, the log method never fires. This works for the back button though. Does anyone know why this is and how to get this to work?

Zoe
  • 27,060
  • 21
  • 118
  • 148
ingh.am
  • 25,981
  • 43
  • 130
  • 177
  • 1
    http://stackoverflow.com/a/8883447/439171 – Italo Borssatto Jun 05 '12 at 17:13
  • @Yvette I agree. However only for the reason. It should probably be closed anyway, as on reflection it's not a great thing to try and detect - and therefore not great for future visitors to SO. There are better ways to stop services (which is what my real question was here), and you cannot override the home button as some of the answers talk about below. – ingh.am Sep 05 '16 at 16:49
  • Use **onTrimMemory()** as suggest from [here](https://stackoverflow.com/a/55129289/14446786) – scr Dec 10 '20 at 08:01

11 Answers11

35

The Home button is a very dangerous button to override and, because of that, Android will not let you override its behavior the same way you do the BACK button.

Take a look at this discussion.

You will notice that the home button seems to be implemented as a intent invocation, so you'll end up having to add an intent category to your activity. Then, any time the user hits home, your app will show up as an option. You should consider what it is you are looking to accomplish with the home button. If its not to replace the default home screen of the device, I would be wary of overloading the HOME button, but it is possible (per discussion in above thread.)

Community
  • 1
  • 1
Nick Campion
  • 10,479
  • 3
  • 44
  • 58
22

It took me almost a month to get through this. Just now I solved this issue. In your activity's onPause() you have to include the following if condition:

    if (this.isFinishing()){
        //Insert your finishing code here
    }

The function isFinishing() returns a boolean. True if your App is actually closing, False if your app is still running but for example the screen turns off.

Hope it helps!

Raphael
  • 229
  • 2
  • 2
  • The code should be if (!this.isFiishing()) { //home button pressed } (just add a "!") – iwind Sep 22 '14 at 03:26
  • 1
    The iwind's comment is correct. More exact: `isFinishing()` will be `false` if **`HOME`** button or **`TABS`** button is pressed or **the screen turns off**. (Will be `true` if `BACK` button is pressed.) – Mir-Ismaili Jan 02 '17 at 13:35
13

The HOME button cannot be intercepted by applications. This is a by-design behavior in Android. The reason is to prevent malicious apps from gaining control over your phone (If the user cannot press back or home, he might never be able to exit the app). The Home button is considered the user's "safe zone" and will always launch the user's configured home app.

The only exception to the above is any app configured as home replacement. Which means it has the following declared in its AndroidManifest.xml for the relevant activity:

<intent-filter>
   <action android:name="android.intent.action.MAIN" />
   <category android:name="android.intent.category.HOME" />
   <category android:name="android.intent.category.DEFAULT" />
</intent-filter>

When pressing the home button, the current home app's activity's onNewIntent will be called.

Lior
  • 7,845
  • 2
  • 34
  • 34
  • Doesn't work. Documentation on `onNewIntent` btw: *"This is called for activities that set launchMode to "singleTop" in their package, or if a client used the Intent.FLAG_ACTIVITY_SINGLE_TOP flag when calling startActivity. In either case, when the activity is re-launched while at the top of the activity stack instead of a new instance of the activity being started, onNewIntent() will be called on the existing instance with the Intent that was used to re-launch it"* – m0skit0 Jan 30 '18 at 10:51
  • Worked for me when used with home replacement app (i.e. custom launcher) I am developing. – dazed Feb 21 '23 at 20:39
9

I found that when I press the button HOME the onStop() method is called.You can use the following piece of code to monitor it:

@Override
    protected void onStop() 
    {
        super.onStop();
        Log.d(tag, "MYonStop is called");
        // insert here your instructions
    }
Basbous
  • 3,927
  • 4
  • 34
  • 62
Aderito Brinca
  • 259
  • 2
  • 2
3

KeyEvent.KEYCODE_HOME can NOT be intercepted.

It would be quite bad if it would be possible.

(Edit): I just see Nicks answer, which is perfectly complete ;)

Mike Mackintosh
  • 13,917
  • 6
  • 60
  • 87
Oliver
  • 1,269
  • 13
  • 21
3

Using BroadcastReceiver

protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // something
    // for home listen
    InnerRecevier innerReceiver = new InnerRecevier();
    IntentFilter intentFilter = new IntentFilter(Intent.ACTION_CLOSE_SYSTEM_DIALOGS);
    registerReceiver(innerReceiver, intentFilter);

}



// for home listen
class InnerRecevier extends BroadcastReceiver {

    final String SYSTEM_DIALOG_REASON_KEY = "reason";
    final String SYSTEM_DIALOG_REASON_HOME_KEY = "homekey";

    @Override
    public void onReceive(Context context, Intent intent) {
        String action = intent.getAction();
        if (Intent.ACTION_CLOSE_SYSTEM_DIALOGS.equals(action)) {
            String reason = intent.getStringExtra(SYSTEM_DIALOG_REASON_KEY);
            if (reason != null) {
                if (reason.equals(SYSTEM_DIALOG_REASON_HOME_KEY)) {
                    // home is Pressed
                }
            }
        }
    }
}
d0ye
  • 1,580
  • 1
  • 15
  • 26
3

I have a simple solution on handling home button press. Here is my code, it can be useful:

public class LifeCycleActivity extends Activity {


boolean activitySwitchFlag = false;

@Override
public boolean onKeyDown(int keyCode, KeyEvent event) 
{
    if(keyCode == KeyEvent.KEYCODE_BACK)
    {
        activitySwitchFlag = true;
        // activity switch stuff..
        return true;
    }
    return false;
}

/** Called when the activity is first created. */
@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.main);
}

@Override 
public void onPause(){
    super.onPause();
    Log.v("TAG", "onPause" );
    if(activitySwitchFlag)
        Log.v("TAG", "activity switch");
    else
        Log.v("TAG", "home button");
    activitySwitchFlag = false;
}

public void gotoNext(View view){
    activitySwitchFlag = true;
    startActivity(new Intent(LifeCycleActivity.this, NextActivity.class));
}

}

As a summary, put a boolean in the activity, when activity switch occurs(startactivity event), set the variable and in onpause event check this variable..

Mike Mackintosh
  • 13,917
  • 6
  • 60
  • 87
barisatbas
  • 570
  • 2
  • 9
  • 22
  • 1
    That's not a bad idea. While it doesn't actually tell you if the home button is pressed you can assume. I guess this method calls when the phone starts ringing? – ingh.am Sep 16 '11 at 19:52
2

use onPause() method to do what you want to do on home button.

Mike Mackintosh
  • 13,917
  • 6
  • 60
  • 87
Jawad Amjad
  • 2,532
  • 2
  • 29
  • 59
1

I also struggled with HOME button for awhile. I wanted to stop/skip a background service (which polls location) when user clicks HOME button.

here is what I implemented as "hack-like" solution;

keep the state of the app on SharedPreferences using boolean value

on each activity

onResume() -> set appactive=true

onPause() -> set appactive=false

and the background service checks the appstate in each loop, skips the action

IF appactive=false

it works well for me, at least not draining the battery anymore, hope this helps....

Yilmaz Guleryuz
  • 9,313
  • 3
  • 32
  • 43
  • 6
    Again, this is only true if your application has a single activity. If you switch to another activity in the same app, you will have set the `appActive` variable to true. – Zoltán Aug 31 '12 at 08:13
0

define the variables in your activity like this:

const val SYSTEM_DIALOG_REASON_KEY = "reason"
const val SYSTEM_DIALOG_REASON_RECENT_APPS = "recentapps"
const val SYSTEM_DIALOG_REASON_HOME_KEY = "homekey"

define your broadcast receiver class like this:

class ServiceActionsReceiver: BroadcastReceiver(){
        override fun onReceive(context: Context?, intent: Intent?) {
            
            val action = intent!!.action
            if (action == Intent.ACTION_CLOSE_SYSTEM_DIALOGS) {
                val reason = intent.getStringExtra(SYSTEM_DIALOG_REASON_KEY)
                if (reason != null) {
                    if (reason == SYSTEM_DIALOG_REASON_HOME_KEY) {
                        //do what you want to do when home pressed
                    } else if (reason == SYSTEM_DIALOG_REASON_RECENT_APPS) {
                        //do what you want to do when recent apps pressed
                    }
                }
            }
        }
    }

register reciver on onCreate method or onResume method like this:

val filter = IntentFilter()
filter.addAction(Intent.ACTION_CLOSE_SYSTEM_DIALOGS)
registerReceiver(receiver, filter)

add receiver in your manifest like this:

<receiver android:name=".ServiceActionsReceiver">
            <intent-filter >
                <actionandroid:name="android.intent.action.CLOSE_SYSTEM_DIALOGS"/>
            </intent-filter>
</receiver>
Asad
  • 1,241
  • 3
  • 19
  • 32
0

https://www.tutorialspoint.com/detect-home-button-press-in-android

  @Override
   protected void onUserLeaveHint() {
      text.setText("Home buton pressed");
      Toast.makeText(MainActivity.this,"Home buton pressed",Toast.LENGTH_LONG).show();
      super.onUserLeaveHint();
   }
ayoub laaziz
  • 1,196
  • 9
  • 12