This repo manages apple-app-site-association and assetlinks.json files,
needed for iOS Handoff/Universal Links/Shared Web Credentials to work.
These are deployed to cloudflare worker via deploy prs.
For more information see:
- Handoff programming guide
- Universal Links programming guide
- Shared Web Credentials programming guide
- Android App Links Guide
Install dependencies:
yarn install
Run the local worker server:
yarn dev
In the output you should see the url of the running server.
You can fetch the configs at:
<YOUR-LOCAL-SERVER-URL>/.well-known/apple-app-site-association
and:
<YOUR-LOCAL-SERVER-URL>/.well-known/assetlinks.json
You can verify config correctness here.
When making changes, you should do so in the worker.ts file in the appleAppSiteAssociation for apple and the assetLinks object for android.
A deploy pr should open automatically, merging this will result in deploying the worker to production which will in turn update the files everywhere.
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.