Hey there! Let's figure out why that WhatsApp deep link isn't firing up in your Android hybrid app. I've tackled similar issues plenty of times, so here are the key checks and fixes to try out:

1. Verify AndroidManifest.xml Configuration #

Hybrid apps (like Cordova, React Native, or Flutter) need proper intent filters in the AndroidManifest to let the system know they can handle external links like whatsapp://. Here's what to add:

• Inside your app's main <activity> tag in AndroidManifest.xml, include this intent filter:

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="whatsapp" />
</intent-filter>

For Android 11+, you also need to declare that your app interacts with WhatsApp using the <queries> tag (add this outside the <application> tag):

<queries>
    <package android:name="com.whatsapp" />
</queries>

This tells the OS your app needs to communicate with WhatsApp, which is required for strict privacy restrictions in newer Android versions.

2. Fix Your Deep Link Format #

Your current link whatsapp://send?text= might be missing critical pieces:

• Don't leave the text parameter empty: WhatsApp won't respond if there's no content to share. Make sure you URL-encode your text, e.g., whatsapp://send?text=Hello%20from%20my%20app
• Handle special characters: Spaces, ampersands, and question marks need to be URL-encoded to avoid parsing errors. Use tools like encodeURIComponent() in JavaScript to properly format your text.
• Optional: Add a recipient: If you want to open a specific chat, include the phone parameter with an international number (no spaces or hyphens), e.g., whatsapp://send?phone=+1234567890&text=Hi%20there!

3. Adjust Your Hybrid Framework's Link Handling #

Different frameworks have specific ways to trigger system-level deep links (instead of trying to open them in the app's WebView):

• Cordova: Install cordova-plugin-inappbrowser and use window.open('whatsapp://send?text=...', '_system') instead of a regular <a> tag. This tells Cordova to pass the link to the OS instead of loading it internally.
• React Native: Use the built-in Linking module:

  import { Linking } from 'react-native';
  
  // First check if WhatsApp is available
  const canOpenWhatsApp = await Linking.canOpenURL('whatsapp://');
  if (canOpenWhatsApp) {
    await Linking.openURL('whatsapp://send?text=Your%20encoded%20text');
  } else {
    // Show error prompt to install WhatsApp
  }
  

• Flutter: Use the url_launcher package with LaunchMode.externalApplication to force the OS to handle the link:

  import 'package:url_launcher/url_launcher.dart';
  
  final Uri whatsappUri = Uri.parse('whatsapp://send?text=Your%20encoded%20text');
  if (await canLaunchUrl(whatsappUri)) {
    await launchUrl(whatsappUri, mode: LaunchMode.externalApplication);
  } else {
    // Prompt user to install WhatsApp
  }
  

4. Check Device-Specific Issues #

• Ensure WhatsApp is installed: If the app isn't on the device, the system has nothing to launch. Always add a check for this and prompt users to install if needed.
• Reset default app settings: Sometimes another app (like a browser) might be set as the default handler for whatsapp:// links. Have users go to their device's Settings > Apps > Default Apps > Opening links, find the app that's handling WhatsApp links, and clear its defaults.
• Test on multiple devices: Some older Android versions might have different behavior, so test on a range of devices if possible.

5. Validate the Link Separately #

First, test the link directly in your device's browser (like Chrome). If whatsapp://send?text=Test works there, the issue is definitely in your app's configuration, not the link itself. If it doesn't work in the browser, double-check the link format or confirm WhatsApp is installed correctly.

内容的提问来源于stack exchange，提问作者Pablo D.