[TIMOB-15577] Exposed hideScreenShotOnAppResume on Ti.App module

apidoc/Titanium/App/App.yml

@@ -373,6 +373,15 @@ properties:
     permission: read-only
     exclude-platforms: [blackberry]
 
+  - name hideScreenShotOnAppResume
+    summary: Shows the application's splash screen on app resume.
+    description: |
+        When the app goes to the background a screenshot of the current app state is taken. When
+        the app resumes that screenshot is shown for brief moment. To disable this behavior, set
+        this property to `true` and the default splash screen will show on app resume instead.
+    type: Boolean
+    platforms: [iphone, ipad]
+
   - name: id
     summary: Application ID, from `tiapp.xml`. 
     description: |

iphone/Classes/AppModule.m

@@ -586,6 +586,14 @@ -(NSNumber*)keyboardVisible
     return NUMBOOL([[[TiApp app] controller] keyboardVisible]);
 }
 
+-(void)setHideScreenShotOnAppResume:(id)args
+{
+    ENSURE_SINGLE_ARG(args, NSNumber)
+    [self replaceValue:args forKey:@"hideScreenShotOnAppResume" notification:NO];
+    BOOL flag = [TiUtils boolValue:args def:YES];
+    [[TiApp app] setHideScreenShotOnAppResume:flag];
+}
+
 #if defined(USE_TI_APPIOS)
 -(id)iOS
 {

iphone/Classes/TiApp.h

@@ -32,6 +32,7 @@ TI_INLINE void waitForMemoryPanicCleared()   //WARNING: This must never be run o
 {
 	UIWindow *window;
 	UIImageView *loadView;
+    UIImageView *splashScreenImage;
 	BOOL loaded;
 
 	TiContextGroupRef contextGroup;
@@ -61,6 +62,8 @@ TI_INLINE void waitForMemoryPanicCleared()   //WARNING: This must never be run o
 	NSDictionary *localNotification;
 }
 
+@property (nonatomic) BOOL hideScreenShotOnAppResume;
+@property (nonatomic) BOOL appInBackground;
 /**
  Returns application's primary window.
 

iphone/Classes/TiApp.m

@@ -291,13 +291,33 @@ - (void)applicationDidFinishLaunching:(UIApplication *)application
 	[self boot];
 }
 
+-(UIImageView*)splashScreenImage
+{
+    if(splashScreenImage == nil) {
+        UIDeviceOrientation imageOrientation;
+        UIUserInterfaceIdiom imageIdiom;
+
+        splashScreenImage = [[UIImageView alloc] init];
+        [splashScreenImage setBackgroundColor:[UIColor yellowColor]];
+        [splashScreenImage setAutoresizingMask:UIViewAutoresizingFlexibleHeight | UIViewAutoresizingFlexibleWidth];
+        [splashScreenImage setContentMode:UIViewContentModeScaleToFill];
+        [controller rotateDefaultImageViewToOrientation:[[UIApplication sharedApplication] statusBarOrientation]
+                                          withImageView:splashScreenImage];
+
+        //        UIImage *img = [controller defaultImageForOrientation:[[UIApplication sharedApplication] statusBarOrientation] resultingOrientation:imageOrientation idiom:imageIdiom];
+        //        [splashScreenImage setImage:img];
+        [splashScreenImage setFrame:[window bounds]];
+    }
+    return splashScreenImage;
+}
+
 - (void)generateNotification:(NSDictionary*)dict
 {
 	// Check and see if any keys from APS and the rest of the dictionary match; if they do, just
 	// bump out the dictionary as-is
 	remoteNotification = [[NSMutableDictionary alloc] initWithDictionary:dict];
 	NSDictionary* aps = [dict objectForKey:@"aps"];
-	for (id key in aps) 
+    for (id key in aps)
 	{
 		if ([dict objectForKey:key] != nil) {
 			DebugLog(@"[WARN] Conflicting keys in push APS dictionary and notification dictionary `%@`, not copying to toplevel from APS", key);
@@ -439,6 +459,10 @@ - (void)applicationDidReceiveMemoryWarning:(UIApplication *)application
 
 -(void)applicationWillResignActive:(UIApplication *)application
 {
+    [self setAppInBackground:YES];
+    if([self hideScreenShotOnAppResume]) {
+        [window addSubview:[self splashScreenImage]];
+    }
 	[[NSNotificationCenter defaultCenter] postNotificationName:kTiSuspendNotification object:self];
 
 	// suspend any image loading
@@ -495,6 +519,9 @@ -(void)applicationDidEnterBackground:(UIApplication *)application
 
 -(void)applicationWillEnterForeground:(UIApplication *)application
 {
+    [[self splashScreenImage] removeFromSuperview];
+    RELEASE_TO_NIL(splashScreenImage);
+
     [sessionId release];
     sessionId = [[TiUtils createUUID] retain];
 
@@ -625,6 +652,7 @@ - (void)dealloc
 	RELEASE_TO_NIL(xhrBridge);
 #endif	
 	RELEASE_TO_NIL(loadView);
+    RELEASE_TO_NIL(splashScreenImage)
 	RELEASE_TO_NIL(window);
 	RELEASE_TO_NIL(launchOptions);
 	RELEASE_TO_NIL(controller);
@@ -693,6 +721,7 @@ -(void)endBackgrounding
 
 	[self checkBackgroundServices];
 	RELEASE_TO_NIL(runningServices);
+    [self setAppInBackground:NO];
 }
 
 - (void)application:(UIApplication *)application didReceiveLocalNotification:(UILocalNotification *)notification

iphone/Classes/TiRootViewController.h

@@ -61,5 +61,7 @@
 -(void)shutdownUi:(id)arg;
 #endif
 
+-(void)rotateDefaultImageViewToOrientation: (UIInterfaceOrientation )newOrientation withImageView:(UIImageView*)theImageView;
+
 
 @end

iphone/Classes/TiRootViewController.m

@@ -178,7 +178,7 @@ -(void)loadView
     rootView.autoresizingMask = UIViewAutoresizingFlexibleHeight | UIViewAutoresizingFlexibleWidth;
     [self updateBackground];
     if (defaultImageView != nil) {
-        [self rotateDefaultImageViewToOrientation:[[UIApplication sharedApplication] statusBarOrientation]];
+        [self rotateDefaultImageViewToOrientation:[[UIApplication sharedApplication] statusBarOrientation] withImageView:defaultImageView];
         [rootView addSubview:defaultImageView];
     }
     [rootView becomeFirstResponder];
@@ -294,9 +294,9 @@ - (UIImage*)defaultImageForOrientation:(UIDeviceOrientation) orientation resulti
 	return [UIImage imageNamed:@"Default.png"];
 }
 
--(void)rotateDefaultImageViewToOrientation: (UIInterfaceOrientation )newOrientation;
+-(void)rotateDefaultImageViewToOrientation: (UIInterfaceOrientation )newOrientation withImageView:(UIImageView*)theImageView;
 {
-	if (defaultImageView == nil)
+	if (theImageView == nil)
 	{
 		return;
 	}
@@ -352,7 +352,29 @@ -(void)rotateDefaultImageViewToOrientation: (UIInterfaceOrientation )newOrientat
 				contentMode = UIViewContentModeCenter;
 			}
 		}
-	}
+	} else {
+        if([[TiApp app] appInBackground]) {
+            // Rotate image, we're in background!
+            UIImageOrientation newImgOrientation;
+            switch (newOrientation) {
+                case UIDeviceOrientationLandscapeLeft:
+                    newImgOrientation = UIImageOrientationRight;
+                    break;
+                case UIDeviceOrientationLandscapeRight:
+                    newImgOrientation = UIImageOrientationLeft;
+                    break;
+                default:
+                    newImgOrientation = UIImageOrientationDown;
+                    break;
+            }
+            defaultImage = [UIImage imageWithCGImage:[defaultImage CGImage] scale:imageScale orientation: newImgOrientation ];
+            if (imageScale > 1.5) {
+                contentMode = UIViewContentModeCenter;
+            }
+        } else {
+            // DO NOT rotate image, we're NOT in background!;
+        }
+    }
 
 	if(imageSize.width == newFrame.size.width)
 	{
@@ -363,9 +385,9 @@ -(void)rotateDefaultImageViewToOrientation: (UIInterfaceOrientation )newOrientat
 			newFrame.size.height += overheight;
 		}
 	}
-	[defaultImageView setContentMode:contentMode];
-	[defaultImageView setImage:defaultImage];
-	[defaultImageView setFrame:newFrame];
+	[theImageView setContentMode:contentMode];
+	[theImageView setImage:defaultImage];
+	[theImageView setFrame:newFrame];
 }
 
 #pragma mark - Keyboard Control
@@ -1319,7 +1341,7 @@ -(void)willAnimateRotationToInterfaceOrientation:(UIInterfaceOrientation)toInter
         [thisWindow willAnimateRotationToInterfaceOrientation:toInterfaceOrientation duration:duration];
     }
     [self updateOrientationHistory:toInterfaceOrientation];
-    [self rotateDefaultImageViewToOrientation:toInterfaceOrientation];
+    [self rotateDefaultImageViewToOrientation:toInterfaceOrientation withImageView:defaultImageView];
     [super willAnimateRotationToInterfaceOrientation:toInterfaceOrientation duration:duration];
 }
 -(void)willRotateToInterfaceOrientation:(UIInterfaceOrientation)toInterfaceOrientation duration:(NSTimeInterval)duration