GPSLarpHelp

My iPhone is missing a file iOS needs first

GPSLarp stops before it reaches your phone and says "Your iPhone is missing a support file iOS needs first." Or the setup check shows a card headed "Your iPhone needs one more file from Apple" with an Install button under it.

Press Install. The file is Apple's, it comes from Apple, and GPSLarp asks Apple for it and offers it to the phone — which is why the card has a button rather than instructions. It needs an internet connection. It does not need a restart, and it does not need your Mac's administrator password.

Two things to know before you press it

This needs GPSLarp 1.4.0 or later. In 1.3.0 and 1.3.1 the part of the app that performs the mount cannot load at all, so the button cannot do anything in those versions — and the message it gives ("could not load the component it uses to talk to iPhones… reinstalling it is the fix") sends you to reinstall, which reproduces it exactly. If you are on one of those, update first. GPSLarp shows its version in the window.

GPSLarp runs on your computer, not on your iPhone — your phone connects to it over Wi-Fi or USB. Open this page on your computer to download it.

This page describes what the app attempts, not an outcome it can promise you. Whether a disk image ends up mounted depends on your phone, its exact iOS build and what Apple currently publishes for it. If it does not work, that is worth telling us about rather than assuming you did it wrong.

01What the file actually is

It is called a Developer Disk Image, and it is a small package of developer-side services that Apple publishes for each iOS build. Until one is mounted, the phone simply does not offer the services GPSLarp drives — the same ones Xcode uses. Not "refuses them": does not advertise them at all, which is why the failure reads as the app talking to a phone that is present and unhelpful.

Two properties of it are worth knowing, because both surprise people:

02Why it comes back after a restart

The image is mounted for the session. Restart the iPhone and it is gone, and the next thing that needs it has to mount it again. That is iOS's design rather than anything failing.

It is also the answer to the most confusing version of this problem: you set a location yesterday, restarted the phone overnight, changed nothing at all, and this morning GPSLarp says a support file is missing. Nothing broke. The restart cleared the mount, exactly as it always does.

So this is not a one-off setup step

Developer Mode is a switch you flip once and it stays on. This is not that. It is closer to something the app takes on at the start of a session, and the reason you ever see it is that the app tells you rather than acting silently — the file comes from Apple over your connection and is offered to your phone, which is not something to do behind somebody's back.

03Let GPSLarp try it

01Check this Mac is online

The file is downloaded from Apple during this step. A Mac with no connection cannot complete it, and neither can one sitting behind a Wi-Fi login page it has not been through yet.

02Leave the iPhone plugged in and unlocked

The mount goes to the phone over the connection you already have, so the phone has to be reachable and unlocked while it happens. If it is not, the app reports the lock or the pairing rather than this — see GPSLarp can't find my iPhone.

03Press Install and wait

The button is on the card itself, labelled Install it now. The download from Apple is the slow part. Nothing on the phone is restarted and nothing is added as an app.

Screenshot pending — GPSLarp's "Your iPhone needs one more file from Apple" card
The Install button is on this card. It is the whole procedure — there is nothing to do on the phone.

04Run the check again

The setup check re-runs and moves on to the next thing it looks at. If it still reports the same file, go to If that did not work below.

04What this message tells you about Developer Mode

Something useful, and it saves people an afternoon: the check for this file runs after the check for Developer Mode. A phone with Developer Mode switched off is stopped by the earlier check and never reaches this one.

So if you are looking at this message, Developer Mode is already on. You do not need to go and check it, and you should not go and toggle it — turning it off restarts the phone, which clears the mount you are trying to create. If you have not been through that switch at all yet, it is on Developer Mode isn't showing on my iPhone.