Getting Started
Follow these steps to get your Smart WebView project up and running.
Prerequisites
- Android Studio: The official IDE for Android development. Download from the Android Developers site.
- Android SDK: Minimum API Level 24 (Android 7.0 Nougat) or higher installed via the Android Studio SDK Manager.
Step 1: Download and Open
- (Recommended) Download the latest source code (
.zip
or.tar.gz
) from the GitHub Releases page. - Unzip the project and open the folder in Android Studio.
- Alternatively, clone the repository:
git clone https://github.com/mgks/Android-SmartWebView.git
- Alternatively, clone the repository:
Step 2: Configure Your App
All major configuration is now done in a single properties file.
- In the Android Studio project view, navigate to
app/src/main/assets/
. - Open the
swv.properties
file. - Edit the values, especially
app.url
, to match your project’s requirements.
See the Configuration Guide for a detailed explanation of all available options in swv.properties
.
Step 3: Add Firebase Configuration (Optional)
If you plan to use Firebase Cloud Messaging (Push Notifications), you need your project’s google-services.json
file.
- Go to your Firebase Console and follow the steps to add an Android app.
- Download the
google-services.json
file. - Place this file directly into the
app/
directory of your Smart WebView project.Android-SmartWebView/ ├── app/ │ ├── google-services.json <-- Place it here │ ├── src/ │ └── ... └── ...
Step 4: Build and Run
- Allow Gradle to sync and download all dependencies. This may take a few moments.
- Click the
Run 'app'
button (the green play icon) to build and launch the app on an emulator or a connected device.
Your Smart WebView app should now launch! If you encounter issues, double-check that swv.properties
is configured and that the build process completed without errors.