Conditions and Specifications When Seamless App Launch via Universal Links Fails

**Description: ** We have implemented a process to launch a native app from a browser (Safari) via universal links. However, under certain conditions, the app does not launch seamlessly, and an error page is displayed in the browser. In such cases, a button to open the app appears at the top of the error page, and pressing this button successfully opens the app. The error page is a blank white page with only the following error message displayed: "NoSuchKeyThe specified key does not exist." We want to confirm the detailed specifications and conditions of the behavior where seamless transition via universal links fails. If there are means to suppress or control the occurrence of this issue, please let us know.

Configuration:

  • OS: iOS 18.1
  • Device: iPad 9th generation, 10th generation

**Reproduction Steps: ** When attempting to launch the app via a universal link, a pop-up appears asking "Do you want to allow this page to open <app>?" If 'Cancel' is pressed in this pop-up, the issue occurs the next time the app is launched via a universal link. However, we have also confirmed that this issue can occur due to operations other than this one, and we have not been able to pinpoint the conditions under which it occurs. Therefore, we would like to confirm the detailed specifications and conditions leading to the occurrence of this issue.

Thanks for the post, can you provide more information including the applink, AASA file link and configuration?

Based on the error message "NoSuchKeyThe specified key does not exist", it seems like there's an issue with the data or configuration being passed through the Universal Link to your app. Here are some possible reasons for this error and troubleshooting steps:

  • Invalid or Missing Link Parameters:
    • Ensure that the Universal Links you are using are correctly formatted and include all the necessary parameters required by your app to handle the link.
    • Check if the expected key is missing from the link parameters.
  • Data Validation in the App:
    • Review the code in your app that handles Universal Links.
    • Make sure you are performing proper data validation when receiving the link parameters.
    • The "NoSuchKey" error might indicate that your app is expecting a specific key that is not present in the link data.
  • Provisioning Profile and Associated Domains:
    • Double-check that your provisioning profile is correctly set up and includes the associated domains for your Universal Links.
    • Make sure the TXT record on your domain server is still valid and points to the correct team identifier.

Please refer to the troubleshooting guide for further assistance. However, it appears that the issue may be parameter-based. If you could provide the link to the application causing the problem, along with the AASA file, I may be able to provide more specific guidance.

https://developer.apple.com/documentation/technotes/tn3155-debugging-universal-links

Albert Pascual
  Worldwide Developer Relations.

Conditions and Specifications When Seamless App Launch via Universal Links Fails
 
 
Q