Simulating pressing the Home button in Xcode 7 UI Automation

Question

I've got it down to:

XCUIDevice.pressButton(noideawhatgoeshere)

I've tried XCUIDeviceButtonHome, home, Home, 1

How do I simulate pressing the home button in Xcode on iOS?

score 19 · Accepted Answer · edited Nov 11 '19 at 22:30

19

You need to get the device instance first. So to simulate pressing the home button:

XCUIDevice.sharedDevice().pressButton(XCUIDeviceButton.Home)

should work (it does for me on a physical device)

Thanks!

Mazen

Swift 5 Version:

XCUIDevice.shared.press(XCUIDevice.Button.home)

Also, verified it works in the simulator, at least in Xcode 11.2.1 on a simulated "iPad Pro (9.7-inch)" running iPadOS 13.2.2.

edited Nov 11 '19 at 22:30

ggruen

1,980
1
15
14

answered Oct 12 '15 at 17:47

Mazen A

206
1
2

Anyone know of a way to double-press the home button to be able to task-kill the app between tests? – BadmintonCat Aug 01 '17 at 02:51
Swift 3: `XCUIDevice.shared().press(.home)` – mygzi Oct 04 '17 at 15:32
Does something needs to be imported in order to use XCUIDevice (tried to import XCUIDevice)? I'm getting 'Cannot find 'XCUIDevice' in scope'. – anagarD Dec 22 '22 at 19:25

score 12 · Answer 2 · answered Oct 21 '17 at 22:44

12

Swift 4:

XCUIDevice.shared.press(.home)

answered Oct 21 '17 at 22:44

ScottyBlades

12,189
5
77
85

score 3 · Answer 3 · answered Dec 13 '17 at 15:11

3

In Swift version 4.0.2 and 4.0.3:

XCUIDevice.shared().press(XCUIDeviceButton.home)

answered Dec 13 '17 at 15:11

Davide Patti

3,391
2
18
20

score 2 · Answer 4 · edited Feb 13 '21 at 13:40

2

Objective C

    [XCUIDevice.sharedDevice pressButton: XCUIDeviceButtonHome];

There are also XCUIDeviceButtonVolumeUp for volume up button and XCUIDeviceButtonVolumeDown for volume down button.

edited Feb 13 '21 at 13:40

jasondinh

918
7
21

answered Oct 14 '15 at 22:53

user3695947

91
6

score 1 · Answer 5 · answered Sep 29 '15 at 21:28

I know of no way to simulate the home button - this might not be possible. You can sorta brute force it with: [[UIApplication sharedApplication] terminate]; or you can put your app in the background for a specified duration with: UIATarget.localTarget().deactivateAppForDuration(seconds);

(excuses for using objc)

score 1 · Answer 6 · answered Mar 22 '18 at 16:39

1

Now in Swift 4.1:

XCUIDevice.shared.press(XCUIDevice.Button.home)

answered Mar 22 '18 at 16:39

Steve Moser

7,647
5
55
94

Simulating pressing the Home button in Xcode 7 UI Automation

6 Answers6

Linked