Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Let a script hold a device claim while it runs simctl install or simctl launch itself

Aperta
#3,263 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
38/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
ios, typescript
Ambito
cli, mobile-dev

Direzione di ricerca

Start by reading the CLI implementations of install, boot and shutdown to understand how they take and release transient-exclusive claims, then compare that with the open/close session lifecycle. Decide which of the three proposed approaches best fits the stated requirement; done means a script can hold a claim while its simulator mutation runs, and the claim is released when that work ends without the unwanted session side effects.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Seen in 0.21.15, macOS, iOS simulators.

Problem

Our dev scripts install and relaunch a dev client on an iOS simulator with xcrun simctl install and xcrun simctl launch --terminate-running-process. Before each call, they read the claim file in ~/.agent-device/device-claims/ and refuse when another session holds the device.

Between that check and the simctl call, an agent-device client (an e2e run, or an IDE device panel) can take the claim. The install or relaunch then interrupts that session. The window is short, but a check that only our scripts honor cannot close it. The claim must come from agent-device.

What exists in 0.21.15, and why it does not fit

  • device status|release only inspects or releases claims. No command takes one.
  • install, boot and shutdown take a transient-exclusive claim, but only for their own work. agent-device cannot run our simctl command under that claim.
  • open --session S --platform ios --udid U with no app holds a session claim until close --session S. As a reservation, it has these side effects:
    • it starts a daemon in the state dir;
    • keepHot can start xcodebuild build-for-testing for the runner in the background;
    • on a simulator that is not booted, it boots it and runs open -a Simulator;
    • if the script crashes before close, the claim stays held while the daemon lives.
  • takeover needs a remote lease, so it does not apply to a local simulator.

Proposal (any one is enough)

  1. agent-device exec --platform ios --udid U -- <command...>: take a transient-exclusive claim, run the child, and release the claim when the child exits. The claim owner is the exec process, so a crash of the child or of agent-device frees the claim.
  2. agent-device device claim --udid U and device release --udid U --session S: take a claim whose owner is the calling process (or one with a TTL or heartbeat). No daemon, no boot, no runner prewarm, no session record.
  3. open --claim-only: the current open with no app, but without the boot, open -a Simulator and runner prewarm.

Option 1 fits our use best. The claim lasts exactly as long as the mutation, and nothing leaks.

Current workaround

We read the claim file right before each simctl call. That narrows the window but does not close it.

Related: #2161 (workspace-scoped device pinning).

Lingua principale
TypeScript
Stelle
4.9k
Fork
328
Merge medio
11h 51m
PR unite (30g)
535

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di callstack/agent-device

Tutte le issue di callstack/agent-device

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.