Latest 0.1.1
License Apache License, Version 2.0


The required resources and instructions for embedding a PhoneGap webview into an iOS Native Project quickly.

Quick Start Usage

  1. Add the following to your native iOS project Podfile to get this dependency from the CocoaPods registry:

    pod 'ios-webview-www'   
  2. Install the pods referenced in the Podfile from the command line using the CocoaPods pod command:

    pod install
  3. Close your native Xcode project and open the newly created .xcworkspace project in the same folder which now includes
    all of the Cordova dependency pods.

  4. You’re ready to use any of the Cordova dependencies, for example the CDVViewController. See below for further details.

Detailed Usage – Embedding Cordova in a Native iOS Project

Short Demo Video

NOTE: This project assumes you have previously installed CocoaPods

  1. Create a Native Xcode Project – for example using the Single View Controller project template
    Create Single View Project
  2. Create a Podfile in the root of your project from the command line
    • Type pod init to create a base Podfile
    • Open it and replace the contents with those from the Podfile_sample prior to the target specification lines (see demo video)
  3. Run pod install from command line to install the Cordova dependencies
  4. Close your Xcode project
  5. Open the newly created .xcworkspace file created from the pod install.
    Install and Open
  6. Note the new Pods folder with the Cordova dependencies is now included:
    Pods in Native Project
  7. Now use a Cordova View in your native project. Open the Main.storyboard file
    and change the Custom Class value from the default ViewController to a CDVViewController in the Identity Inspector
    Create Single View Project

Run it

Build/run the app in Xcode. You should see the custom iOS template version of the PhoneGap Hello world sample running with the Device Ready event firing and
some messages indicating the use of some of the dependent plugins to ensure they’ve been properly referenced.

NOTE: The index.js code in the template project includes references to the device and network information plugins to
quickly test plugin setup.

Running device plugin
Running connection plugin
Device Ready Fired


  • Be sure to change the target name to your native project target name in the Podfile and ensure Podfile is in the root directory of your Xcode project
  • You may need to change the version of platform specified or specify certain versions for other plugins.
  • If you update anything in the podfile where you have to run a pod install again, you must close the Workspace project in Xcode and open the newly generated one.

Latest podspec

    "name": "ios-webview-www",
    "version": "0.1.1",
    "summary": "PhoneGap sample template project for iOS.",
    "description": "A PhoneGap sample project to get started quickly with an embedded webview in a native iOS project.",
    "license": {
        "type": "Apache License, Version 2.0",
        "file": "LICENSE"
    "homepage": "",
    "authors": {
        "Holly Schinsky": "[email protected]"
    "social_media_url": "",
    "source": {
        "git": "",
        "tag": "0.1.1"
    "resources": "resources/*"

Pin It on Pinterest

Share This