Home-Assistant-WebView

A modified Android WebView with some enhancements for display Home Assistant Web

Home-Assistant version

Home Assistant may change its DOM structure on new releases, so this WebView may not work correctly if it happens. Latest commit is tested and fully working under Home Assistant v0.78.3.

Hide administrator menu items

You can hide administrator menu items from the drawer menu, so you can let your family members use home assistant without the risk they change any configuration parameter.

Back key behavior

If you are using Home Assistant through your web browser, Android back key behaves like browser back key. So, if you navigated through several tabs, pressing back key takes you to previous visited tab. Android apps don't work that way (it should close the app). So this is the back key behavior:

• If a "more info" popup is showing, popup will close.
• Else, if section "Overview" is not showing, you will be back to "Overview".
• Else, onFinish event is fired, so you can exit the app, or close a dialog, or whatever you want.

Usage

Add this in your root build.gradle at the end of repositories:

	allprojects {
		repositories {
			...
			maven { url 'https://jitpack.io' }
		}
	}

Add dependency to your build.gradle:

    compile 'com.github.sjvc:Home-Assistant-WebView:master-SNAPSHOT'

Add to your layout as a regular WebView:

    <com.baviux.homeassistant.HassWebView
        android:id="@+id/webView"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

Set options

    mWebView.setAdjustBackKeyBehavior(boolean); // If true, back key behavior will be like described above. Default is true.
    mWebView.setHideAdminMenuItems(boolean); // If true, administrator menu items will be hidden. Default is true.

Set onFinish event handler

It will be fired when WebView should be "closed" (here you should finish Activity, or close a dialog, or hide the WebView, etc..)

    mWebView.setOnFinishEventHandler(new HassWebView.IOnFinishEventHandler() {
	@Override
	public void onFinish() {
	    MainActivity.this.finish();
	}
    });

Handle onBackPressed event in your Activity

   @Override
   public void onBackPressed() {
       // If it's handled by WebView -> it's done!
       if (mWebView != null && mWebView.onBackPressed()){
           return;
       }

       // If not, if we can go back -> let's go back!
       if (mWebView != null && mWebView.canGoBack()){
           mWebView.goBack();
           return;
       }

       // Else -> Let parent class handle it
       super.onBackPressed();
   }

Load HASS url

   mWebView.loadUrl("https://example.com:8123");