https://github.com/mgks/android-smartwebview
A simple use webview integrated w/ native features to help build advanced hybrid applications.
https://github.com/mgks/android-smartwebview
analytics android android-studio camera-api chrome firebase java location-tracker plugins-api print-preview pwa webview
Last synced: 11 days ago
JSON representation
A simple use webview integrated w/ native features to help build advanced hybrid applications.
- Host: GitHub
- URL: https://github.com/mgks/android-smartwebview
- Owner: mgks
- License: mit
- Created: 2017-02-10T10:59:02.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2025-05-11T12:20:26.000Z (10 months ago)
- Last Synced: 2025-05-11T13:27:34.680Z (10 months ago)
- Topics: analytics, android, android-studio, camera-api, chrome, firebase, java, location-tracker, plugins-api, print-preview, pwa, webview
- Language: Java
- Homepage: https://mgks.dev/smart-webview
- Size: 9.55 MB
- Stars: 587
- Watchers: 42
- Forks: 284
- Open Issues: 85
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
Android Smart WebView
A clean and modern, open-source solution for building advanced hybrid android apps.
Documentation •
Discussions •
Issues
**Android Smart WebView** provides a robust foundation for converting any website into a feature-rich mobile application, complete with a powerful plugin system for extending native functionality.
## Features
* **Plugin Architecture:** Extend app functionality with self-registering, modular plugins.
* **File Uploads & Camera Access:** Full support for ``, including direct camera capture.
* **Push Notifications:** Integrated with Firebase Cloud Messaging (requires `google-services.json`).
* **Google Analytics:** Built-in support for usage tracking (configure GTAG ID in `swv.properties`).
* **Custom UI Modes:** Choose between a fullscreen immersive layout or a standard drawer navigation layout.
* **Location Services:** Access device GPS for location-aware web applications.
* **Content Sharing:** Natively receive and handle content shared from other apps.
* **Downloads & Printing:** Handle file downloads and print web content using native services.
* **Modern & Secure:** Built with up-to-date libraries, security best practices, and highly configurable via `swv.properties`.
## Quick Start
1. **Clone the repository:**
```sh
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`.
* Change `app.url` to your website's URL and adjust other settings as needed. This is the main configuration file for the app.
4. **Add `google-services.json` (Optional):**
* If you plan to use Firebase services (like FCM for push notifications), place your `google-services.json` file from the Firebase console into the `app/` directory.
5. **Build & Run:**
* `Build > Clean Project` then `Build > Rebuild Project`.
## Basic Configuration
All primary configuration is done within `app/src/main/assets/swv.properties`:
* **Main Application URL:**
* Set `app.url` to your web application's address.
* `offline.url` (`file:///android_asset/web/offline.html`) is used if no internet is detected.
* **Feature Toggles:**
* Enable or disable core features (file uploads, camera access, location services, pull-to-refresh, etc.) by modifying the `feature.*` boolean properties.
* **Permissions:**
* Review and adjust permissions in `AndroidManifest.xml` based on the features you enable. For example, `CAMERA` for camera uploads, `ACCESS_FINE_LOCATION` for GPS.
* **Plugin Configuration:**
* Plugin-specific behavior (like AdMob IDs or Biometric Auth on launch) is configured in `Playground.java`. This allows you to change settings without modifying the plugin source code itself.
## Included Plugins
Smart WebView now includes all plugins for free, providing a comprehensive toolkit to build powerful hybrid apps out of the box.
* **AdMob:** Integrate Google AdMob banner, interstitial, and rewarded ads.
* **Biometric Authentication:** Secure your app with fingerprint or face unlock.
* **QR & Barcode Reader:** Natively scan QR codes and barcodes using the device camera.
* **Image Compression:** Automatically compress images before uploading to save bandwidth and improve performance.
* **JS Interface:** A powerful two-way bridge for seamless communication between your web app's JavaScript and native Android code.
* **Location:** On-demand access to the device's GPS location.
* **Native Dialogs:** Display native alert and confirmation dialogs from your JavaScript.
* **Toast Messages:** Show short, non-blocking native toast notifications.
* **In-App Review:** Prompt users to rate your app on the Google Play Store based on usage triggers.
## Standalone Libraries
We are modularizing the best parts of Smart WebView into lightweight, standalone libraries that you can use in **any** Android project (Native or Hybrid).
| Library | Description |
| :--- | :--- |
| **[Biometric Gate](https://github.com/mgks/android-biometric-gate)** | Secure, lifecycle-aware lock screen for any Activity. |
| **[File Handler](https://github.com/mgks/android-webview-file-handler)** | Painless file uploads & camera captures for WebViews. |
| **[JS Bridge](https://github.com/mgks/android-webview-js-bridge)** | Two-way, Promise-based communication between Kotlin & JS. |
| **[Print Helper](https://github.com/mgks/android-webview-print-helper)** | One-line printing for Android WebViews. |
| **[FCM Sync](https://github.com/mgks/android-webview-fcm-sync)** | Sync Firebase Push Tokens to WebView Cookies. |
## Further Information
The best way to understand the project in depth is to explore the source code:
* **`app/src/main/assets/swv.properties`**: Contains all global configurations.
* **`SWVContext.java`**: The central class that loads the configuration and holds app state.
* **`MainActivity.java`**: The main entry point that handles WebView setup and integrates core features.
* **`PluginInterface.java` & `PluginManager.java`**: Key components of the plugin architecture.
* **`Playground.java`**: The central place for configuring and testing plugins.
* The `plugins/` directory: Contains the full source code for all included plugins.
## Contributing & Community
* Found a bug or have an idea? [Open an issue](https://github.com/mgks/Android-SmartWebView/issues) or [create a pull request](https://github.com/mgks/Android-SmartWebView/pulls).
* Have questions or want to share what you've built? [Join the discussion](https://github.com/mgks/Android-SmartWebView/discussions).
## License
Distributed under the MIT License. See `LICENSE` for more information.
> **{ github.com/mgks }**
>
>  