An iOS Wrapper application to create a native iOS App from Vue Storefront PWA.
For bringing offline-capabilities to your Web App on Safari and iOS' embedded WebKit browser, you have to use AppCache. Service Worker API is not yet supported in WebKit, so you might want to use something like Appcache Webpack Plugin to make your PWA offline-accessible on iOS in a somewhat easy way.
- Provides a native iOS navigation header.
- Sets up a WKWebView instance just the way PWAs/SPAs like it.
- 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 / 3rd party apps instead.
- Automatically fetches updates of your Web App.
- Clone/fork repository and open in Xcode
- Head over to
Constants.swiftand- add your app's name and the main URL to fetch
- set the host you want to restrict your app to
- add your custom Javascript string to open your Web App's menu.
- this is injected into the site when the "Menu" button is pressed. This wrapper assumes you're hiding your Web App's header in favor of the native App navigation and show/hide your menu via Javascript.
- customize the colors
- tweak the other options as you prefer
- Put your own App icons in place in
Assets.xcassets- Remember, 1pt equals 1px on 1x-size. E.g., if you have to provide a 20pt icon of 3x-size, it has to be 60x60px.
- iOS doesn't like transparency, use background colors on your icons.
- I like using App Icon Maker, but any other similar service will do it as well.
- Don't forget the
launchericon!
- In the Project Overview
- change Bundle Identifier and Display Name
- add your Certificates and tweak the rest as you wish
- a Deployment Target of iOS 10.0 is set by default, as the offline cache isn't preserved after closing the app in earlier versions. Therefore, the wrapper is only tested on iOS 10+ and there's no official support for earlier versions for now.
- Build App in Xcode