Use WKWebView in your Cordova Ionic app without a local web server

In iOS 8, Apple introduced WKWebView as a replacement for the aging UIWebView. NSHipster has a great write-up of all of the changes, summarized as follows:

Boasting responsive 60fps scrolling, built-in gestures, streamlined communication between app and webpage, and the same JavaScript engine as Safari, WKWebView is one of the most significant announcements to come out of WWDC 2014.

Until recently, Cordova apps have been stuck using UIWebView. With the release of the Cordova iOS platform version 4.0.0, we can now take advantage of WKWebView using the cordova-plugin-wkwebview-engine plugin.

There's one large caveat: WKWebView does not allow XHR requests to file:// URIs. This is problematic for Ionic (particularly Angular) templates. Angular's default behavior is to load templates at runtime using XHR requests, which will fail in this case.

One workaround is to include another plugin called cordova-labs-local-webserver, which does exactly what it sounds like--it runs a local web server in your application's sandbox that serves all of the web content on localhost instead of from file:// URIs.

In my opinion, though, running a local web server on the phone itself seemed like overkill just to load Angular templates.

My first alternate workaround was to write a shell script that concatenated all the templates together and injected them into index.html at build time.

An even better solution is to use a gulp task to convert all the templates into a single JavaScript source file that can be referenced from index.html.

We use the gulp-angular-templatecache node module to achieve this. Add the following to your gulpfile, changing paths as needed:

var templateCache = require("gulp-angular-templatecache");

/**
 * Used to concatenate all HTML templates into a single JavaScript module.
 */
gulp.task("templates", function() {  
    return gulp.src(paths.templates)
        .pipe(templateCache({
            "filename": "templates.js",
            "root": "templates/",
            "module": "templates",
            standalone: true
        }))
        .pipe(gulp.dest("./www/js"));
});

After running the task, you'll end up with a generated file that looks like this:

angular.module("templates", [])  
  .run(["$templateCache", function($templateCache) {
      $templateCache.put("templates/Template1.html","HTML HERE");
      $templateCache.put("templates/Template2.html","HTML HERE");
// etc...
});

If you include a reference to this new file from index.html, you should then be able to reference the new module wherever you declare your root Angular module:

angular.module("YourApplication", ["ui.router", "ionic", "ngMockE2E", "templates"]);  

And that's it! Without any other changes, your templates will be loaded directly from the template cache, and Angular will not make XHR requests at runtime.

Author image
Northern California
A software geek who is into IoT devices, gaming, and Arcade restoration.