17 | You are currently offline. Some features below work without an internet connection.
18 |Offline Mode
19 |
31 |
39 |
40 | 🎨 Theme
32 |Switch between light and dark themes. The initial theme is based on your system setting.
33 |
34 |
35 |
36 |
37 |
38 |
41 |
49 |
50 | 🖼️ File Upload (Offline Test)
42 |Select an image. Previews are generated by local JavaScript and do not require a connection.
43 | 48 |
51 |
58 |
59 | 📍 GPS Location
52 |Request device location. This uses the device's GPS and works offline.
53 | 56 |Location will appear here...
57 |
60 |
65 |
66 | 🔔 Native Actions
61 |Trigger native device functionality directly from the web.
62 | Send Test Notification 63 | Print This Page 64 |
67 |
78 |
79 | 🧩 More Features You Can Use
68 |-
69 |
- 🗂️ File uploads with camera & gallery picker 70 |
- 🧭 URL whitelisting / blocking 71 |
- 🎛️ Fullscreen, orientation & zoom controls 72 |
- 🔐 HTTP auth, headers & POST support 73 |
- 🖥️ Custom error pages 74 |
- 🔗 Deeplink handling 75 |
26 | Preview Native Features Available in Smart WebView
27 |
31 |
39 |
40 | 🎨 Theme
32 |Switch between light and dark themes. The initial theme is based on your system setting.
33 |
34 |
35 |
36 |
37 |
38 |
41 |
53 |
54 | 🖼️ File Handling
42 |Select multiple images and videos. Previews are shown for images.
43 | 48 | 52 |
55 |
62 |
63 | 📍 GPS Location
56 |Request device location. Coordinates are fetched via native code and sent to the web page.
57 | 60 | 61 |
64 |
69 |
70 | 🔔 Native Interactions
65 |Trigger native device functionality directly from the web.
66 | Send Test Notification 67 | Print This Page 68 |
71 |
77 |
78 | ⭐ Included Plugins
72 |
73 |
76 | All advanced plugins (AdMob, Biometric, QR Scanner, etc.) are now open-source and included for free!
74 |Enable "Playground Mode" in swv.properties and click the wheel icon (bottom-right) to test them instantly.
79 |
88 |
89 | 💖 Support the Project
80 |Like Smart WebView? Sponsor it to help ship more features, faster.
81 | 82 | Sponsor on GitHub 83 | 84 | 85 | Smart WebView Documentation 86 | 87 |
90 |
101 |
102 | 🧩 More Features You Can Use
91 |-
92 |
- 🗂️ File uploads with camera & gallery picker 93 |
- 🧭 URL whitelisting / blocking 94 |
- 🎛️ Fullscreen, orientation & zoom controls 95 |
- 🔐 HTTP auth, headers & POST support 96 |
- 🖥️ Custom error pages 97 |
- 🔗 Deeplink handling 98 |
Longitude: " + long.toFixed(6); 57 | } else { 58 | locElement.innerHTML = "Could not retrieve location. Please ensure GPS is enabled and permissions are granted."; 59 | } 60 | } 61 | }; 62 | 63 | // Theme switcher logic 64 | const themeSwitcher = document.getElementById('theme-switcher'); 65 | if (themeSwitcher) { 66 | themeSwitcher.addEventListener('click', (event) => { 67 | if (event.target.tagName === 'BUTTON') { 68 | const theme = event.target.dataset.theme; 69 | setTheme(theme); 70 | } 71 | }); 72 | } 73 | const savedTheme = localStorage.getItem('swv-theme'); 74 | if (savedTheme && savedTheme !== 'system') { 75 | setTheme(savedTheme); 76 | } else { 77 | setTheme(nativeThemePreference, true); 78 | } 79 | }); 80 | 81 | function fetchLocation() { 82 | const locElement = document.querySelector('.fetch-loc') || document.querySelector('.fetch-loc-area'); 83 | if (locElement) { 84 | locElement.innerHTML = "
Fetching location from device...
";
85 | }
86 | // Call the new, non-conflicting object name
87 | if (window.SWVLocation) {
88 | window.SWVLocation.getCurrentPosition(function(lat, lng, error) {
89 | // In offline.html, updateLocationDisplay is global.
90 | // In docs/script.js, this logic is inside fetchLocation.
91 | // We'll make it robust for both.
92 | const displayDiv = document.querySelector('.fetch-loc') || document.querySelector('.fetch-loc-area');
93 | if (error) {
94 | displayDiv.innerHTML = "Error: " + error + "
";
95 | return;
96 | }
97 | if (lat && lng) {
98 | displayDiv.innerHTML = "Latitude: " + lat.toFixed(6) + "
Longitude: " + lng.toFixed(6) + "
";
99 | }
100 | });
101 | } else {
102 | alert("Location feature is not available.");
103 | }
104 | }
105 |
106 | function applyInitialTheme(nativeTheme) {
107 | if (nativeTheme) {
108 | nativeThemePreference = nativeTheme;
109 | }
110 | }
111 |
112 | function setTheme(theme, isSystem = false) {
113 | const body = document.body;
114 | const themeSwitcher = document.getElementById('theme-switcher');
115 | let activeTheme = theme;
116 | let buttonToActivate = theme;
117 |
118 | if (theme === 'system') {
119 | localStorage.removeItem('swv-theme');
120 | activeTheme = nativeThemePreference;
121 | isSystem = true;
122 | buttonToActivate = 'system';
123 | } else {
124 | localStorage.setItem('swv-theme', theme);
125 | }
126 |
127 | if (activeTheme === 'dark') {
128 | body.classList.add('dark-mode');
129 | } else {
130 | body.classList.remove('dark-mode');
131 | }
132 |
133 | if (themeSwitcher) {
134 | themeSwitcher.querySelectorAll('button').forEach(btn => btn.classList.remove('active'));
135 | const activeButton = themeSwitcher.querySelector(`[data-theme="${buttonToActivate}"]`);
136 | if (activeButton) activeButton.classList.add('active');
137 | }
138 | if (window.AndroidInterface && typeof window.AndroidInterface.setNativeTheme === 'function') {
139 | window.AndroidInterface.setNativeTheme(theme);
140 | }
141 | }
--------------------------------------------------------------------------------
/app/src/main/assets/swv.properties:
--------------------------------------------------------------------------------
1 | # ===================================================================
2 | # Smart WebView v8 - Main Configuration File
3 | #
4 | # This is the central place to configure your app's behavior.
5 | # Simply edit the values below and rebuild your project.
6 | # ===================================================================
7 |
8 | # ===========================================
9 | # ANDROID BUILD CONFIGURATION
10 | # These values are read by Gradle at build time.
11 | # ===========================================
12 | # build.application.id is reused for both namespace and applicationId.
13 | build.application.id=mgks.os.swv
14 | build.version.code=8
15 | build.version.name=8.0.1
16 |
17 | # --- SDK Versions ---
18 | # NOTE: Changing these requires a Gradle Sync in Android Studio.
19 | # It's recommended to keep these updated to modern standards.
20 | # build.sdk.compile will be reused for both compileSdk and targetSdk version.
21 | build.sdk.compile=36
22 | build.sdk.min=24
23 |
24 | # ===========================================
25 | # APP CONTEXT CONFIGURATION
26 | # These values are read by the SWVContext during app runtime.
27 | # ===========================================
28 | # --- Debug & Development ---
29 | # Enable verbose logging and other debug features. MUST be false for production.
30 | debug.mode=true
31 |
32 | # --- URL Configuration ---
33 | # The main URL your app will load.
34 | # Example: https://your-website.com
35 | # Example: file:///android_asset/index.html
36 | app.url=https://mgks.github.io/Android-SmartWebView/
37 |
38 | # The local HTML file to show when the app is offline.
39 | offline.url=file:///android_asset/web/offline.html
40 |
41 | # The base URL for the search feature (used in Drawer Layout).
42 | search.url=https://www.google.com/search?q=
43 |
44 | # A list of external domains that should still open inside the app's WebView.
45 | # Comma-separated, no spaces. Example: domain1.com,sub.domain2.com
46 | external.url.exception.list=mgks.dev,mgks.github.io
47 |
48 |
49 | # --- Feature Flags (true/false) ---
50 | # Enable file uploads from a web form ().
51 | feature.uploads=true
52 |
53 | # Allow users to capture photos/videos directly from the camera for uploads.
54 | feature.camera.uploads=true
55 |
56 | # Allow selecting multiple files for upload.
57 | feature.multiple.uploads=true
58 |
59 | # Enable injection of a custom stylesheet. The stylesheet must be placed at `app/src/main/assets/web/custom.css`.
60 | feature.custom.css=false
61 |
62 | # Allow users to copy and paste text within the WebView.
63 | feature.copy.paste=true
64 |
65 | # Enable the pull-to-refresh gesture.
66 | feature.pull.refresh=false
67 |
68 | # Show a progress bar at the bottom during page loads.
69 | feature.progress.bar=false
70 |
71 | # Allow users to pinch-to-zoom in the WebView.
72 | feature.zoom=false
73 |
74 | # Allow the WebView to save form data and use autofill.
75 | feature.save.form=false
76 |
77 | # Open external links (not in the exception list) in an external browser/tab.
78 | feature.open.external.urls=true
79 |
80 | # If opening external URLs, use modern Chrome Custom Tabs.
81 | feature.chrome.tabs=true
82 |
83 | # Exit the app instead of navigating back in WebView history. Default is false.
84 | behavior.back.exits=false
85 |
86 | # Show a confirmation dialog before exiting the app on back press.
87 | feature.exit.dialog=true
88 |
89 |
90 | # --- Permissions ---
91 | # Comma-separated list of permission groups to request on app launch.
92 | # The order here determines the order of the request dialogs.
93 | # Available groups: LOCATION, NOTIFICATIONS, STORAGE
94 | permissions.on.launch=NOTIFICATIONS,LOCATION
95 |
96 |
97 | # --- Security ---
98 | # Verify SSL certificates for HTTPS connections. Set to false only for development with self-signed certs.
99 | security.verify.ssl=true
100 | # Block screenshots, screen recording, and content visibility in the "recents" screen.
101 | # Default is false. Set to true to enforce for the entire app session.
102 | security.block.screenshots=false
103 | # Allow the WebView to accept third-party cookies. Required for some captcha (like Google reCAPTCHA) and social login providers.
104 | # Default is false. Set to true to enable.
105 | security.accept.thirdparty.cookies=false
106 |
107 | # --- UI & Theme ---
108 | # Set the default device orientation. 0=Unspecified, 1=Portrait, 2=Landscape
109 | ui.orientation=0
110 |
111 | # Set the main app layout. 0=Fullscreen, 1=Drawer Layout
112 | ui.layout=0
113 |
114 | # Show the header/toolbar when ui.layout is 1
115 | ui.drawer.header=true
116 |
117 | # Keep the system splash screen visible until the first page loads.
118 | # If false, a welcome screen inside the app will show during loading.
119 | ui.splash.extend=true
120 |
121 | # --- User Agent ---
122 | # Append a custom string to the end of the default User Agent.
123 | agent.postfix.enabled=true
124 | agent.postfix.value=SWVAndroid
125 |
126 | # Completely replace the User Agent with a custom string.
127 | agent.override.enabled=false
128 | agent.override.value=Mozilla/5.0 (Linux; Android 6.0; Nexus 5 Build/MRA58N) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.115 Mobile Safari/537.36
129 |
130 |
131 | # --- Analytics ---
132 | # Your Google Analytics Measurement ID (e.g., "G-XXXXXXXXXX"). Leave blank to disable.
133 | analytics.gtag.id=G-7XXC1C7CRQ
134 |
135 |
136 | # --- Plugins & Permissions ---
137 | # Comma-separated list of plugins to enable.
138 | # Core Plugins: RatingPlugin, LocationPlugin, DialogPlugin
139 | # Premium Plugins: AdMobPlugin, JSInterfacePlugin, ToastPlugin, QRScannerPlugin, BiometricPlugin, ImageCompressionPlugin
140 | plugins.enabled=RatingPlugin,LocationPlugin,DialogPlugin,AdMobPlugin,JSInterfacePlugin,ToastPlugin,QRScannerPlugin,BiometricPlugin,ImageCompressionPlugin
141 |
142 | # Enable the Playground floating UI for testing plugins. Set to false for production.
143 | plugins.playground.enabled=true
144 |
145 | # --- Plugins Configuration ---
146 | # RatingsPlugin
147 | # Only active if plugins.enabled has RatingPlugin enabled.
148 | rating.install.days=3
149 | rating.launch.times=10
150 | rating.remind.interval=2
151 |
152 | # BiometricPlugin
153 | # Only active if plugins.enabled has BiometricPlugin enabled.
154 | biometric.trigger.launch=false
--------------------------------------------------------------------------------
/app/src/main/java/mgks/os/swv/PermissionManager.java:
--------------------------------------------------------------------------------
1 | package mgks.os.swv;
2 |
3 | /*
4 | Smart WebView v8
5 | https://github.com/mgks/Android-SmartWebView
6 |
7 | A modern, open-source WebView wrapper for building advanced hybrid Android apps.
8 | Native features, modular plugins, and full customisation—built for developers.
9 |
10 | - Documentation: https://mgks.github.io/Android-SmartWebView/documentation
11 | - Plugins: https://mgks.github.io/Android-SmartWebView/documentation/plugins
12 | - Discussions: https://github.com/mgks/Android-SmartWebView/discussions
13 | - Sponsor the Project: https://github.com/sponsors/mgks
14 |
15 | MIT License — https://opensource.org/licenses/MIT
16 |
17 | Mentioning Smart WebView in your project helps others find it and keeps the dev loop alive.
18 | */
19 |
20 | import android.Manifest;
21 | import android.app.Activity;
22 | import android.content.pm.PackageManager;
23 | import android.os.Build;
24 | import android.util.Log;
25 | import androidx.core.app.ActivityCompat;
26 | import androidx.core.content.ContextCompat;
27 | import java.util.ArrayList;
28 | import java.util.List;
29 |
30 | public class PermissionManager {
31 |
32 | private static final String TAG = "PermissionManager";
33 |
34 | // --- Permission Request Codes ---
35 | // We use a single code for the initial batch request for simplicity.
36 | // Individual requests (like from a plugin) can use their own codes.
37 | public static final int INITIAL_REQUEST_CODE = 100;
38 | public static final int CAMERA_REQUEST_CODE = 101;
39 | public static final int STORAGE_REQUEST_CODE = 102;
40 |
41 | private final Activity activity;
42 |
43 | public PermissionManager(Activity activity) {
44 | this.activity = activity;
45 | }
46 |
47 | /**
48 | * Checks all configured features in swv.properties and requests the
49 | * required permissions in a single batch.
50 | * This should be called on app launch.
51 | */
52 | public void requestInitialPermissions() {
53 | ListLongitude: " + lng.toFixed(6) + "
Fetching location from device...
";
117 | }
118 | // Call the new, non-conflicting object name
119 | if (window.SWVLocation) {
120 | window.SWVLocation.getCurrentPosition(function(lat, lng, error) {
121 | // In offline.html, updateLocationDisplay is global.
122 | // In docs/script.js, this logic is inside fetchLocation.
123 | // We'll make it robust for both.
124 | const displayDiv = document.querySelector('.fetch-loc') || document.querySelector('.fetch-loc-area');
125 | if (error) {
126 | displayDiv.innerHTML = "Error: " + error + "
";
127 | return;
128 | }
129 | if (lat && lng) {
130 | displayDiv.innerHTML = "Latitude: " + lat.toFixed(6) + "
Longitude: " + lng.toFixed(6) + "
";
131 | }
132 | });
133 | } else {
134 | alert("Location feature is not available.");
135 | }
136 | }
137 |
138 | function print_page(){
139 | window.print();
140 | }
141 |
142 | function applyInitialTheme(nativeTheme) {
143 | if (nativeTheme) {
144 | nativeThemePreference = nativeTheme;
145 | }
146 | }
147 |
148 | function setTheme(theme, isSystem = false) {
149 | const body = document.body;
150 | const themeSwitcher = document.getElementById('theme-switcher');
151 | let activeTheme = theme;
152 | let buttonToActivate = theme;
153 |
154 | if (theme === 'system') {
155 | localStorage.removeItem('swv-theme');
156 | activeTheme = nativeThemePreference;
157 | isSystem = true;
158 | buttonToActivate = 'system';
159 | } else {
160 | localStorage.setItem('swv-theme', theme);
161 | }
162 |
163 | if (activeTheme === 'dark') {
164 | body.classList.add('dark-mode');
165 | } else {
166 | body.classList.remove('dark-mode');
167 | }
168 |
169 | if (themeSwitcher) {
170 | themeSwitcher.querySelectorAll('button').forEach(btn => btn.classList.remove('active'));
171 | const activeButton = themeSwitcher.querySelector(`[data-theme="${buttonToActivate}"]`);
172 | if (activeButton) activeButton.classList.add('active');
173 | }
174 | if (window.AndroidInterface && typeof window.AndroidInterface.setNativeTheme === 'function') {
175 | window.AndroidInterface.setNativeTheme(theme);
176 | }
177 | }
--------------------------------------------------------------------------------
Longitude: " + lng.toFixed(6) + "