Android Smart WebView

A clean and modern, open-source solution for building advanced hybrid Android apps.

Documentation • Discussions • Issues

Android Smart WebView is a robust foundation for converting any website into a feature-rich mobile application, with a plugin system for extending native functionality without touching core code. Targets Android 17 (API 37), minimum Android 7.0 (API 24).

Features

• Plugin Architecture — Self-registering, modular plugins. Enable or disable any plugin from swv.properties without modifying Java source.
• File Uploads & Camera — Full support for <input type="file">, direct camera capture, and multi-file selection.
• Push Notifications — Firebase Cloud Messaging integration (requires google-services.json).
• Google Analytics — Built-in GTAG support, configured via swv.properties.
• Location Services — On-demand GPS with a 10-second timeout and automatic fallback to cached coordinates.
• Content Sharing — Receive and handle shared content from other apps via Android's share sheet.
• Downloads & Printing — File downloads via DownloadManager, web printing via native print services.
• Edge-to-Edge Display — Full support for Android's edge-to-edge window mode with proper inset handling.
• Predictive Back — Android 13+ predictive back gesture support via OnBackInvokedCallback.
• Network Awareness — NetworkInfoPlugin exposes the current connection state to your web app.
• Custom UI Modes — Fullscreen immersive layout or a standard navigation drawer layout.
• Secure by Default — SSL verification, screenshot blocking, and third-party cookie controls, all configurable.

Quick Start

1. Clone the repository:

   git clone https://github.com/mgks/Android-SmartWebView.git

2. Open in Android Studio — File > Open > Select the cloned project folder
3. Configure swv.properties — Open app/src/main/assets/swv.properties and set app.url to your website's URL.
4. Add google-services.json (optional) — If using Firebase, place the file from the Firebase console into the app/ directory.
5. Build & Run — Build > Clean Project, then Build > Rebuild Project.

Configuration

All configuration lives in app/src/main/assets/swv.properties:

Property	Purpose
app.url	The main URL the WebView loads
offline.url	Local page shown when there is no internet connection
feature.*	Boolean toggles for uploads, camera, zoom, pull-to-refresh, etc.
plugins.enabled	Comma-separated list of active plugins
security.*	SSL, screenshot blocking, third-party cookie controls
permissions.on.launch	Permission groups requested at startup (LOCATION, NOTIFICATIONS)

Included Plugins

All plugins are free and included. Activate them by adding their name to plugins.enabled in swv.properties.

Plugin	Description
AdMobPlugin	Google AdMob banner, interstitial, and rewarded ads
BiometricPlugin	Fingerprint or face unlock at launch or on demand
QRScannerPlugin	Native QR and barcode scanning via device camera
ImageCompressionPlugin	Compress images before upload to reduce bandwidth
JSInterfacePlugin	Two-way bridge between JavaScript and native Android code
LocationPlugin	On-demand GPS with cache fallback via GeolocationCachePlugin
GeolocationCachePlugin	Stores and serves cached location coordinates
NetworkInfoPlugin	Exposes current connection state to your web app
DialogPlugin	Native alert and confirmation dialogs from JavaScript
ToastPlugin	Short, non-blocking native toast notifications
RatingPlugin	In-app review prompt based on configurable usage triggers
ClipboardPlugin	Read from and write to the device clipboard
SharePlugin	Native share sheet integration

Standalone Libraries

The core components of Smart WebView are also available as independent libraries for any Android project.

Library	Description
Biometric Gate	Lifecycle-aware lock screen for any Activity
File Handler	File uploads and camera captures for WebViews
JS Bridge	Promise-based communication between Kotlin and JS
Print Helper	One-line printing for Android WebViews
FCM Sync	Sync Firebase push tokens to WebView cookies

Code Overview

File	Purpose
swv.properties	All runtime and build configuration
SWVContext.java	Loads config, holds shared app state
MainActivity.java	WebView setup, lifecycle, and feature wiring
PluginInterface.java & PluginManager.java	Plugin architecture contracts and registry
Playground.java	Plugin API keys and development configuration
plugins/	Full source for all included plugins

Contributing

Found a bug or have an idea? Open an issue or submit a pull request. Questions or want to show what you've built? Join the discussion.

License

Distributed under the MIT License. See LICENSE for more information.

{ github.com/mgks }