Using ForemWebView android Library

Thank for for showing interest in the library. You can setup this library in your project as mentioned her.

You can have a quick look at MainActivity.kt in this project which actually usages this library.

ForemWebView-android library is specifically designed to use forem instances in android app by using its WebViewFragment which basically loads the forem-web-instance in a WebView along with providing other interaction related features.

Using WebViewFragment to load a forem instance

Using FrameLayout in xml file.

You will need a FrameLayout in your activity/fragment's xml file. This FrameLayout will contain the [WebViewFragment].

<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
  xmlns:app="http://schemas.android.com/apk/res-auto"
  android:layout_width="match_parent"
  android:layout_height="match_parent">

  <FrameLayout
    android:id="@+id/web_view_fragment"
    android:layout_width="0dp"
    android:layout_height="0dp"
    android:background="@color/black"
    app:layout_constraintBottom_toBottomOf="parent"
    app:layout_constraintEnd_toEndOf="parent"
    app:layout_constraintStart_toStartOf="parent"
    app:layout_constraintTop_toTopOf="parent" />
</androidx.constraintlayout.widget.ConstraintLayout>

Adding WebViewFragment to FrameLayout

Lets just see the code first and then understand it after that:

    private fun loadOrUpdateFragment(url: String) {
        if (getWebViewFragment() == null) {
            supportFragmentManager.setFragmentResultListener(
                "WEB_VIEW_FRAGMENT_RESULT_LISTENER_KEY",
                /* lifecycleOwner= */ this
            ) { _, bundle ->
                val canGoBack = bundle.getBoolean(WebViewConstants.WEB_VIEW_CAN_GO_BACK_KEY)
                val canGoForward = bundle.getBoolean(WebViewConstants.WEB_VIEW_CAN_GO_FORWARD_KEY)
                val homeReached = bundle.getBoolean(WebViewConstants.WEB_VIEW_HOME_REACHED_KEY)

                if (homeReached) {
                    onWebPageHomeReached()
                } else {
                    // Enable these image views if you have back/forward icons in your code outside of `FrameLayout`.
                    // backImageView.isEnabled = canGoBack
                    // forwardImageView.isEnabled = canGoForward
                }
            }

            val webViewFragment = WebViewFragment.newInstance(
                url,
                "WEB_VIEW_FRAGMENT_RESULT_LISTENER_KEY",
                needsForemMetaData = false
            )
            this.supportFragmentManager.beginTransaction().add(
                R.id.web_view_fragment,
                webViewFragment
            ).commit()
        } else {
            getWebViewFragment()?.updateForemInstance(url)
        }
    }

    private fun getWebViewFragment(): WebViewFragment? {
        return this.supportFragmentManager.findFragmentById(
            R.id.web_view_fragment
        ) as WebViewFragment?
    }

1. In this code getWebViewFragment() function helps us to know if WebViewFragment has been attached to our FrameLayout or not.

2. The loadOrUpdateFragment accepts a forem-instance url and loads it in WebView Fragment.

• We use setFragmentResultListener to communicate information from WebViewFragment to its parent activity/fragment and we also listen to this information. The setFragmentResultListener can be used by adding a key in this case it is WEB_VIEW_FRAGMENT_RESULT_LISTENER_KEY and inside setFragmentResultListener we can listen to details like canGoBack which informs if the webview/website can go back to previous page, canGoForward which informs if the webview/website can go forward to previous page and homeReached is true if the website has reached its home page. All these values help us to decide what happens when the user clicks on back button in app i.e. if canGoBack is true then don't close the app instead go back to the previous page in webview.

3. Finally the newInstance function inside WebViewFragment helps us to create a new instance of the fragment. This fragment requires three things:

• url: the url of the forem-instance which needs to be shown in webview.
• resultListenerKey: key required to send data back to parent activity/fragment using setFragmentResultListener.
• needsForemMetaData: determines whether [WebView] needs to load the metadata like name, logo, etc and send it back to the parent. This needs to be true when the user has tried to add forem instance by adding a domain name (without any other information) so that we can get other information like name, logo, etc.

Understanding other helpful functions

• onBackPressedFragment(): Function which gets called whenever the back button is pressed in android app to either move to previous webpage or exit the app.
• navigateBack(): Navigates back in webview history if possible.
• navigateForward(): Navigates forward in webview history if possible.
• updateForemInstance(url: String): Accepts the new url of forem which needs to be loaded in webview.
• refresh(): Refreshes the webview.