This tiny app does nothing but serve the apple-app-site-association
file,
needed for iOS Handoff/Universal Links/Shared Web Credentials to work, in the
required way.
For more information see:
- Handoff programming guide
- Universal Links programming guide
- Shared Web Credentials programming guide
This app is meant to be used inside other apps. As such, the file serving is
mounted at /
, which means that the apps using this app should mount it at
/apple-app-site-association
.
Once mounted, you should be able to verify it’s correctness here.
When making changes, you should do so in the apple-app-site-association.json
file.
After changes to the apple-app-site-association.json
file have been merged, you'll need to update the three places that depend on it which include force and artsy-wwwify. To update the package in force and artsy-wwwify run the command yarn add @artsy/artsy-eigen-web-association@latest
in those repositories and check that in. See This PR as an example
Apple caches the apple-app-site-association file on app install. If you're having trouble clearing the apple-app-site-association file cache on your device, try updating the app or turn Universal Linking off (and on again). While it's not known how often the cache is updated, it does appear to periodically between installs and updates. More details about how Apple caches this file can be found on this Stack Overflow answer.