Smart WebView is designed to be easily customizable. You can modify various aspects of the app, from visual styles to text strings and assets.

App Name and Package ID

  • App Name: Change the app_name string value in app/src/main/res/values/strings.xml.
  • Package ID: The applicationId is now configured directly from swv.properties. Change the build.application.id property and rebuild. Android Studio will handle the refactoring.

Changing the Package ID after release complicates app updates on Google Play.

Launcher Icons

Replace icons in app/src/main/res/mipmap-* directories. Use Android Studio’s “Image Asset Studio” (Right-click res > New > Image Asset) for generating adaptive icons.

UI Appearance

  • Colors: Define your palette in app/src/main/res/values/colors.xml and app/src/main/res/values-night/colors.xml.
  • Themes: Modify app themes in app/src/main/res/values/themes.xml. Core theme structure is now based on Material 3.
  • Splash Screen: The new Android 12+ splash screen is configured in app/src/main/res/values/themes.xml under the Theme.App.Starting style.

Layouts

Modify the XML layout files in app/src/main/res/layout/ (e.g., activity_main.xml, drawer_main.xml) to change the native UI structure.

When using the drawer layout (ui.layout=1), you can customize it:

  • Menu Items: Define items in app/src/main/res/menu/activity_main_drawer.xml.
  • Header: Customize the header view in app/src/main/res/layout/drawer_main_header.xml.
  • Item Click Handling: Modify onNavigationItemSelected in MainActivity.java.

Local Assets

Place files in app/src/main/assets/web/ to bundle them with your app. Access them in the WebView using the path file:///android_asset/web/YOUR_FILENAME. The project includes:

  • error.html
  • offline.html
  • script.js
  • style.css

The root assets directory contains the main swv.properties configuration file.

Text Strings

Centralize user-facing text for easy modification and localization in app/src/main/res/values/strings.xml. To add translations, create new resource folders like values-es/strings.xml.

Android Manifest

The core application configuration file is app/src/main/AndroidManifest.xml.

Modify this file with care. It is used for declaring permissions, registering activities/services, defining intent filters for deep linking, and specifying hardware features.

Previous Configuration Next Features