Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: address com.apple.ContactsUI.LimitedAccessPromptView in troubleshooting #2474

Merged
merged 3 commits into from
Sep 19, 2024
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 19 additions & 0 deletions docs/guides/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,6 +49,25 @@ XCUITest driver offers a couple of approaches to handle them:

[`mobile: activeAppInfo`](../reference/execute-methods.md#mobile-activateappinfo) helps to understand what application (bundleId) is considered as active for the XCUITest driver.

## Interact with dialogs managed by `com.apple.ContactsUI.LimitedAccessPromptView`

iOS 18 introduced a new process, named `com.apple.ContactsUI.LimitedAccessPromptView`. See [this issue](https://github.com/appium/appium/issues/20591) for more details.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I will later add another extension to be able to list all active apps

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As of XCUITest driver v7.26.4, the only workaround to interact with the view is below method:

- `defaultActiveApplication` setting in [Settings](../reference/settings.md).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

does activateApp not help in this case?

Copy link
Member Author

@KazuCocoa KazuCocoa Sep 19, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tested. It looks like no. Activating com.apple.ContactsUI.LimitedAccessPromptView brought the bundle id to the front or springboard?, then the running app went to background. It caused home screen only view. This new view was maybe running over the app under test's GUI but not remains on the home screen like system level dialog.

- e.g. With the [Appium Ruby client](https://github.com/appium/ruby_lib_core)
```ruby
# Interacting with the test target
driver.settings.update({defaultActiveApplication: "com.apple.ContactsUI.LimitedAccessPromptView"})
# to accept the alert
driver.find_element("accessibility_id", "Select Contacts").click
driver.settings.update({defaultActiveApplication: "auto"})
# keep interacting with the test target
```

`com.apple.ContactsUI.LimitedAccessPromptView` looks like can include elements available via `com.apple.springboard` thus you could use `com.apple.ContactsUI.LimitedAccessPromptView` instead of `com.apple.springboard` for iOS 18 for now to interact with dialogs manabed either `com.apple.ContactsUI.LimitedAccessPromptView` or `com.apple.springboard`.
eglitise marked this conversation as resolved.
Show resolved Hide resolved


## Leftover Application Data on Real Devices

There might be a situation where application data is present on the real device, even if the
Expand Down
Loading