https://github.com/xtools-at/Android-PWA-Wrapper
Android Wrapper to create native Android Apps from offline-capable Progressive Web Apps
https://github.com/xtools-at/Android-PWA-Wrapper
android android-app android-pwa-wrapper android-wrapper offline offline-app offline-capable offline-first progressive-web-app pwa service-worker single-page-app spa wrapper
Last synced: 3 days ago
JSON representation
Android Wrapper to create native Android Apps from offline-capable Progressive Web Apps
- Host: GitHub
- URL: https://github.com/xtools-at/Android-PWA-Wrapper
- Owner: xtools-at
- License: gpl-3.0
- Created: 2017-10-04T16:41:22.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2021-12-29T22:38:52.000Z (about 4 years ago)
- Last Synced: 2024-04-18T09:32:47.503Z (almost 2 years ago)
- Topics: android, android-app, android-pwa-wrapper, android-wrapper, offline, offline-app, offline-capable, offline-first, progressive-web-app, pwa, service-worker, single-page-app, spa, wrapper
- Language: Java
- Homepage: https://www.leasingrechnen.at
- Size: 238 KB
- Stars: 338
- Watchers: 17
- Forks: 133
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Android-PWA-Wrapper
An Android Wrapper application to create native Android Apps from an offline-capable Progressive Web App.
Drafted for the [Android App](https://play.google.com/store/apps/details?id=at.xtools.leasingrechner&utm_source=github.com&utm_medium=link&utm_campaign=store_visit) of my [Leasing Calculator](https://www.leasingrechnen.at) Web App using [React](https://github.com/facebook/react), [Redux](https://github.com/reactjs/redux), [Materialize.css](https://github.com/Dogfalo/materialize) and a lot of Offline-First love over at [leasingrechnen.at](https://www.leasingrechnen.at).
## Looking for iOS or Desktop?
Check out my other projects:
- [iOS-PWA-Wrapper](https://github.com/xtools-at/iOS-PWA-Wrapper) for iOS
- [Electron-PWA-Wrapper](https://github.com/xtools-at/Electron-PWA-Wrapper) for macOS, Windows and Linux
## Why would I use a wrapper?
I know, using a Wrapper-App to display a Website can feel a bit odd. But there are a few good reasons why you'd package your Web App like this.
- If you've got a very sophisticated UI already, it might make sense not to rebuild it from scratch for multiple platforms, especally if it's a Single Page Application already, that doesn't "feel" like a Website.
- There might be as well less competition for a given niche on App Stores, in comparison to Google directly. With [leasingrechnen.at](https://www.leasingrechnen.at), I've got easily into the Top 10 Apps on Google Play for my country, whereas Google Search put me on page 9 as the Site is relatively new.
## What it does
- Sets up a WebView just the way PWAs/SPAs like it (e.g. enables App cache and DOM storage, ...).
- Shows a loading spinner while fetching the Web App.
- Provided your Web App is Offline-capable, it only needs an Internet connection on the first startup. If this fails, it shows a native refresh widget.
- Opens all external URLs in the device's Browser instead.
- Checks for Internet connection and fetches Updates for your Web App accordingly.
- Is compatible down to JellyBean, although it's recommended to build for SDK Version >= 19 (KitKat). Building for SDK Version >= 21 (Lollipop) puts you on the safe side without having to worry too much about Browser support.
- APK-size < 1.4 MB. The latest cat video from WhatsApp weighs heavier ;)
## How to build your own
- Get Android Studio 3.4+
- Clone/fork repository
- Put your Web App's URL in _WEBAPP_URL_ in `Constants.java`
- Replace *app_name* in `strings.xml` with the name of your App
- Add your own primary colors to `colors.xml` (*colorPrimary, colorPrimaryDark, colorPrimaryLight*)
- Put your own icons in place:
- Add your own _ic_launcher.png_ and _ic_launcher_round.png_ in the `mipmap` folders
- Add your own _ic_appbar.png_ in the `drawables` folders. This is displayed in Android's _Recent Apps_ View on your app bar, so it should look nicely when placed on top of your primary color.
- I recommend using [Android Asset Studio](https://romannurik.github.io/AndroidAssetStudio) to get the icons ready in no time
- Change the package name in `app/build.gradle`, *applicationId*
- Change `AndroidManifest.xml` -> `aplication` -> `activity` -> `intent-filter` to your own URLs/schemes/patterns/etc. or remove the `intent-filter` for `android.intent.action.VIEW` altogether
- Check `Constants.java` for more options
- Build App in Android Studio
### I don't accept Feature Requests, only Pull Requests :)
## License
[GNU General Public License v3.0](https://www.gnu.org/licenses/gpl-3.0.en.html) - if you use it, we wanna see it!
Other licensing options are available on inquiry.