iOS input fails in 0.21.34+ when Apple tools resolve past a stale Xcode selection symlink

Đang mở
  • Có gì không ổn?
#4,145 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

@thymikee đang làm issue này rồi.

Từ ngày 1/11/2026.

  • #4146 của @thymikee — đang mở

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
22/100
Loại issue
Lỗi
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
ios, macos, typescript
Lĩnh vực
mobile-dev

Hướng nghiên cứu

Start in packages/platform-apple/src/runner/runner-toolchain-identity.ts, where selectionLinkTarget() throws on a dangling /var/db/xcode_select_link, then read its test at src/runner/tests/runner-toolchain-identity.test.ts lines 68-79, which enforces that assumption. Run that test file to see the current failure. Done means a stale legacy link no longer blocks input when the active developer directory resolves. Open PR #4146 already targets this, so check it before starting.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

agent-device 0.21.35 rejects iOS input on a Mac where Apple's tools successfully resolve the current Xcode, because an obsolete /var/db/xcode_select_link still points at a deleted installation. The same interaction succeeds with 0.21.33 on the unchanged machine.

Environment

  • macOS 27.0.1, build 26A434, Apple Silicon
  • Xcode 27.0, build 27A266a, installed at /Applications/Xcode.app
  • iOS Simulator 27.0; tested on an iPhone 18 Pro simulator
  • Node.js 22.20.0
  • DEVELOPER_DIR is unset
  • Tested versions: 0.21.33 passes, 0.21.35 fails

Toolchain state

The obsolete symlink exists, but its target no longer exists:

/var/db/xcode_select_link -> /Applications/Xcode-16.2.0.16C5032a.app/Contents/Developer

Apple's tools resolve the installed Xcode successfully, including with an empty environment:

$ env -i PATH=/usr/bin:/bin /usr/bin/xcode-select -p
/Applications/Xcode.app/Contents/Developer

$ env -i PATH=/usr/bin:/bin /usr/bin/xcrun --find xcodebuild
/Applications/Xcode.app/Contents/Developer/usr/bin/xcodebuild

$ xcodebuild -version
Xcode 27.0
Build version 27A266a

$ xcrun --sdk iphonesimulator --show-sdk-version
27.0

$ xcrun --sdk iphonesimulator --show-sdk-build-version
24A430

Reproduction

On a Mac with the toolchain state above, use agent-device 0.21.35's MCP server and a booted iOS simulator:

  1. Call open with a named session, platform: "ios", the simulator's udid, and app: "com.apple.Preferences".
  2. Call snapshot with that session and interactiveOnly: true.
  3. Call press on the current snapshot ref for General, with settle: true.

open and snapshot succeed. screenshot also succeeds. press fails before dispatch:

code: COMMAND_FAILED
reason: apple_toolchain_unreadable
file: /var/db/xcode_select_link
detail: dangling selection link
dispatched: no

The error says it could not read the Xcode toolchain versions used for the Apple runner cache key, and suggests checking xcode-select -p or DEVELOPER_DIR. xcode-select -p already reports the working installation above.

Version comparison

With 0.21.33, on the same booted simulator and with no DEVELOPER_DIR override or system configuration changes, I verified:

  • Open Settings and read its accessibility snapshot.
  • Press General and verify that About appears on the resulting screen.
  • Navigate back and close the session.

After pinning Mobile Dev to 0.21.33, I repeated the interaction through its packaged Claude server, including a screenshot and a batch command; all passed without an Xcode override.

Regression source

This comes from #3995, first included in 0.21.34. The published 0.21.34 and 0.21.35 packages contain the new identity reader; 0.21.33 does not. The live failing interaction above was tested on 0.21.35.

selectionLinkTarget() in v0.21.35 throws when the legacy symlink cannot be resolved. Its assumption that a dangling link means Apple cannot resolve a working developer directory does not hold on this machine. The corresponding test explicitly enforces that assumption.

I understand the change avoids stalled xcrun probes on hosted runners. The remaining correctness requirement is that the cache fingerprint identify the same Xcode that Apple's tools actually use. A stale legacy symlink should not block device input when the active developer directory resolves successfully.

Ngôn ngữ chính
TypeScript
Star
5.2k
Fork
359
Merge trung bình
13 giờ 31 phút
Pull request đã merge (30 ngày)
664

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của callstack/agent-device

Tất cả issue của callstack/agent-device

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.