Maaz Zindani

Loading the index…

↑↓ move↵ openesc close4072 pages

Help for owners

Customers updated their iPhone and now my app misbehaves

Short answer

When a new iOS version breaks an app, the app needs a new build tested against that iOS version. You cannot fix it in the store listing or by asking customers to reinstall. Collect the iOS version and phone model of affected users, then have the app rebuilt and tested before you release a new version.

  • Written for business owners
  • Updated
  • By Maaz Zindani, Senior Software Engineer

Does this sound like your situation?

  • Complaints started right after a new iOS version came out.
  • The app works on older iPhones and breaks on newer ones, or the reverse.
  • Screens look wrong, buttons are hidden or the app will not open.
  • It still works on my own iPhone, which I have not updated.
  • My developer says the app was not changed.

Why does this happen?

  1. A new iOS version changes behaviour

    Apps are built against a specific iOS SDK. When iOS changes how something works, an app built before that change can behave differently, even though its own code did not change.

  2. Each Xcode version carries a matching SDK

    Apple's Xcode page lists the iOS SDK that comes with each Xcode version, and which macOS and deployment targets each Xcode supports. An app that is built with an older Xcode has not been checked against the newest SDK.

  3. Libraries and plugins lag behind

    Cross-platform apps rely on third-party plugins. When Apple releases an update, a plugin may need its own update before the app builds and runs correctly.

  4. The build setup needs updating

    A newer Xcode can change how an app is linked and signed.

  5. Nobody tested before customers updated

    TestFlight lets a developer distribute beta builds to up to 100 internal and 10,000 external testers before App Review, and builds stay testable for up to 90 days.

What can I do about it today?

  1. Collect the exact versionsFrom several affected users: iOS version, iPhone model and app version, plus a screenshot or short screen recording.
  2. Find the patternDoes it break only on one iOS version, or only on one screen size? That narrows the cause.
  3. Do not tell customers to roll back iOSUndoing a phone's update is not something you control, and the fix belongs in the app.
  4. Ask your developer when the app was last builtIf the answer is a long time ago, an update is overdue regardless of this bug.
  5. Do not ship a rushed patch untestedA second broken release makes reviews worse.

When should I bring someone in?

  • The app does not open at all for customers on the new iOS version.
  • Payments, logins or bookings are affected.
  • Nobody on your side has the project or the Apple account needed to build a new version.

How do I handle it?

  1. Recreate it on the same iOS versionI run the app on that iOS version and device size to see exactly what fails.
  2. Update the toolchain and pluginsA current Xcode and updated libraries, one change at a time.
  3. Test with TestFlight firstThe fixed build goes to your own testers before customers.
  4. Release and watchI submit the update. Apple's review time is Apple's, so I cannot promise a date.

The price depends on what I find, so I quote in writing after a short discovery call. Tell me what is happening and I reply within 24 hours.

What do owners ask about this?

Is this my developer's fault?

Not necessarily. New iOS versions change behaviour. It is a maintenance task, but it needs someone to do it.

Can I stop it recurring?

A maintenance routine that tests the app on new iOS versions in TestFlight reduces surprises. I cannot remove them completely.

Will Apple review the fix quickly?

Apple's help explains review status and an expedited review request exists, but Apple decides the timing.

Sources

How was this page made?

I drafted this page with AI assistance from the official documents listed under Sources. Found a mistake? Tell me.

For your developer: the technical fixes

Next step

Want this off your desk?

Send me a few lines on where things stand. I reply within 24 hours.