[TIMOB-14617] iOS 7 : Backgrounding Features

[srahim]

Introduces following new events

New Ti.App.iOS level Events

• backgroundfetch
• silentpush
• backgroundtransfer
• downloadprogress
• uploadprogress
• downloadcompleted
• sessioneventscompleted
• sessioncompleted

New Ti.App.iOS methods

• setMinimumBackgroundFetchInterval(fetchinterval);
• endBackgroundHandler();

TESTING INSTRUCTIONS

** There are 3 cases to be tested for urlSession
Use the following app.js for all cases mentioned below.
Be sure to include the module to your project.

1. Foreground downloading
* User initiates a background download while in the foreground. The download completes while in the foreground itself.

Instructions.

• Create a app with the above provided app.js.
• When the app starts click on the download button. and the image should download and the result would be stored in applicationdata directory.
• The progress can be monitored on the console.
• Once the download is complete. the appropriate task will be removed from pending downloads and the downloaded file name will be added to the downloaded list.

2. Foreground download initiation + Background download
* User initiates a background download while in the foreground. Then the app is but into background, download completes while the app is in the background itself.

Instructions.

• Create a app with the above provided app.js.
• When the app starts click on the download button. and put the app into background by pressing on the home button on the device.
• The image should download and the result would be stored in applicationdata directory.
• The progress can be monitored on the console.
• Once the download is complete. the appropriate task will be removed from pending downloads and the downloaded file name will be added to the downloaded list.

3. Background Fetch causing a background download
****NOTE :: This would be the most important and slightly tricky use case as you would have to use Xcode to complete this.

• The app is launched due to a 'backgroundfetch' event which would trigger a background download.

INSTRUCTIONS ON TESTING

initial test setup

• Create a app with the above provided app.js.
• Include the following in your tiapp.xml

    <ios>
        <plist>
            <dict>
                <key>UIBackgroundModes</key>
                <array>
                    <string>fetch</string>
                </array>
            </dict>
        </plist>
        <min-ios-ver>7.0</min-ios-ver>
    </ios>

• Buiild the app for iOS Simulator.
• Once the app launches kill the simulator and Studio process.
• Navigate to the apps build folder and native xcode app (should be /build/iphone/.xcodeproj)
• Open the build project in xcode.
• On the top right corner, Click on the schemes drop down (make sure you have selected any iOS 7 simulator before continue)
  
• Click on Manage schemes from the drop down
  
• which would bring you to this screen.
  
• Select one of the schemes (say: -universal)
  
• Click on the little gear at the left hand bottom corner of that the window to reveal another drop down menue.
  
• Select duplicate option
• On the new window that pops on top of the previous window Enter a new for the scheme and __select the launch due to a background fetch event option.
  
  
• Hit OK
• HIt OK
• Now you should have a new scheme, which is automatically selected for you.

actual test

• Click on the play/run button to build and launch the app into background.
• Look at the console log to verify that a backgroundfetch event was fired.
• Soon after the backgroundfetch event is fired backgroundtransfer event would fire indicating that the download relaunched the into background.
• the rest of the of downloading events would fire short after.
• Once the initial download is complete if you want to test again.
• In the xcode menu bar select Debug Option.
• Under Debug Option Select the Simulate Background Fetch option.
  
• This would trigger another backgroundfetch.

Please do let me know if you get stuck on any of the steps.

[vishalduggal]

replace?

[vishalduggal]

osver: {ios: {min: "7.0"}}

[pec1985]

Note to self, testing with image url http://edmullen.net/test/rc.jpg since it's larger than the one provided in app.js

[pec1985]

FR PASSED

[pec1985]

@srahim I tested it and it works as described above.
One question I have is why is the module binary 61.8MB?

[srahim]

@vishalduggal addressed review comments.

[pec1985]

PR APPROVED!