IOS-specific Actions and Options

[Seray]

RunCommand

Runs the given command on the agent.

Options: Repeat, WhenFails, Screenshot, WaitBefore, WaitAfter, OcrLang, CaseSensitive, Retry, Timeout, UseShell, UntilVisible, UntilInvisible

Example: RunCommand “open” “com.google.ios.youtube”
Description: Opens the 'Youtube’ on IOS…

Example: RunCommand “close” “com.google.ios.youtube”
Description: Closes the ‘Youtube’ on IOS.

Example: RunCommand “open” “com.apple.weather”
Description: Opens the ‘Weather’ on IOS.

Example: 1. RunCommand “open” “com.facebook.Facebook”
Description: Opens the ‘Facebook’ on IOS.

How to find the bundle ID of an application installed on IOS device?

Bundle IDs are unique identifiers for macOS or iOS applications. Every application has a bundle ID, and this ID is used to identify and manage the application. We use the bundle ID to open the application in the RunCommand action, as shown in the given examples.

Steps to follow:

• Ensure that your device is connected to your Mac via USB.
• Open the Console app on your Mac.
• Launch the app on your iOS device for which you want to find the bundle ID.
• In the Console app, search for either the name of the app or the phrase "Asked to bootstrap a new process with identity" in the log entries.
• Find the bundle ID of the application in the search results.

com.google.ios.youtube
This bundle ID belongs to Google’s YouTube application for iOS. Google’s applications usually start with “com.google” followed by the platform (in this case, “ios”) and the name of the application.

com.apple.weather
This bundle ID belongs to Apple’s Weather application. Apple’s own applications usually start with “com.apple” followed by the name of the application.

com.facebook.Facebook
com.facebook.Facebook is the bundle ID for the Facebook app on iOS and macOS devices. The format of this bundle ID indicates that it is developed by Facebook (now Meta), and the specific app is the Facebook application.

Example: In cases where an element cannot be found, we can use XPath to click as shown in the following example. We automate a YouTube search by clicking the YouTube icon using XPath, using a parameterized search icon, and entering the given search text into the search field via XPath.

• RunCommand “xpath-click” “//XCUIElementTypeIcon[@name=“YouTube”]”
• Click Image {SearchIcon}
• RunCommand “xpath-click” “(//XCUIElementTypeButton[@name=“Search YouTube”])[1]”
• RunCommand “xpath-write” “//XCUIElementTypeOther[@name=“id.yoodle.logo”]/XCUIElementTypeOther&&testing”
• Click Text “Search”
• RunCommand “close” “com.google.ios.youtube”

Description:

• Click on the YouTube icon using the XPath //XCUIElementTypeIcon[@name="YouTube"].
• Click on the {SearchIcon} parameter.
• Click on the “Search YouTube” button using the XPath (//XCUIElementTypeButton[@name="Search YouTube"])[1]
• Write the term “testing” in the search input field identified by the XPath //XCUIElementTypeOther[@name="id.yoodle.logo"]/XCUIElementTypeOther.
• Click the text “Search”
• Close the YouTube

How to find the XPath of elements on an iOS device connected to your Mac?

By following these steps, you can find the XPath of elements on an iOS device connected to your Mac using Appium for automated testing.

Using Appium for Automated Testing

1. Install Appium:

• Download and install Appium from Appium’s official website.

2. Start Appium Server:

• Open the Appium Desktop and start the server.

3. Connect to the iOS Device:

• Ensure your iOS device is connected and recognized by your Mac.
• In Appium, set up a new session with the desired capabilities for your iOS device.

4. Use Appium Inspector:

How do I install Appium Inspector?

• Launch the Appium Inspector. It allows you to interact with your app and inspect elements.
• Select an element in your app to view its XPath and other attributes.

Example Desired Capabilities for Appium:

{
“platformName”: “iOS”,
“platformVersion”: “14.4”, // Replace with your iOS version
“deviceName”: “iPhone 12”, // Replace with your device name
“app”: “/path/to/your.app”, // Replace with the path to your app
“automationName”: “XCUITest”
}

Finding XPath in Appium Inspector

1. Launch Appium Inspector: With the server running, open the Appium Inspector.
2. Start a Session: Use the desired capabilities to start a session.
3. Inspect Elements: Click on elements in the Appium Inspector to see their XPath and other attributes.