xref: /expo/ios/Exponent/Kernel/Core/EXKernel.m (revision d2210950)
10fbf6a33SBen Roth// Copyright 2015-present 650 Industries. All rights reserved.
20fbf6a33SBen Roth
30fbf6a33SBen Roth#import "EXAnalytics.h"
40fbf6a33SBen Roth#import "EXAppState.h"
50187d3b3SBen Roth#import "EXAppViewController.h"
6e791dcdeSBen Roth#import "EXBuildConstants.h"
70fbf6a33SBen Roth#import "EXFrame.h"
80fbf6a33SBen Roth#import "EXKernel.h"
989c6c39cSEric Samelson#import "EXKernelAppRecord.h"
10b05926a2SBen Roth#import "EXKernelLinkingManager.h"
110fbf6a33SBen Roth#import "EXLinkingManager.h"
120fbf6a33SBen Roth#import "EXVersions.h"
130fbf6a33SBen Roth
140fbf6a33SBen Roth#import <React/RCTBridge+Private.h>
150fbf6a33SBen Roth#import <React/RCTEventDispatcher.h>
160fbf6a33SBen Roth#import <React/RCTModuleData.h>
170fbf6a33SBen Roth#import <React/RCTUtils.h>
180fbf6a33SBen Roth
190fbf6a33SBen RothNS_ASSUME_NONNULL_BEGIN
200fbf6a33SBen Roth
210fbf6a33SBen RothNSString *kEXKernelErrorDomain = @"EXKernelErrorDomain";
220fbf6a33SBen RothNSString *kEXKernelShouldForegroundTaskEvent = @"foregroundTask";
230fbf6a33SBen RothNSString * const kEXDeviceInstallUUIDKey = @"EXDeviceInstallUUIDKey";
240fbf6a33SBen RothNSString * const kEXKernelClearJSCacheUserDefaultsKey = @"EXKernelClearJSCacheUserDefaultsKey";
250fbf6a33SBen Roth
2689c6c39cSEric Samelson@interface EXKernel () <EXKernelAppRegistryDelegate>
270fbf6a33SBen Roth
280fbf6a33SBen Roth@end
290fbf6a33SBen Roth
300fbf6a33SBen Roth@implementation EXKernel
310fbf6a33SBen Roth
320fbf6a33SBen Roth+ (instancetype)sharedInstance
330fbf6a33SBen Roth{
340fbf6a33SBen Roth  static EXKernel *theKernel;
350fbf6a33SBen Roth  static dispatch_once_t once;
360fbf6a33SBen Roth  dispatch_once(&once, ^{
370fbf6a33SBen Roth    if (!theKernel) {
380fbf6a33SBen Roth      theKernel = [[EXKernel alloc] init];
390fbf6a33SBen Roth    }
400fbf6a33SBen Roth  });
410fbf6a33SBen Roth  return theKernel;
420fbf6a33SBen Roth}
430fbf6a33SBen Roth
440fbf6a33SBen Roth- (instancetype)init
450fbf6a33SBen Roth{
460fbf6a33SBen Roth  if (self = [super init]) {
4789c6c39cSEric Samelson    // init app registry: keep track of RN bridges we are running
4889c6c39cSEric Samelson    _appRegistry = [[EXKernelAppRegistry alloc] init];
4989c6c39cSEric Samelson    _appRegistry.delegate = self;
509f8d9b9dSBen Roth
519f8d9b9dSBen Roth    // init service registry: classes which manage shared resources among all bridges
52d7f51e5eSBen Roth    _serviceRegistry = [[EXKernelServiceRegistry alloc] init];
539f8d9b9dSBen Roth
540fbf6a33SBen Roth    for (NSString *name in @[UIApplicationDidBecomeActiveNotification,
550fbf6a33SBen Roth                             UIApplicationDidEnterBackgroundNotification,
560fbf6a33SBen Roth                             UIApplicationDidFinishLaunchingNotification,
570fbf6a33SBen Roth                             UIApplicationWillResignActiveNotification,
580fbf6a33SBen Roth                             UIApplicationWillEnterForegroundNotification]) {
590fbf6a33SBen Roth
600fbf6a33SBen Roth      [[NSNotificationCenter defaultCenter] addObserver:self
610fbf6a33SBen Roth                                               selector:@selector(_handleAppStateDidChange:)
620fbf6a33SBen Roth                                                   name:name
630fbf6a33SBen Roth                                                 object:nil];
640fbf6a33SBen Roth    }
652c229102SBen Roth    NSLog(@"Expo iOS Runtime Version %@", [EXBuildConstants sharedInstance].expoRuntimeVersion);
660fbf6a33SBen Roth  }
670fbf6a33SBen Roth  return self;
680fbf6a33SBen Roth}
690fbf6a33SBen Roth
700fbf6a33SBen Roth- (void)dealloc
710fbf6a33SBen Roth{
720fbf6a33SBen Roth  [[NSNotificationCenter defaultCenter] removeObserver:self];
730fbf6a33SBen Roth}
740fbf6a33SBen Roth
755daa5350SBen Roth#pragma mark - Misc
765daa5350SBen Roth
770fbf6a33SBen Roth+ (NSString *)deviceInstallUUID
780fbf6a33SBen Roth{
790fbf6a33SBen Roth  NSString *uuid = [[NSUserDefaults standardUserDefaults] stringForKey:kEXDeviceInstallUUIDKey];
800fbf6a33SBen Roth  if (!uuid) {
810fbf6a33SBen Roth    uuid = [[NSUUID UUID] UUIDString];
820fbf6a33SBen Roth    [[NSUserDefaults standardUserDefaults] setObject:uuid forKey:kEXDeviceInstallUUIDKey];
830fbf6a33SBen Roth    [[NSUserDefaults standardUserDefaults] synchronize];
840fbf6a33SBen Roth  }
850fbf6a33SBen Roth  return uuid;
860fbf6a33SBen Roth}
870fbf6a33SBen Roth
889f8d9b9dSBen Roth#pragma mark - bridge registry delegate
899f8d9b9dSBen Roth
9089c6c39cSEric Samelson- (void)appRegistry:(EXKernelAppRegistry *)registry didRegisterAppRecord:(EXKernelAppRecord *)appRecord
919f8d9b9dSBen Roth{
929f8d9b9dSBen Roth  // forward to service registry
9389c6c39cSEric Samelson  [_serviceRegistry appRegistry:registry didRegisterAppRecord:appRecord];
949f8d9b9dSBen Roth}
959f8d9b9dSBen Roth
9689c6c39cSEric Samelson- (void)appRegistry:(EXKernelAppRegistry *)registry willUnregisterAppRecord:(EXKernelAppRecord *)appRecord
979f8d9b9dSBen Roth{
989f8d9b9dSBen Roth  // forward to service registry
9989c6c39cSEric Samelson  [_serviceRegistry appRegistry:registry willUnregisterAppRecord:appRecord];
1009f8d9b9dSBen Roth}
1019f8d9b9dSBen Roth
102f5e2fbc5SBen Roth#pragma mark - Interfacing with JS
103f5e2fbc5SBen Roth
104f5e2fbc5SBen Roth- (void)sendUrl:(NSString *)urlString toAppRecord:(EXKernelAppRecord *)app
105f5e2fbc5SBen Roth{
106f5e2fbc5SBen Roth  // fire a Linking url event on this (possibly versioned) bridge
107f5e2fbc5SBen Roth  EXReactAppManager *appManager = app.appManager;
108f5e2fbc5SBen Roth  id linkingModule = [self nativeModuleForAppManager:appManager named:@"LinkingManager"];
109f5e2fbc5SBen Roth  if (!linkingModule) {
110f5e2fbc5SBen Roth    DDLogError(@"Could not find the Linking module to open URL (%@)", urlString);
111f5e2fbc5SBen Roth  } else if ([linkingModule respondsToSelector:@selector(dispatchOpenUrlEvent:)]) {
112f5e2fbc5SBen Roth    [linkingModule dispatchOpenUrlEvent:[NSURL URLWithString:urlString]];
113f5e2fbc5SBen Roth  } else {
114f5e2fbc5SBen Roth    DDLogError(@"Linking module doesn't support the API we use to open URL (%@)", urlString);
115f5e2fbc5SBen Roth  }
116f5e2fbc5SBen Roth  [self moveAppToVisible:app];
117f5e2fbc5SBen Roth}
1180fbf6a33SBen Roth
1195daa5350SBen Roth- (id)nativeModuleForAppManager:(EXReactAppManager *)appManager named:(NSString *)moduleName
1200fbf6a33SBen Roth{
1210fbf6a33SBen Roth  id destinationBridge = appManager.reactBridge;
1220fbf6a33SBen Roth
1230fbf6a33SBen Roth  if ([destinationBridge respondsToSelector:@selector(batchedBridge)]) {
1240fbf6a33SBen Roth    id batchedBridge = [destinationBridge batchedBridge];
1250fbf6a33SBen Roth    id moduleData = [batchedBridge moduleDataForName:moduleName];
1260fbf6a33SBen Roth
1270fbf6a33SBen Roth    // React Native before SDK 11 didn't strip the "RCT" prefix from module names
1280fbf6a33SBen Roth    if (!moduleData && ![moduleName hasPrefix:@"RCT"]) {
1290fbf6a33SBen Roth      moduleData = [batchedBridge moduleDataForName:[@"RCT" stringByAppendingString:moduleName]];
1300fbf6a33SBen Roth    }
1310fbf6a33SBen Roth
1320fbf6a33SBen Roth    if (moduleData) {
1330fbf6a33SBen Roth      return [moduleData instance];
1340fbf6a33SBen Roth    }
1350fbf6a33SBen Roth  } else {
136*d2210950SBen Roth    // bridge can be null if the record is in an error state and never created a bridge.
137*d2210950SBen Roth    if (destinationBridge) {
1380fbf6a33SBen Roth      DDLogError(@"Bridge does not support the API we use to get its underlying batched bridge");
1390fbf6a33SBen Roth    }
140*d2210950SBen Roth  }
1410fbf6a33SBen Roth  return nil;
1420fbf6a33SBen Roth}
1430fbf6a33SBen Roth
144c67a7dcdSBen Roth- (void)sendNotification:(NSDictionary *)notifBody
145c67a7dcdSBen Roth      toExperienceWithId:(NSString *)destinationExperienceId
146c67a7dcdSBen Roth          fromBackground:(BOOL)isFromBackground
147c67a7dcdSBen Roth                isRemote:(BOOL)isRemote
148c67a7dcdSBen Roth{
149c67a7dcdSBen Roth  EXKernelAppRecord *destinationApp = [_appRegistry newestRecordWithExperienceId:destinationExperienceId];
150c67a7dcdSBen Roth
151c67a7dcdSBen Roth  // if the notification came from the background, in most but not all cases, this means the user acted on an iOS notification
152c67a7dcdSBen Roth  // and caused the app to launch.
153c67a7dcdSBen Roth  // From SO:
154c67a7dcdSBen Roth  // > Note that "App opened from Notification" will be a false positive if the notification is sent while the user is on a different
155c67a7dcdSBen Roth  // > screen (for example, if they pull down the status bar and then receive a notification from your app).
156c67a7dcdSBen Roth  NSDictionary *bodyWithOrigin = @{
157c67a7dcdSBen Roth                                   @"origin": (isFromBackground) ? @"selected" : @"received",
158c67a7dcdSBen Roth                                   @"remote": @(isRemote),
159c67a7dcdSBen Roth                                   @"data": notifBody,
160c67a7dcdSBen Roth                                   };
161c67a7dcdSBen Roth  if (destinationApp) {
162c67a7dcdSBen Roth    // send the body to the already-open experience
163c67a7dcdSBen Roth    [self _dispatchJSEvent:@"Exponent.notification" body:bodyWithOrigin toApp:destinationApp];
164c67a7dcdSBen Roth    [self moveAppToVisible:destinationApp];
165c67a7dcdSBen Roth  } else {
166c67a7dcdSBen Roth    // no app is currently running for this experience id.
167c67a7dcdSBen Roth    // if we're Expo Client, we can query Home for a past experience in the user's history, and route the notification there.
168c67a7dcdSBen Roth    if (_browserController) {
169c67a7dcdSBen Roth      __weak typeof(self) weakSelf = self;
170c67a7dcdSBen Roth      [_browserController getHistoryUrlForExperienceId:destinationExperienceId completion:^(NSString *urlString) {
171c67a7dcdSBen Roth        if (urlString) {
172c67a7dcdSBen Roth          NSURL *url = [NSURL URLWithString:urlString];
173c67a7dcdSBen Roth          if (url) {
174c67a7dcdSBen Roth            [weakSelf createNewAppWithUrl:url initialProps:@{ @"notification": bodyWithOrigin }];
175c67a7dcdSBen Roth          }
176c67a7dcdSBen Roth        }
177c67a7dcdSBen Roth      }];
178c67a7dcdSBen Roth    }
179c67a7dcdSBen Roth  }
180c67a7dcdSBen Roth}
181c67a7dcdSBen Roth
1820fbf6a33SBen Roth/**
1830fbf6a33SBen Roth *  If the bridge has a batchedBridge or parentBridge selector, posts the notification on that object as well.
1840fbf6a33SBen Roth */
1850fbf6a33SBen Roth- (void)_postNotificationName: (NSNotificationName)name onAbstractBridge: (id)bridge
1860fbf6a33SBen Roth{
1870fbf6a33SBen Roth  [[NSNotificationCenter defaultCenter] postNotificationName:name object:bridge];
1880fbf6a33SBen Roth  if ([bridge respondsToSelector:@selector(batchedBridge)]) {
1890fbf6a33SBen Roth    [[NSNotificationCenter defaultCenter] postNotificationName:name object:[bridge batchedBridge]];
1900fbf6a33SBen Roth  } else if ([bridge respondsToSelector:@selector(parentBridge)]) {
1910fbf6a33SBen Roth    [[NSNotificationCenter defaultCenter] postNotificationName:name object:[bridge parentBridge]];
1920fbf6a33SBen Roth  }
1930fbf6a33SBen Roth}
1940fbf6a33SBen Roth
195c67a7dcdSBen Roth- (void)_dispatchJSEvent:(NSString *)eventName body:(NSDictionary *)eventBody toApp:(EXKernelAppRecord *)appRecord
196f148175aSBen Roth{
197c67a7dcdSBen Roth  [appRecord.appManager.reactBridge enqueueJSCall:@"RCTDeviceEventEmitter.emit"
198c67a7dcdSBen Roth                                             args:eventBody ? @[eventName, eventBody] : @[eventName]];
1990fbf6a33SBen Roth}
2000fbf6a33SBen Roth
2018a7f6184SBen Roth#pragma mark - App State
2028e3c2ccdSBen Roth
203c67a7dcdSBen Roth- (void)createNewAppWithUrl:(NSURL *)url initialProps:(nullable NSDictionary *)initialProps
204f5e2fbc5SBen Roth{
205c67a7dcdSBen Roth  NSString *recordId = [_appRegistry registerAppWithManifestUrl:url initialProps:initialProps];
206f5e2fbc5SBen Roth  EXKernelAppRecord *record = [_appRegistry recordForId:recordId];
207f5e2fbc5SBen Roth  [self moveAppToVisible:record];
208f5e2fbc5SBen Roth}
209f5e2fbc5SBen Roth
2107f6367d0SBen Roth- (void)switchTasks
2110fbf6a33SBen Roth{
2127f6367d0SBen Roth  if (!_browserController) {
2137f6367d0SBen Roth    return;
2146f62abf2SBen Roth  }
2156f62abf2SBen Roth
2167f6367d0SBen Roth  if (_visibleApp != _appRegistry.homeAppRecord) {
2177f6367d0SBen Roth    [EXUtil performSynchronouslyOnMainThread:^{
2187f6367d0SBen Roth      [_browserController toggleMenu];
2197f6367d0SBen Roth    }];
220b05926a2SBen Roth  } else {
2217f6367d0SBen Roth    EXKernelAppRegistry *appRegistry = [EXKernel sharedInstance].appRegistry;
2227f6367d0SBen Roth    for (NSString *recordId in appRegistry.appEnumerator) {
2237f6367d0SBen Roth      EXKernelAppRecord *record = [appRegistry recordForId:recordId];
2247f6367d0SBen Roth      // foreground the first thing we find
2257f6367d0SBen Roth      [self moveAppToVisible:record];
2267f6367d0SBen Roth    }
2277f6367d0SBen Roth  }
2287f6367d0SBen Roth}
2297f6367d0SBen Roth
2307f6367d0SBen Roth- (void)moveAppToVisible:(EXKernelAppRecord *)appRecord
2317f6367d0SBen Roth{
2327f6367d0SBen Roth  if (_browserController) {
2337f6367d0SBen Roth    [EXUtil performSynchronouslyOnMainThread:^{
2347f6367d0SBen Roth      [_browserController moveAppToVisible:appRecord];
2357f6367d0SBen Roth    }];
2367f6367d0SBen Roth  }
2377f6367d0SBen Roth}
2387f6367d0SBen Roth
2397f6367d0SBen Roth- (void)appDidBecomeVisible:(EXKernelAppRecord *)appRecord
2407f6367d0SBen Roth{
2417f6367d0SBen Roth  EXKernelAppRecord *appRecordPreviouslyVisible = _visibleApp;
2427f6367d0SBen Roth  if (appRecord != appRecordPreviouslyVisible) {
2437f6367d0SBen Roth    if (appRecordPreviouslyVisible) {
2440187d3b3SBen Roth      [appRecordPreviouslyVisible.viewController appDidBackground];
2457f6367d0SBen Roth      [self _postNotificationName:kEXKernelBridgeDidBackgroundNotification onAbstractBridge:appRecordPreviouslyVisible.appManager.reactBridge];
2467f6367d0SBen Roth      id appStateModule = [self nativeModuleForAppManager:appRecordPreviouslyVisible.appManager named:@"AppState"];
2470fbf6a33SBen Roth      if ([appStateModule respondsToSelector:@selector(setState:)]) {
2480fbf6a33SBen Roth        [appStateModule setState:@"background"];
2490fbf6a33SBen Roth      }
2500fbf6a33SBen Roth    }
2517f6367d0SBen Roth    if (appRecord) {
2520187d3b3SBen Roth      [appRecord.viewController appDidBecomeVisible];
2537f6367d0SBen Roth      [self _postNotificationName:kEXKernelBridgeDidForegroundNotification onAbstractBridge:appRecord.appManager.reactBridge];
2547f6367d0SBen Roth      id appStateModule = [self nativeModuleForAppManager:appRecord.appManager named:@"AppState"];
2550fbf6a33SBen Roth      if ([appStateModule respondsToSelector:@selector(setState:)]) {
2560fbf6a33SBen Roth        [appStateModule setState:@"active"];
2570fbf6a33SBen Roth      }
2587f6367d0SBen Roth      _visibleApp = appRecord;
2597f6367d0SBen Roth      [[EXAnalytics sharedInstance] logKernelAppVisibleEvent];
2600fbf6a33SBen Roth    } else {
2617f6367d0SBen Roth      _visibleApp = nil;
2627f6367d0SBen Roth    }
2637f6367d0SBen Roth
2647f6367d0SBen Roth    if (_visibleApp && _visibleApp != _appRegistry.homeAppRecord) {
2657f6367d0SBen Roth      [self _unregisterUnusedAppRecords];
2667f6367d0SBen Roth    }
2677f6367d0SBen Roth  }
2687f6367d0SBen Roth}
2697f6367d0SBen Roth
2707f6367d0SBen Roth- (void)_unregisterUnusedAppRecords
2717f6367d0SBen Roth{
2727f6367d0SBen Roth  for (NSString *recordId in _appRegistry.appEnumerator) {
2737f6367d0SBen Roth    EXKernelAppRecord *record = [_appRegistry recordForId:recordId];
2747f6367d0SBen Roth    if (record && record != _visibleApp) {
2757f6367d0SBen Roth      [_appRegistry unregisterAppWithRecordId:recordId];
2767f6367d0SBen Roth      break;
2770fbf6a33SBen Roth    }
2780fbf6a33SBen Roth  }
279b05926a2SBen Roth}
2800fbf6a33SBen Roth
2810fbf6a33SBen Roth- (void)_handleAppStateDidChange:(NSNotification *)notification
2820fbf6a33SBen Roth{
2830fbf6a33SBen Roth  NSString *newState;
2840fbf6a33SBen Roth
2850fbf6a33SBen Roth  if ([notification.name isEqualToString:UIApplicationWillResignActiveNotification]) {
2860fbf6a33SBen Roth    newState = @"inactive";
2870fbf6a33SBen Roth  } else if ([notification.name isEqualToString:UIApplicationWillEnterForegroundNotification]) {
2880fbf6a33SBen Roth    newState = @"background";
2890fbf6a33SBen Roth  } else {
2900fbf6a33SBen Roth    switch (RCTSharedApplication().applicationState) {
2910fbf6a33SBen Roth      case UIApplicationStateActive:
2920fbf6a33SBen Roth        newState = @"active";
2930fbf6a33SBen Roth        break;
2940fbf6a33SBen Roth      case UIApplicationStateBackground: {
2950fbf6a33SBen Roth        newState = @"background";
2960fbf6a33SBen Roth        break;
2970fbf6a33SBen Roth      }
2980fbf6a33SBen Roth      default: {
2990fbf6a33SBen Roth        newState = @"unknown";
3000fbf6a33SBen Roth        break;
3010fbf6a33SBen Roth      }
3020fbf6a33SBen Roth    }
3030fbf6a33SBen Roth  }
3040fbf6a33SBen Roth
3057f6367d0SBen Roth  if (_visibleApp) {
3067f6367d0SBen Roth    EXReactAppManager *appManager = _visibleApp.appManager;
3075daa5350SBen Roth    id appStateModule = [self nativeModuleForAppManager:appManager named:@"AppState"];
3080fbf6a33SBen Roth    NSString *lastKnownState;
3090fbf6a33SBen Roth    if ([appStateModule respondsToSelector:@selector(lastKnownState)]) {
3100fbf6a33SBen Roth      lastKnownState = [appStateModule lastKnownState];
3110fbf6a33SBen Roth    }
3120fbf6a33SBen Roth    if ([appStateModule respondsToSelector:@selector(setState:)]) {
3130fbf6a33SBen Roth      [appStateModule setState:newState];
3140fbf6a33SBen Roth    }
3150fbf6a33SBen Roth    if (!lastKnownState || ![newState isEqualToString:lastKnownState]) {
3160fbf6a33SBen Roth      if ([newState isEqualToString:@"active"]) {
3170187d3b3SBen Roth        [_visibleApp.viewController appDidBecomeVisible];
3187f6367d0SBen Roth        [self _postNotificationName:kEXKernelBridgeDidForegroundNotification onAbstractBridge:appManager.reactBridge];
3190fbf6a33SBen Roth      } else if ([newState isEqualToString:@"background"]) {
3200187d3b3SBen Roth        [_visibleApp.viewController appDidBackground];
3217f6367d0SBen Roth        [self _postNotificationName:kEXKernelBridgeDidBackgroundNotification onAbstractBridge:appManager.reactBridge];
3220fbf6a33SBen Roth      }
3230fbf6a33SBen Roth    }
3240fbf6a33SBen Roth  }
3250fbf6a33SBen Roth}
3260fbf6a33SBen Roth
3270fbf6a33SBen Roth@end
3280fbf6a33SBen Roth
3290fbf6a33SBen RothNS_ASSUME_NONNULL_END
330