القائمة
iOS Settings (com.apple.Preferences). Apple's first-party device-config app - open About, set language/region, toggle airplane mode, set dark mode, etc.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | ios-settings |
| description | iOS Settings (com.apple.Preferences). Apple's first-party device-config app - open About, set language/region, toggle airplane mode, set dark mode, etc. |
Bundle id: com.apple.Preferences. Apple's first-party settings app, available on every iOS device and simulator.
| Function | Purpose |
|---|---|
settings_open_root() | Launch Settings, return root ui_tree |
settings_open_section(name) | Open a top-level row by name |
settings_open_about() | General → About, return full ExecutionResult |
settings_get_ios_version() | Read iOS version off About screen |
settings_get_device_name() | Read device name off About screen |
settings_set_dark_mode(on) | Display & Brightness → Light/Dark |
settings_toggle_airplane_mode(on) | Root list → Airplane Mode switch |
The first three are validated on iPhone 17 Pro / iOS 26.4. The toggles below them follow the same pattern but expect to refine predicates on first run.
text="General" is ambiguousTwo elements match on the Settings root: a small label at top (likely a search-keyword surface, ~y=73) and the actual cell row (~y=224). Both are XCUIElementTypeStaticText, neither is the cell.
tap(Predicate(text="General")) # AMBIGUOUS_MATCH - two candidates
tap(Predicate(text="General", index=1)) # picks the second match (the cell row)
This pattern repeats for other top-level sections (Display & Brightness, Privacy & Security, etc.). Default to index=1 for any top-level row tap, or wrap via settings_open_section(name).
text="About" matches a Cell and a child ButtonOn the General submenu, the About row has both a XCUIElementTypeCell wrapping the text and an inner XCUIElementTypeButton carrying the same text. Tapping by plain text → AMBIGUOUS_MATCH.
tap(Predicate(text="About")) # ambiguous
tap(Predicate(text="About", type="cell")) # picks the row
The About screen renders combined-label rows as a single Button text + two child StaticTexts:
[18] Button "iOS Version, 26.4" #SW_VERSION_SPECIFIER
[19] StaticText "iOS Version" (the label)
[20] StaticText "26.4" (the value)
The Button's .text ("iOS Version, 26.4") is the most stable extraction surface - neither StaticText alone is unique enough. Use a regex on the button text:
re.search(r'Button "iOS Version,\s*([^"]+)"', ui_tree)
The Name row uses the cell directly (Cell "Name, iPhone" #NAME_CELL_ID) and includes a stable accessibility id - prefer that anchor over text matching.
Worth pinning predicates to when available - these survive locale changes and Apple's wording tweaks:
| Row | Accessibility id |
|---|---|
| Name | NAME_CELL_ID |
| iOS Version | SW_VERSION_SPECIFIER |
Use via Predicate(accessibility_id="SW_VERSION_SPECIFIER") instead of the text-based regex when possible.
open_app(SETTINGS_BUNDLE_ID) first. Do not assume the user left Settings on a particular pane - Apple may have collapsed/restored state, the device may have rebooted, etc.wait_for(stable=True, timeout_ms=3000) after each navigation. Settings has subtle animations that hold input briefly.accessibility_id (where present) or bounds_hint for locale-resilient flows.text="Settings" as a generic anchor - appears in the nav bar of every sub-screen and also as the App's name in Spotlight. Never matches what you think.navigate("back") on iOS. iOS lacks a hardware back. Tap the BackButton predicate from the navigation bar instead, or rely on the < chevron in the top-left.open_app alone is not deterministic. iOS preserves the last-visited Settings pane across app activations. Every flow function in this skill calls open_app(SETTINGS_BUNDLE_ID, fresh=True) followed by wait_for(stable=True, ...). The cost is ~200ms; the win is reproducibility across sessions.