Troubleshooting

⚠️
Deprecation Notice
You are viewing the SDK v3 docs. SDK v3 will be deprecated on September 30, 2026.
We recommend upgrading to SDK v4 — the latest and actively maintained version. To get started, follow the SDK v3 → v4 Migration Guide.

Using WebView from more than one process at once

Issue

RuntimeException: Using WebView from more than one process at once.

Cause

Typically, occurs when multiple processes within 1 app use web views.

TBLClassicUnit extends WebView, and must be treated as a WebView in this regard.

Resolution

Make sure that your app uses 1 process to manage all web views.

In the words of the WebView JavaDoc:

Most applications should simply ensure that all components of the app that rely on WebView are in the same proces, to avoid needing multiple data directories.

Alternative Resolution

If you are unable to implement the above resolution, then you can try the following:

Make sure that each process in your app calls the WebView.setDataDirectorySuffix(<Process-specific data directory>) method, before creating or using a WebView instance.

TBLClassicUnit extends WebView, and must be treated as a WebView in this regard.

Resources

WebView JavaDoc