diff --git a/App_Resources/iOS/src/FaceclawEvenHubWebView.m b/App_Resources/iOS/src/FaceclawEvenHubWebView.m index 32f7bfd4..448a8da2 100644 --- a/App_Resources/iOS/src/FaceclawEvenHubWebView.m +++ b/App_Resources/iOS/src/FaceclawEvenHubWebView.m @@ -85,11 +85,14 @@ [_webView.bottomAnchor constraintEqualToAnchor:_host.safeAreaLayoutGuide.bottomAnchor] ]]; // Keep a nonzero attached view behind the dashboard; do not hide/detach it. + // Tick whenever iOS gives us execution time, including in the background or + // with the phone locked. Gating on UIApplicationStateActive stalls the + // injected timers/rAF even while BLE input can still evaluate JavaScript. // Bound host ticks to one evaluation in flight, including across suspension. __weak typeof(self) weakSelf = self; _timer = [NSTimer timerWithTimeInterval:1.0 / 60 repeats:YES block:^(NSTimer *timer) { typeof(self) strongSelf = weakSelf; - if (!strongSelf || strongSelf.ticking || UIApplication.sharedApplication.applicationState != UIApplicationStateActive) return; + if (!strongSelf || strongSelf.destroyed || strongSelf.ticking) return; strongSelf.ticking = YES; [strongSelf.webView evaluateJavaScript:@"window.__fcTimerTick && window.__fcTimerTick(); window.__fcRafTick && window.__fcRafTick();" completionHandler:^(id result, NSError *error) { weakSelf.ticking = NO; diff --git a/CHANGELOG b/CHANGELOG index b50ab386..2681bcf1 100644 --- a/CHANGELOG +++ b/CHANGELOG @@ -2,8 +2,10 @@ ## 0.7.3 - Future +### iOS port: * Add iOS calendar integration * iOS main screen matches the Android version's styling +* Hub apps on iOS no longer have their timers stopped while the phone app is in the background ## 0.7.2 - 2026-09-19 diff --git a/tests/README.md b/tests/README.md index 98f99845..f25877db 100644 --- a/tests/README.md +++ b/tests/README.md @@ -25,3 +25,15 @@ which now call the Kotlin implementation from Android host tests. Common tests also run as native iOS simulator binaries. See [the Kotlin README](../native/kotlin/README.md) for SDK requirements, source layout and coverage. The compass and battery fixtures retain the golden packets shared with firmware tests. + +The native iOS EvenHub probe runs separately on a booted simulator: + + node tests/ios-evenhub-native.cjs + +It compiles the production WKWebView host into an isolated app and checks local +and remote loading, document-start injection, assets, storage and navigation. +It then opens Safari to background the probe and verifies that injected timeouts, +intervals and animation callbacks still fire, and cancelled timers stay cancelled. +A short UIKit background task keeps the test process running without glasses. +This covers the ticker's background behavior; sustained execution with BLE and a +locked physical phone still requires device testing. diff --git a/tests/ios-evenhub-native.cjs b/tests/ios-evenhub-native.cjs index edb0b218..e4723e8d 100644 --- a/tests/ios-evenhub-native.cjs +++ b/tests/ios-evenhub-native.cjs @@ -39,17 +39,32 @@ const server = http.createServer((request, response) => { response.setHeader('Content-Type', file.endsWith('.js') ? 'text/javascript' : file.endsWith('.json') ? 'application/json' : file.endsWith('.png') ? 'image/png' : 'text/html'); response.end(fs.readFileSync(file)); }); -server.listen(0, '127.0.0.1', () => { -fs.writeFileSync(path.join(bundle, 'remote.txt'), `http://127.0.0.1:${server.address().port}/`); -const device = process.argv[2] || 'booted'; -execFileSync('xcrun', ['simctl', 'install', device, bundle], { stdio: 'inherit' }); -execFileSync('xcrun', ['simctl', 'launch', '--terminate-running-process', device, 'com.faceclaw.evenhub-probe'], { stdio: 'inherit' }); -const container = execFileSync('xcrun', ['simctl', 'get_app_container', device, 'com.faceclaw.evenhub-probe', 'data'], { encoding: 'utf8' }).trim(); -const resultFile = path.join(container, 'Documents/result.json'); -setTimeout(() => { - const result = JSON.parse(fs.readFileSync(resultFile, 'utf8')); - console.log(JSON.stringify({ work, ...result })); - if (!result.passed) process.exitCode = 1; - server.closeAllConnections(); server.close(); -}, 23000); +server.listen(0, '127.0.0.1', async () => { + try { + fs.writeFileSync(path.join(bundle, 'remote.txt'), `http://127.0.0.1:${server.address().port}/`); + const device = process.argv[2] || 'booted'; + execFileSync('xcrun', ['simctl', 'install', device, bundle], { stdio: 'inherit' }); + const container = execFileSync('xcrun', ['simctl', 'get_app_container', device, 'com.faceclaw.evenhub-probe', 'data'], { encoding: 'utf8' }).trim(); + const resultFile = path.join(container, 'Documents/result.json'); + const readyFile = path.join(container, 'Documents/background-ready.json'); + for (const file of [resultFile, readyFile]) fs.rmSync(file, { force: true }); + execFileSync('xcrun', ['simctl', 'launch', '--terminate-running-process', device, 'com.faceclaw.evenhub-probe'], { stdio: 'inherit' }); + let backgrounded = false; + const deadline = Date.now() + 50000; + while (!fs.existsSync(resultFile)) { + if (Date.now() > deadline) throw new Error(`EvenHub probe timed out (backgrounded=${backgrounded}); artifacts: ${work}`); + if (!backgrounded && fs.existsSync(readyFile)) { + execFileSync('xcrun', ['simctl', 'launch', device, 'com.apple.mobilesafari'], { stdio: 'inherit' }); + backgrounded = true; + } + await new Promise(resolve => setTimeout(resolve, 100)); + } + const result = JSON.parse(fs.readFileSync(resultFile, 'utf8')); + console.log(JSON.stringify({ work, ...result })); + if (!result.passed) process.exitCode = 1; + } catch (error) { + console.error(error); process.exitCode = 1; + } finally { + server.closeAllConnections(); server.close(); + } }); diff --git a/tests/native/ios-evenhub-test.m b/tests/native/ios-evenhub-test.m index 3a745d72..a842652c 100644 --- a/tests/native/ios-evenhub-test.m +++ b/tests/native/ios-evenhub-test.m @@ -7,9 +7,18 @@ @property(nonatomic) FaceclawEvenHubWebView *host; @property(nonatomic) NSMutableSet *seen; @property(nonatomic) NSInteger phase; +@property(nonatomic) UIBackgroundTaskIdentifier backgroundTask; +@property(nonatomic) NSInteger backgroundIntervals; +@property(nonatomic) BOOL foregroundPassed; @end @implementation Probe +- (void)writeResult:(NSDictionary *)result name:(NSString *)name { + NSData *data = [NSJSONSerialization dataWithJSONObject:result options:0 error:nil]; + NSString *documents = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).firstObject; + [data writeToFile:[documents stringByAppendingPathComponent:name] atomically:YES]; +} - (BOOL)application:(UIApplication *)app didFinishLaunchingWithOptions:(NSDictionary *)options { + self.backgroundTask = UIBackgroundTaskInvalid; self.window = [[UIWindow alloc] initWithFrame:UIScreen.mainScreen.bounds]; self.window.rootViewController = [UIViewController new]; self.window.rootViewController.view.backgroundColor = UIColor.whiteColor; @@ -27,6 +36,12 @@ [weakSelf.seen addObject:event[@"name"]]; [weakSelf.seen addObject:[NSString stringWithFormat:@"%ld:%@", (long)weakSelf.phase, event[@"name"]]]; [weakSelf.host evaluate:[NSString stringWithFormat:@"window.__fcResolve(%@,true,true)", event[@"id"]]]; + if (UIApplication.sharedApplication.applicationState == UIApplicationStateBackground) { + [weakSelf.seen addObject:[@"background:" stringByAppendingString:event[@"name"]]]; + if ([event[@"name"] isEqual:@"interval"]) weakSelf.backgroundIntervals++; + } + if (weakSelf.phase == 6 && [event[@"name"] isEqual:@"timer"]) + [weakSelf writeResult:@{@"ready": @YES} name:@"background-ready.json"]; } }; NSString *root = NSBundle.mainBundle.resourcePath; @@ -53,14 +68,41 @@ BOOL passed = [[NSSet setWithArray:required] isSubsetOfSet:self.seen] && ![self.seen containsObject:@"UNTRUSTED"]; NSString *signature = [FaceclawCrypto hmacSha256:@"key" message:@"The quick brown fox jumps over the lazy dog"]; passed &= [signature isEqual:@"97yD9DBThCSxMpjmqm+xQ+9NWaFJRhdZl0edvC0aPNg="]; + self.foregroundPassed = passed; + void (^handler)(NSString *) = self.host.eventHandler; [self.host showOnPhone]; [self.host hideOnPhone]; [self.host destroy]; - NSDictionary *result = @{@"passed": @(passed), @"seen": self.seen.allObjects}; - NSData *data = [NSJSONSerialization dataWithJSONObject:result options:0 error:nil]; - NSString *documents = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).firstObject; - [data writeToFile:[documents stringByAppendingPathComponent:@"result.json"] atomically:YES]; - NSLog(@"EHPROBE RESULT %@", result); + self.phase = 6; self.host = [FaceclawEvenHubWebView new]; + self.host.eventHandler = handler; + [self.host start:[root stringByAppendingPathComponent:@"dist"] entrypoint:@"index.html" script:script]; }); return YES; } +- (void)applicationDidEnterBackground:(UIApplication *)app { + if (self.phase != 6) return; + // Give the isolated probe a brief execution window without requiring BLE. + // Production relies on Faceclaw's existing background execution support. + self.backgroundTask = [app beginBackgroundTaskWithName:@"EvenHub timer regression" expirationHandler:^{ + [app endBackgroundTask:self.backgroundTask]; self.backgroundTask = UIBackgroundTaskInvalid; + }]; + [self.host evaluate:@"flutter_inappwebview.callHandler('input');" + "setTimeout(function(){flutter_inappwebview.callHandler('timeout')},100);" + "var count=0; var interval=setInterval(function(){flutter_inappwebview.callHandler('interval');if(++count===3)clearInterval(interval)},100);" + "requestAnimationFrame(function(){flutter_inappwebview.callHandler('animation')});" + "var cancelled=setTimeout(function(){flutter_inappwebview.callHandler('CANCELLED')},100);clearTimeout(cancelled);"]; + dispatch_after(dispatch_time(DISPATCH_TIME_NOW, 2 * NSEC_PER_SEC), dispatch_get_main_queue(), ^{ + NSArray *required = @[@"background:input", @"background:timeout", @"background:interval", @"background:animation"]; + BOOL passed = self.foregroundPassed && app.applicationState == UIApplicationStateBackground && + [[NSSet setWithArray:required] isSubsetOfSet:self.seen] && self.backgroundIntervals == 3 && + ![self.seen containsObject:@"CANCELLED"]; + [self.host destroy]; + NSDictionary *result = @{@"passed": @(passed), @"seen": self.seen.allObjects, + @"backgroundIntervals": @(self.backgroundIntervals)}; + [self writeResult:result name:@"result.json"]; + NSLog(@"EHPROBE RESULT %@", result); + if (self.backgroundTask != UIBackgroundTaskInvalid) { + [app endBackgroundTask:self.backgroundTask]; self.backgroundTask = UIBackgroundTaskInvalid; + } + }); +} @end int main(int argc, char **argv) { @autoreleasepool { return UIApplicationMain(argc, argv, nil, NSStringFromClass(Probe.class)); } }