Files
faceclaw/app/apps/evenhub/webview.ts
T
2026-09-27 16:33:43 -07:00

126 lines
5.2 KiB
TypeScript

/**
* Constructs the Android WebView that runs one EvenHub app and attaches it to
* the persistent keep-alive host (FaceclawEvenHubWebViewHost), decoupled from
* any phone Page. The WebView is created at launch and lives until the app's
* glasses window closes — it renders the app to the glasses whether or not the
* phone is currently showing it (see the host for the off-screen-render trick).
*
* A raw WebView subclass (FaceclawEvenHubWebView, not the NativeScript
* component) is used so we fully own the WebViewClient (offline asset serving
* from a fake per-app origin plus document-start injection of the
* flutter_inappwebview bridge shim) and so the page keeps running JS while the
* host app is backgrounded (see FaceclawEvenHubWebView / the host).
*
* A session with a remoteUrl (the Developer app's "Load app from URL") skips
* the offline serving entirely and loads that URL from the network; the shim
* is registered as a document-start script instead of being spliced into the
* served HTML.
*/
import { Application, Utils } from "@nativescript/core";
import { EVENHUB_BRIDGE_INJECT_SCRIPT, buildFaceclawExtensionsScript, type EvenHubSession } from "./session";
import { FACECLAW_VERSION } from "../../version";
declare const android: any;
declare const com: any;
export type EvenHubWebView = {
evaluateJs: (js: string) => void;
destroy: () => void;
showOnPhone: () => void;
hideOnPhone: () => void;
/** The native android.webkit.WebView, for the host. */
native: unknown;
};
/** A distinct (fake, intercepted) https origin per app isolates web storage. */
function originHost(session: EvenHubSession): string {
const safe = session.manifest.packageId.toLowerCase().replace(/[^a-z0-9.-]/g, "-");
return `${safe}.evenhub.invalid`;
}
/**
* The allowed-origin rule for a remote app's document-start script: the
* loaded URL's own origin, so the shim isn't handed to third-party frames.
*/
function originRule(url: string): string {
const match = /^(https?:\/\/[^/?#]+)/i.exec(url);
return match ? match[1]! : "*";
}
/**
* Build the app's WebView, wire it to the session, attach it to the keep-alive
* host, and start loading. Must run on the main thread.
*/
export function createEvenHubWebView(session: EvenHubSession): EvenHubWebView {
const activity = Application.android?.foregroundActivity ?? Application.android?.startActivity;
const context = activity ?? Utils.android.getApplicationContext();
// A mutable wrapper, so the host can re-point the WebView at a recreated
// activity (see FaceclawEvenHubWebViewHost).
const webView = new com.faceclaw.app.FaceclawEvenHubWebView(new android.content.MutableContextWrapper(context));
const settings = webView.getSettings();
settings.setJavaScriptEnabled(true);
settings.setDomStorageEnabled(true);
settings.setAllowFileAccess(false);
settings.setMediaPlaybackRequiresUserGesture(false);
const listener = new com.faceclaw.app.FaceclawEvenHubListener({
onEvenAppMessage: (handlerName: string, argsJson: string, callId: number) => {
session.handleBridgeCall(String(handlerName), String(argsJson), Number(callId));
},
onPageFinished: () => {
session.webViewLoaded();
},
});
const remoteUrl = session.remoteUrl;
// Remote apps load from their own server, so nothing is intercepted and the
// fake per-app origin is unused.
const host = remoteUrl ? "" : originHost(session);
// Stock bridge shim first, then the Faceclaw extensions global (both at
// document-start, before any app JS).
const injectScript = EVENHUB_BRIDGE_INJECT_SCRIPT + buildFaceclawExtensionsScript(`Faceclaw/${FACECLAW_VERSION}`);
const documentStartInstalled = remoteUrl
? com.faceclaw.app.FaceclawEvenHubDocumentStart.install(webView, injectScript, originRule(remoteUrl)) === true
: false;
webView.setWebViewClient(
new com.faceclaw.app.FaceclawEvenHubWebViewClient(
session.distDir,
host,
injectScript,
// onPageStarted injection is the fallback when the document-start API
// is unavailable; packaged apps get the shim spliced into their HTML.
!!remoteUrl && !documentStartInstalled,
listener,
),
);
webView.addJavascriptInterface(new com.faceclaw.app.FaceclawEvenHubJsBridge(listener), "__faceclawEvenHub");
// Surface the app's console in logcat (tag FaceclawEvenHubConsole).
webView.setWebChromeClient(new com.faceclaw.app.FaceclawEvenHubChromeClient());
const nativeHost = com.faceclaw.app.FaceclawEvenHubWebViewHost.getInstance();
nativeHost.attach(activity, webView);
webView.loadUrl(remoteUrl || `https://${host}/${session.manifest.entrypoint}`);
return {
native: webView,
evaluateJs: (js: string) => {
try {
webView.evaluateJavascript(js, null);
} catch (error) {
console.warn(`evenhub evaluateJs failed: ${error}`);
}
},
destroy: () => {
try {
nativeHost.detach(webView);
} catch (error) {
console.warn(`evenhub webview destroy failed: ${error}`);
}
},
showOnPhone: () =>
nativeHost.showOnPhone(Application.android?.foregroundActivity ?? Application.android?.startActivity ?? null, webView),
hideOnPhone: () => nativeHost.hideOnPhone(),
};
}