Mobile apps are four dimensional

13 November 2022

This is a sketch . It might be rough, incomplete or without context.

Once a mobile app version is installed by a user, there is no guarantee that they will ever update it, so that version of the app could be ‘in the wild’ forever, i.e. every version over time continues to exist (which is what I mean be four dimensional). See Why don’t users update apps?. This means you have to be very careful with integrations to anything outside of the shipped app package. You can’t rely on the current state of your code base to tell you how all the live versions of the app are interacting with these interfaces.

This has the following consequences:

  1. You need to take care when changing service APIs used by the app. You need to make sure they are backwards compatible.
  2. Remote config becomes difficult to manage. Changing a remote config value changes it in all version of the app. Some examples:
    1. You can’t develop a feature behind a remote config flag, then turn it on when it is completed. It would be turned on for all versions, including those where the feature was incomplete.
    2. If a feature relies on the value of a remove config value to be ‘on’, you can’t remove that remote config item in the future, without turning the feature ‘off’ for users of older versions.
    3. You can’t use a simple boolean flag across multiple versions of the app. If you have to switch a feature off in one version because it didn’t work, you can’t switch it on in a future version when it’s fixed without switching it back on for the older versions.
  3. Just because something isn’t referenced in the code, it doesn’t mean that it isn’t live in the app - see https://adambennett.dev/2021/06/a-cautionary-tale/
  4. You need to add analytics, kill switches, force upgrade mechanisms etc before the version you want to analyse / kill / force upgrade. This requires either very good forethought, or time travel. It’s easy to think ‘let’s add analytics to see how the old version is used’. But users on the old version won’t update and get your analytics. (If they did update, you wouldn’t need the analytics).

How to mitigate:

  1. Use analytics to track how many people are using different versions of an app, and use specific analytics to track how specific integrations are being used.
  2. Create clear documentation that describes the versions when integrations were added or removed. For example in a legacy remote config value, you could include the app versions it was used by in the description, e.g. `WARNING used up to v1.0.32, do not remove until no-one is using this version.
  3. Use versioning on you APIs. This allows you to make changes, whilst still being backwards compatible.
  4. Add a force upgrade mechanism, that can force users to upgrade if they are below a minimum app version (use with care, this is terrible UX, because it adds friction to using your app, and not all users can update - Why don’t users update apps?)
  5. Limit remote config to ‘emergency use’ only - e.g. if you are releasing a risky feature, you might want a way to switch it on and off remotely. You could:
    1. Create a flag that defaults to the feature being on.
    2. Release the feature.
    3. If all goes well, remove the flag and the feature will continue to be switched on.
    4. If it goes badly, use the emergency switch to switch it off. From this point on, you’ll need to keep the original remote config flag until that version is no longer used. You’ll also need to add a different flag to switch it on in the new version.
  6. Use more complex logic in feature flags, e.g. by specifying which versions should be switched on / off. Note this needs to exist up front, and can’t be retrofitted to older versions.

See Decommission APIs Used by Old Versions of Your Mobile App, https://adambennett.dev/2021/06/a-cautionary-tale/