NR-199912: Adds NRFeatureFlag_BackgroundInstrumentation to NewRelicFeatureFlags and NRMAFlags

Author: cdillard-NewRelic

Agent/FeatureFlags/NRMAFlags.h

@@ -51,6 +51,8 @@
 
 + (BOOL) shouldEnableNewEventSystem;
 
++ (BOOL) shouldEnableBackgroundInstrumentation;
+
 + (NSArray<NSString*>*) namesForFlags:(NRMAFeatureFlags)flags;
 
 // Private Setting

Agent/FeatureFlags/NRMAFlags.m

@@ -168,6 +168,11 @@ + (BOOL) shouldEnableLogReporting {
 + (BOOL) shouldEnableNewEventSystem {
     return ([NRMAFlags featureFlags] & NRFeatureFlag_NewEventSystem) != 0;
 }
+
++ (BOOL) shouldEnableBackgroundInstrumentation {
+    return ([NRMAFlags featureFlags] & NRFeatureFlag_BackgroundInstrumentation) != 0;
+}
+
 + (NSArray<NSString*>*) namesForFlags:(NRMAFeatureFlags)flags {
     NSMutableArray *retArray = [NSMutableArray array];
     if ((flags & NRFeatureFlag_InteractionTracing) == NRFeatureFlag_InteractionTracing) {
@@ -226,6 +231,10 @@ + (BOOL) shouldEnableNewEventSystem {
     if ((flags & NRFeatureFlag_NewEventSystem) == NRFeatureFlag_NewEventSystem) {
         [retArray addObject:@"NewEventSystem"];
     }
+    if ((flags & NRFeatureFlag_BackgroundInstrumentation) == NRFeatureFlag_BackgroundInstrumentation) {
+        [retArray addObject:@"BackgroundInstrumentation"];
+    }
+    
     return retArray;
 }
 

Agent/General/NewRelicAgentInternal.m

@@ -151,13 +151,15 @@ - (id) initWithCollectorAddress:(NSString*)collectorHost
     if (self) {
 
 
-        // TODO: Check if this is the right place for this code?
-        if (@available(iOS 13.0, *)) {
-            [[BGTaskScheduler sharedScheduler] registerForTaskWithIdentifier:@"com.newrelic.NRApp.bitcode" usingQueue:nil launchHandler:^(__kindof BGTask * _Nonnull task) {
-                [self handleAppRefreshTask: task];
-            }];
-        } else {
-            // Fallback on earlier versions
+        if ([NRMAFlags shouldEnableBackgroundInstrumentation]) {
+            // TODO: Check if this is the right place for this code?
+            if (@available(iOS 13.0, *)) {
+                [[BGTaskScheduler sharedScheduler] registerForTaskWithIdentifier:@"com.newrelic.NRApp.bitcode" usingQueue:nil launchHandler:^(__kindof BGTask * _Nonnull task) {
+                    [self handleAppRefreshTask: task];
+                }];
+            } else {
+                // Fallback on earlier versions
+            }
         }
 
 
@@ -198,9 +200,11 @@ - (id) initWithCollectorAddress:(NSString*)collectorHost
                                                      selector:@selector(applicationWillTerminate)
                                                          name:UIApplicationWillTerminateNotification
                                                        object:[UIApplication sharedApplication]];
-            
-            // TODO: Is this the right place to put this?
-            [[UIApplication sharedApplication] setMinimumBackgroundFetchInterval:UIApplicationBackgroundFetchIntervalMinimum];
+
+            if ([NRMAFlags shouldEnableBackgroundInstrumentation]) {
+                // TODO: Is this the right place to put this?
+                [[UIApplication sharedApplication] setMinimumBackgroundFetchInterval:UIApplicationBackgroundFetchIntervalMinimum];
+            }
 
             NRLOG_INFO(@"Agent enabled");
 
@@ -721,9 +725,13 @@ - (void) applicationDidEnterBackground {
 
                     // What would happen if we didn't call agentShutdown?
 
-                    NRLOG_VERBOSE(@"used to agentShutdown.");
 
-                   // [self agentShutdown];
+                    if ([NRMAFlags shouldEnableBackgroundInstrumentation]) {
+                        NRLOG_VERBOSE(@"used to agentShutdown. Continuing since BackgroundInstrumentation enabled.");
+                    }
+                    else {
+                         [self agentShutdown];
+                    }
                 }
 #endif
 
@@ -733,10 +741,10 @@ - (void) applicationDidEnterBackground {
                 // Invalidate the background_task.
                 background_task = UIBackgroundTaskInvalid;
 
-
-
-                // Schedule the next background harvest.
-                [self scheduleHeartbeatTask];
+                if ([NRMAFlags shouldEnableBackgroundInstrumentation]) {
+                    // Schedule the next background harvest.
+                    [self scheduleHeartbeatTask];
+                }
             }
         });
     } else {
@@ -770,7 +778,7 @@ - (void) agentShutdown {
     [NRMALastActivityTraceController clearLastActivityStamp];
 }
 
-// We only support background featch in iOS 13+
+// We only support background fetch in iOS 13+
 - (void) scheduleHeartbeatTask {
     if (@available(iOS 13.0, *)) {
         // TODO: Pass instrumented app bundle id

Agent/Public/NewRelicFeatureFlags.h

@@ -99,4 +99,6 @@ typedef NS_OPTIONS(unsigned long long, NRMAFeatureFlags){
 
     // NOTE: Temporarily removed NRFeatureFlag_LogReporting
     NRFeatureFlag_NewEventSystem                        = 1 << 20, // Disabled by default
+    NRFeatureFlag_BackgroundInstrumentation             = 1 << 21, // Disabled by default
+
 };

Test Harness/NRTestApp/NRTestApp/AppDelegate.swift

@@ -35,8 +35,11 @@ class AppDelegate: UIResponder, UIApplicationDelegate {
 
 //        NewRelic.enableFeatures([NRMAFeatureFlags.NRFeatureFlag_NewEventSystem])
 
+        NewRelic.enableFeatures([NRMAFeatureFlags.NRFeatureFlag_BackgroundInstrumentation])
+
         NewRelic.replaceDeviceIdentifier("myDeviceId")
 
+        NewRelic.setMaxEventPoolSize(5000)
         NewRelic.setMaxEventBufferTime(60)
 
         if ProcessInfo.processInfo.environment["UITesting"] != nil {

Tests/Unit-Tests/NewRelicAgentTests/Feature-Flags-Tests/NRMAFeatureFlagsTests.m

@@ -249,4 +249,17 @@ - (void) testFedRampSupportEnable
 
     XCTAssertFalse([NRMAFlags shouldEnableFedRampSupport], @"FedRamp Support should be disabled");
 }
+
+- (void) testBackgroundInstrumentationEnable
+{
+    XCTAssertFalse([NRMAFlags shouldEnableBackgroundInstrumentation], @"Since no flags have been set, BackgroundInstrumentation Support should be false");
+
+    [NRMAFlags enableFeatures:NRFeatureFlag_BackgroundInstrumentation];
+
+    XCTAssertTrue([NRMAFlags shouldEnableBackgroundInstrumentation], @"BackgroundInstrumentation Should be enabled");
+
+    [NRMAFlags disableFeatures:NRFeatureFlag_BackgroundInstrumentation];
+
+    XCTAssertFalse([NRMAFlags shouldEnableBackgroundInstrumentation], @"BackgroundInstrumentation should be disabled");
+}
 @end