Protocol Handler support

GoogleChromeLabs · Feb 24, 2025 · 530ecfe · 530ecfe
1 parent 9ba50ce
commit 530ecfe
Show file tree

Hide file tree

Showing 4 changed files with 45 additions and 1 deletion.
diff --git a/packages/core/src/lib/TwaManifest.ts b/packages/core/src/lib/TwaManifest.ts
@@ -21,7 +21,7 @@ import {fetchUtils} from './FetchUtils';
 import {findSuitableIcon, generatePackageId, validateNotEmpty} from './util';
 import Color = require('color');
 import {ConsoleLog} from './Log';
-import {ShareTarget, WebManifestIcon, WebManifestJson} from './types/WebManifest';
+import {ProtocolHandler, ShareTarget, WebManifestIcon, WebManifestJson} from './types/WebManifest';
 import {ShortcutInfo} from './ShortcutInfo';
 import {AppsFlyerConfig} from './features/AppsFlyerFeature';
 import {LocationDelegationConfig} from './features/LocationDelegationFeature';
@@ -169,6 +169,7 @@ export class TwaManifest {
   serviceAccountJsonFile: string | undefined;
   additionalTrustedOrigins: string[];
   retainedBundles: number[];
+  protocolHandlers?: ProtocolHandler[];
 
   private static log = new ConsoleLog('twa-manifest');
 
@@ -219,6 +220,7 @@ export class TwaManifest {
     this.serviceAccountJsonFile = data.serviceAccountJsonFile;
     this.additionalTrustedOrigins = data.additionalTrustedOrigins || [];
     this.retainedBundles = data.retainedBundles || [];
+    this.protocolHandlers = data.protocolHandlers;
   }
 
   /**
@@ -343,6 +345,7 @@ export class TwaManifest {
       shareTarget: TwaManifest.verifyShareTarget(webManifestUrl, webManifest.share_target),
       orientation: asOrientation(webManifest.orientation) || DEFAULT_ORIENTATION,
       fullScopeUrl: fullScopeUrl.toString(),
+      protocolHandlers: webManifest.protocol_handlers,
     });
     return twaManifest;
   }
@@ -479,6 +482,12 @@ export class TwaManifest {
         oldTwaManifestJson.iconUrl!, webManifest.icons!, 'monochrome', MIN_NOTIFICATION_ICON_SIZE,
         webManifestUrl);
 
+    let mergedProtocolHandlers = new Map<String, String>();
+    oldTwaManifest.protocolHandlers?.forEach(handler => mergedProtocolHandlers.set(handler.protocol, handler.url));
+    if (!(fieldsToIgnore.includes('protocol_handlers'))) {
+      webManifest.protocol_handlers?.forEach(handler => mergedProtocolHandlers.set(handler.protocol, handler.url));
+    }
+
     const fullStartUrl: URL = new URL(webManifest['start_url'] || '/', webManifestUrl);
     const fullScopeUrl: URL = new URL(webManifest['scope'] || '.', webManifestUrl);
 
@@ -503,6 +512,7 @@ export class TwaManifest {
       maskableIconUrl: maskableIconUrl || oldTwaManifestJson.maskableIconUrl,
       monochromeIconUrl: monochromeIconUrl || oldTwaManifestJson.monochromeIconUrl,
       shortcuts: shortcuts,
+      protocolHandlers: Array.from(mergedProtocolHandlers.entries()).map(([protocol, url]) => ({protocol, url} as ProtocolHandler))
     });
     return twaManifest;
   }
@@ -558,6 +568,7 @@ export interface TwaManifestJson {
   serviceAccountJsonFile?: string;
   additionalTrustedOrigins?: string[];
   retainedBundles?: number[];
+  protocolHandlers?: ProtocolHandler[];
 }
 
 export interface SigningKeyInfo {

diff --git a/packages/core/src/lib/types/WebManifest.ts b/packages/core/src/lib/types/WebManifest.ts
@@ -30,6 +30,11 @@ export interface WebManifestShortcutJson {
   icons?: Array<WebManifestIcon>;
 }
 
+export interface ProtocolHandler {
+  protocol: string;
+  url: string;
+}
+
 type WebManifestDisplayMode = 'browser' | 'minimal-ui' | 'standalone' | 'fullscreen';
 
 export type OrientationLock = 'any' | 'natural' | 'landscape'| 'portrait' | 'portrait-primary'|
@@ -67,4 +72,5 @@ export interface WebManifestJson {
   shortcuts?: Array<WebManifestShortcutJson>;
   share_target?: ShareTarget;
   orientation?: OrientationLock;
+  protocol_handlers?: Array<ProtocolHandler>;
 }
diff --git a/packages/core/template_project/app/src/main/AndroidManifest.xml b/packages/core/template_project/app/src/main/AndroidManifest.xml
@@ -207,6 +207,15 @@
                         android:host="<%= additionalOrigin %>"/>
                 </intent-filter>
             <% } %>
+
+            <% for (const protocolHandler of protocolHandlers) { %>
+                <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="<%= protocolHandler.protocol %>" />
+                </intent-filter>
+            <% } %>    
         </activity>
 
         <activity android:name="com.google.androidbrowserhelper.trusted.FocusActivity" />

diff --git a/packages/core/template_project/app/src/main/java/LauncherActivity.java b/packages/core/template_project/app/src/main/java/LauncherActivity.java
@@ -20,6 +20,9 @@
 import android.os.Build;
 import android.os.Bundle;
 
+import java.util.HashMap;
+import java.util.Map;
+
 <% for(const imp of launcherActivity.imports) { %>
     import <%= imp %>;
 <% } %>
@@ -48,6 +51,12 @@ protected void onCreate(Bundle savedInstanceState) {
         }
     }
 
+    private final Map<String, String> mProtocolHandlers = new HashMap<String, String>() {{
+        <% for(const protocol of protocolHandlers) { %>
+            put("<%= protocol.protocol %>", "<%= protocol.url %>");
+        <% } %>
+    }};
+
     @Override
     protected Uri getLaunchingUrl() {
         // Get the original launch Url.
@@ -57,6 +66,15 @@ protected Uri getLaunchingUrl() {
             <%= code %>
         <% } %>
 
+        /* Protocol Handler support */
+        String scheme = uri.getScheme();
+        if (mProtocolHandlers.containsKey(scheme)) {
+            String target = uri.toString().replace(scheme + "://", "");
+            String format = mProtocolHandlers.get(scheme);
+            String baseUrl = getString(R.string.launchUrl);
+            return Uri.parse(baseUrl + String.format(format, target));
+        }
+
         return uri;
     }
 }