Help with Python Appium iOS Test Script for Opening Settings and Clicking Buttons

Hi Appium team,

I’m trying to create a Python test script for iOS using Appium. I followed the Quickstart example for Android, but when I adapted it to an emulated iPhone device, I ran into a few issues.

Currently, I want to:

1. Open the iOS Settings app.
2. Click a specific button or section (e.g., "Screen Time").
3. Assert a certain text exists.
4. Understand how to control app launch behavior in Appium:
   4a. Start an app fresh: Launch the app as if it has never been opened before on the device (no cached state, fresh session).
   4b. Attach to an already running app: Connect to the app if it’s already running on the emulator or device, without restarting it.

import unittest
import warnings
from appium import webdriver
from appium.options.ios import XCUITestOptions
from appium.webdriver.common.appiumby import AppiumBy

options = XCUITestOptions()
options.platform_name = "iOS"
options.automation_name = "XCUITest"
options.device_name = "iPhone 15"
options.platform_version = "17.2"
options.bundle_id = "com.apple.Preferences"
options.language = "en"
options.locale = "US"
# options.device_id = "1F4F5697-3E82-4EC9-819A-9478BDE3E598"

appium_server_url = "http://127.0.0.1:4723"

class TestIOSSettings(unittest.TestCase):
    def setUp(self) -> None:
        self.driver = webdriver.Remote(command_executor=appium_server_url, options=options)

    def tearDown(self) -> None:
        if self.driver:
            self.driver.quit()

    def test_open_screen_time(self) -> None:
        el = self.driver.find_element(AppiumBy.IOS_PREDICATE, 'label == "Screen Time"')
        el.click()

if __name__ == "__main__":
    unittest.main()

Problems I encountered:

1. I cannot navigate into Settings reliably; nothing is happening on the emulated iPhone screen.
2. I’m unsure how to launch an app fresh vs attach to an already running app.

Could you provide guidance on:

• The correct way to open system apps like Settings and interact with buttons.
• How to launch an app from scratch or attach to an existing session.

Any tips for using iOS emulators specifically with Python/Appium.

Thanks in advance!

Best regards,
Alex

Comienza con el Appium Python Quickstart enlazado y el script TestIOSSettings proporcionado; después, reproduce el inicio de Settings y la interacción con Screen Time en el iPhone 15 indicado con iOS 17.2. Se considera terminado cuando se haya documentado una guía fiable para abrir Settings, interactuar con sus controles y distinguir entre el inicio nuevo de la aplicación y la conexión a una aplicación existente.