iOS Deep Link问题：已安装APP无法唤起，始终跳转App Store求解决

Hey there! Let’s figure out why your deep link keeps redirecting to the App Store instead of opening your installed app, and fix it step by step.

The root problem is that your app hasn’t properly registered its deep link scheme with iOS. Without this registration, the system doesn’t know your app should handle the link, so it falls back to the App Store automatically. We’ll fix this with configuration adjustments and code tweaks.

Step 1: Configure Deep Link Scheme in info.plist #

This is the most critical step—iOS needs to recognize which custom URL schemes belong to your app. Here’s how to set it up:

1. Open your Xcode project and locate the Info.plist file.
2. Add a URL types array (if it doesn’t exist already):
   • Each entry in the array is a dictionary with two key-value pairs:
     • URL Schemes: An array containing your deep link’s scheme (e.g., if your link is myapp://product/123, use myapp here).
     • Role: Set this to Editor (either role works, but this is standard).
3. Alternatively, you can edit the plist source directly to add this XML snippet:

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>your-custom-scheme</string> <!-- Replace with your actual scheme -->
        </array>
        <key>CFBundleURLName</key>
        <string>com.yourcompany.yourapp</string> <!-- Replace with your app's Bundle ID -->
    </dict>
</array>

⚠️ Important: The scheme name is case-sensitive—make sure it matches exactly what’s in your deep link.

Step 2: Handle Deep Link Navigation in Your App #

Once the scheme is registered, your app needs to respond when it’s opened via the deep link. The implementation varies slightly based on iOS version:

For iOS 13+ (SceneDelegate-based Apps) #

Add this method to your SceneDelegate.swift:

func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let deepLinkURL = URLContexts.first?.url else { return }
    processDeepLink(deepLinkURL)
}

private func processDeepLink(_ url: URL) {
    // Example: Parse the link to navigate to the correct screen
    let components = URLComponents(url: url, resolvingAgainstBaseURL: false)
    if components?.path == "/product/123" {
        // Navigate to product detail screen
    }
}

For iOS 12 and Below (AppDelegate-based Apps) #

Add this method to your AppDelegate.swift:

func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
    processDeepLink(url)
    return true
}

private func processDeepLink(_ url: URL) {
    // Same parsing/navigation logic as above
}

Step 3: Optimize the Link Trigger Logic (Web/External Calls) #

If your deep link is triggered from a webpage, use a "try to open app first, fallback to App Store on timeout" logic to avoid immediate App Store redirects. Here’s a sample JavaScript implementation:

function openAppOrRedirectToStore() {
    const deepLink = "your-custom-scheme://path/to/content";
    const appStoreURL = "https://apps.apple.com/your-region/app/your-app-name/idyour-app-id";
    
    const startTime = Date.now();
    const timeout = 1500; // 1.5 seconds—adjust based on device/browser behavior
    
    // Attempt to open the deep link
    window.location.href = deepLink;
    
    // Check if the app opened; if not, redirect to App Store
    setTimeout(() => {
        if (Date.now() - startTime < timeout + 100) {
            window.location.href = appStoreURL;
        }
    }, timeout);
}

Step 4: Test the Setup #

1. Install your app on a test device or simulator.
2. Open Safari and enter your deep link (e.g., your-custom-scheme://path/to/content)—it should open your app directly.
3. If it still fails, double-check:
   • The scheme in info.plist matches your deep link exactly (no typos, correct case).
   • You’re using the right delegate method for your iOS version.
   • The timeout in your web logic isn’t too short (give the system time to detect the installed app).

内容的提问来源于stack exchange，提问作者user9261559