Page Comparison

...

1. In a Terminal window, navigate to your project location. For this tutorial, our project is housed under the Documents > umobile-phonegap-ios directory.

2. From this directory, checkout the uMobile source code.
   

   Code Block
   git clone git@github.com:Jasig/umobile-app-phonegap umobile-ui

3. Your project directory should look similar to the below graphic:
    
4. ...

Creating the Project

A completed example of an XCode project configured to run the uMobile PhoneGap implementation is available on github.

1. Check the uMobile source out into a new project directory.
    

   Image Removed

Configure the uMobile Source

1. In a Terminal window, navigate to your project location. For this tutorial, our project is housed under the Documents > umobile-phonegap-ios directory.
2. In the same Terminal window, navigate to the umobile-ui directory.

3. Execute the following command to load all the ui dependencies. Note: Node must be installed.

   Code Block
   sudo npm install

4. uMobile currently supports three different authentication strategies: CAS, Local & Mock.
   
   1. Each strategy has a cooresponding configuration file under the umobile-ui/config/js directory (i.e., cas.js, local.js and mock.js).
   2. Choose one of the three authentication strategies. For this documentation, we will use local.js.
   3. Open local.js.
      
      1. Set config.uMobileServerUrl to http://localhost:8080.
         
      2. Set config.loginFn to localLogin.
         

5. Run the build process for the uMobile source code. The build process configures the uMobile source code with the necessary dependencies needed to run in a given environment. Currently, the uMobile project supports Android, iOS and Web platforms. Once the build completes a www directory will be added to the umobile-ui directory. The www directory houses the production ready code base to be used with the PhoneGap wrapper. Please see the documentation on the uMobile HTML5 build for more information on configuring the build script.

   Code Block
   grunt prod --environment=ios --auth=local

6. ...

Creating the Project

1.  

2. Navigate to umobile-ui/config/js.
   
   1. uMobile currently supports three different authentication strategies: CAS, Local & Mock.
   2. Each strategy has a cooresponding configuration file under the umobile-ui/config/js directory (i.e., cas.js, local.js and mock.js).
   3. Choose one of the three authentication strategies. For this documentation, we will use cas.js.
   4. Open cas.js.
      
      1. Set config.uMobileServerUrl to http://localhost:8080.
         
      2. Set config.loginFn to casLogin.
      3. Note: There are bugs with the current login functionality. Only view the portal using the guest layout. This is being addressed.

3. Run the build process for the uMobile source code. The build process configures the uMobile source code with the necessary dependencies needed to run in a given environment. Currently, the uMobile project supports Android, iOS and Web platforms. Once the build completes a www directory will be added to the umobile-ui directory. The www directory houses the production ready code base to be used with the PhoneGap wrapper. Please see the documentation on the uMobile HTML5 build for more information on configuring the build script.
   

   Code Blockcd umobile-ui sudo npm install grunt --environment=ios --config=cas --build=prod

   
   

    

4. Drag the production-ready www directory from your finder window to the XCode uMobile project. When done for the first time, XCode will ask you to create a workspace before including the www directory. For the purpose of this project, we created a umobile workspace.
     
5. Choose options for adding the www directory to the project.
    
6. Configure cordova.plist.
   
   1. In XCode, under the Project Navigator, navigate to uMobile > Supporting Files > Cordova.plist.
   2. Under the Root Key:
      
      1. Set OpenAllWhitelistURLsInWebView to Yes.
   3. Under the ExternalHosts Key:
      
      1. Add the hostname, any authentication servers and any other servers hosting uMobile resources.
      2. If you're working with the uMobile quickstart, you can just add localhost.
   4. Under the Plugin Key:
      
      1. Plugin: SesssionTracking
      2. Type: String
      3. Value: SessionTracking
   
   
   
7. Add SessionTracking Plugin files into the Plugins folder:
   
   1. SessionTracking.h
   2. SessionTracking.m
   
   
   
8. Download MainViewController.m
9. Navigate to uMobile > Classes > MainViewController.m.
10. Replace MainViewController with the downloaded version.
11. Set the scheme at the top of the project to iPhone 6.1 Simulator and run the project!
    
    

...