docs(links): add instructions on setting up Xcode for dynamic links with custom domains (#3923)

Co-authored-by: Mike Hardy <github@mikehardy.net>
This commit is contained in:
Daniel Montano
2020-07-10 12:18:03 -04:00
committed by GitHub
parent 1f2227198e
commit 659324090d

View File

@@ -70,6 +70,31 @@ To setup Dynamic Links on iOS, it is a **prerequisite** that you have an Apple d
![iOS dynamic link fifth step](https://images.prismic.io/invertase/cb029ba6-ad40-494e-a3f6-2aacaff494d1_Screenshot+2020-05-07+at+10.16.16.png?auto=compress,format)
### Dynamic Links With Custom Domains
If you have set up a [custom domain](https://firebase.google.com/docs/dynamic-links/custom-domains) for your Firebase project, you must add the dynamic link URL prefix into your iOS project's `info.plist` file by using the `FirebaseDynamicLinksCustomDomains` key. You can add multiple URLs as well.
Example:
```xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>FirebaseDynamicLinksCustomDomains</key>
<array>
<string>https://custom.domain.io/bla</string>
<string>https://custom.domain.io/bla2</string>
</array>
...other settings
</dict>
</plist>
```
If you don't add this, the dynamic link will invoke your app, but you cannot retrieve any deep link data you may need within your app, as the deep link will be completely ignored.
## iOS Testing Your Dynamic Link
To test your dynamic link, you will need to use a real device as it will not work on a simulator.