Installation

1. Add the following dependency to your app-level build.gradle file:

dependencies {
    implementation 'com.github.mgks:Android-SmartWebView:7.0' // Replace with latest version if available
}

2. Add the Google Services plugin to your build.gradle file:

plugins {
    // ... other plugins
    id 'com.google.gms.google-services'
}

3. Include the necessary Firebase dependencies in your app-level build.gradle:

dependencies {
    // ... other dependencies
    implementation platform('com.google.firebase:firebase-bom:32.7.2') // Use latest version
    implementation 'com.google.firebase:firebase-messaging'
}

4. Add the `google-services.json` file (downloaded from the Firebase console) to your app module directory.

Basic Usage

In your `MainActivity.java`, initialize the `SmartWebView` object and load your desired URL:

public class MainActivity extends AppCompatActivity {
    // ...

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        SmartWebView.asw_view = findViewById(R.id.smartWebView);

        // Configure Smart WebView (optional)
        SmartWebView.ASWV_URL = "your_url_here"; // Set your starting URL here

        // ... other SmartWebView configurations ...

        // Initialize Smart WebView
        WebSettings webSettings = SmartWebView.asw_view.getSettings();
        // ... set your WebSettings ...

        // Set the WebViewClient
        SmartWebView.asw_view.setWebViewClient(new SmartWebViewClient());

        // Load the URL
        SmartWebView.asw_view.loadUrl(SmartWebView.ASWV_URL);
    }

    // ...
}

File Uploads and Camera Access

Allow users to upload files from their device or capture images/videos using the camera within the WebView.

Configuration:

• ASWP_FUPLOAD: Enable/disable file uploads (`true` by default).
• ASWP_CAMUPLOAD: Enable/disable camera uploads (`true` by default).
• ASWV_F_TYPE: Allowed file types (e.g., "*⁄*", "image/⁄*", "video/⁄*").

Permissions:

• Manifest.permission.CAMERA
• Manifest.permission.READ_EXTERNAL_STORAGE (for API levels below 33)
• Manifest.permission.WRITE_EXTERNAL_STORAGE (for API levels below 29)
• Manifest.permission.READ_MEDIA_IMAGES (for API levels 33 and above)
• Manifest.permission.READ_MEDIA_VIDEO (for API levels 33 and above)

Geolocation

Access the user's location using the device's GPS or network location.

Configuration:

• ASWP_LOCATION: Enable/disable geolocation (`true` by default).

Permissions:

• Manifest.permission.ACCESS_FINE_LOCATION
• Manifest.permission.ACCESS_COARSE_LOCATION

Push Notifications

Integrate with Firebase Cloud Messaging (FCM) to send push notifications to your app.

Configuration:

See the Firebase section for details on setting up FCM.

Permissions:

• Manifest.permission.POST_NOTIFICATIONS (for API levels 33 and above)

Custom URL Handling

Override specific URLs to trigger native actions or handle them within your app.

Configuration:

Plugins can define custom URL schemes that they will handle. For example, the `PlugQRReader` plugin handles URLs starting with `qrscan://start`.

JavaScript Interface

Communicate between JavaScript code running in the WebView and your native Android code.

Refer to the Android documentation for more details on implementing a JavaScript interface.

Configuration Options

Here's a more detailed explanation of each configuration option:

Add detailed explanations of each configuration option here.

Permissions

Smart WebView requests the following permissions at runtime if the corresponding features are enabled:

• Manifest.permission.ACCESS_FINE_LOCATION (if ASWP_LOCATION is `true`)
• Manifest.permission.CAMERA (if ASWP_CAMUPLOAD is `true`)
• Manifest.permission.READ_EXTERNAL_STORAGE (if targeting below Android 13 and ASWP_FUPLOAD is `true`)
• Manifest.permission.WRITE_EXTERNAL_STORAGE (if targeting below Android 10 and ASWP_FUPLOAD is `true`)
• Manifest.permission.READ_MEDIA_IMAGES (if targeting Android 13 and above and ASWP_FUPLOAD is `true`)
• Manifest.permission.READ_MEDIA_VIDEO (if targeting Android 13 and above and ASWP_FUPLOAD is `true`)
• Manifest.permission.POST_NOTIFICATIONS (if using Firebase Cloud Messaging on Android 13 and above)

Plugin Interface

The `PluginInterface` defines the following methods:

• initialize(): Called when the plugin is initialized.
• getPluginName(): Returns the name of the plugin.
• getOverriddenUrls(): Returns an array of URLs that the plugin wants to handle.
• handlePermissionRequest(): Called when a permission request result is received.
• handleActivityResult(): Called when an activity result is received.
• shouldOverrideUrlLoading(): Called to determine if the plugin should handle a specific URL.
• onPageStarted(): Called when a new page starts loading in the WebView.
• onPageFinished(): Called when a page finishes loading in the WebView.

Example Plugin (QR Code Reader)

The `PlugQRReader` is an example plugin that demonstrates how to implement a QR code reader using the ZXing library.

Code Example:

public class PlugQRReader implements PluginInterface {
    // ... implementation details ...

    @Override
    public void onPageFinished(String url) {
        // Inject JavaScript to add a button for QR scanning
        if (url.contains("scanqr")) {
            String js = "javascript:" +
                    "var button = document.createElement('button');" +
                    "button.innerHTML = 'Scan QR Code';" +
                    "button.onclick = function() { window.location.href = 'qrscan://start'; };" +
                    "document.body.appendChild(button);";
            webView.evaluateJavascript(js, null);
        } else {
            // Inject JavaScript to remove button from the page
            String js = "javascript:" +
                    "var button = document.querySelector('button[data-qr-button=\"true\"]);" +
                    "if (button) { button.remove(); }";
            webView.evaluateJavascript(js, null);
        }
    }

    @Override
    public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {
        String url = request.getUrl().toString();
        if (url.startsWith("qrscan://start")) {
            startQRScanning();
            return true; // Indicate that this plugin handled the URL
        }
        return false; // URL not handled by this plugin
    }

    // ... other methods for handling permissions, scanning, etc. ...
}

To register a plugin, add it to the `plugins` map in the `PluginManager` class:

public class PluginManager {
    // ...
    private void registerPlugins() {
        try {
            plugins.put("PlugQRReader", new PlugQRReader(this));
            // Add other plugins as needed
        } catch (Exception e) {
            Log.e(TAG, "Failed to load plugins", e);
        }

        for (PluginInterface plugin : plugins.values()) {
            plugin.initialize(activity, webView);
        }
    }
    // ...
}