feat: add tvOS build and run support

Author: LorenzGit

lib/bootstrap.ts

@@ -183,6 +183,7 @@ injector.requireCommand("run|ios", "./commands/run");
 injector.requireCommand("run|android", "./commands/run");
 injector.requireCommand("run|vision", "./commands/run");
 injector.requireCommand("run|visionos", "./commands/run");
+injector.requireCommand("run|tvos", "./commands/run");
 injector.requireCommand("typings", "./commands/typings");
 
 injector.requireCommand("preview", "./commands/preview");
@@ -198,6 +199,7 @@ injector.requireCommand("build|ios", "./commands/build");
 injector.requireCommand("build|android", "./commands/build");
 injector.requireCommand("build|vision", "./commands/build");
 injector.requireCommand("build|visionos", "./commands/build");
+injector.requireCommand("build|tvos", "./commands/build");
 injector.requireCommand("deploy", "./commands/deploy");
 
 injector.requireCommand("embed", "./commands/embedding/embed");

lib/commands/build.ts

@@ -278,3 +278,58 @@ export class BuildVisionOsCommand extends BuildIosCommand implements ICommand {
 
 injector.registerCommand("build|vision", BuildVisionOsCommand);
 injector.registerCommand("build|visionos", BuildVisionOsCommand);
+
+export class BuildTvOsCommand extends BuildVisionOsCommand implements ICommand {
+	// The injector resolves dependencies by constructor parameter name, so the
+	// constructor has to be spelled out even though it only forwards.
+	constructor(
+		protected $options: IOptions,
+		$errors: IErrors,
+		$projectData: IProjectData,
+		$platformsDataService: IPlatformsDataService,
+		$devicePlatformsConstants: Mobile.IDevicePlatformsConstants,
+		$buildController: IBuildController,
+		$platformValidationService: IPlatformValidationService,
+		$logger: ILogger,
+		$buildDataService: IBuildDataService,
+		protected $migrateController: IMigrateController,
+	) {
+		super(
+			$options,
+			$errors,
+			$projectData,
+			$platformsDataService,
+			$devicePlatformsConstants,
+			$buildController,
+			$platformValidationService,
+			$logger,
+			$buildDataService,
+			$migrateController,
+		);
+	}
+
+	public async execute(args: string[]): Promise<void> {
+		await this.executeCore([this.$devicePlatformsConstants.tvOS.toLowerCase()]);
+	}
+
+	public async canExecute(args: string[]): Promise<boolean> {
+		const platform = this.$devicePlatformsConstants.tvOS;
+		if (!this.$options.force) {
+			await this.$migrateController.validate({
+				projectDir: this.$projectData.projectDir,
+				platforms: [platform],
+			});
+		}
+
+		super.validatePlatform(platform);
+
+		let canExecute = await super.canExecuteCommandBase(platform);
+		if (canExecute) {
+			canExecute = await super.validateArgs(args, platform);
+		}
+
+		return canExecute;
+	}
+}
+
+injector.registerCommand("build|tvos", BuildTvOsCommand);

lib/commands/run.ts

@@ -223,3 +223,29 @@ export class RunVisionOSCommand extends RunIosCommand {
 
 injector.registerCommand("run|vision", RunVisionOSCommand);
 injector.registerCommand("run|visionos", RunVisionOSCommand);
+
+export class RunTvOSCommand extends RunVisionOSCommand {
+	public get platform(): string {
+		return this.$devicePlatformsConstants.tvOS;
+	}
+
+	constructor(
+		protected $devicePlatformsConstants: Mobile.IDevicePlatformsConstants,
+		protected $errors: IErrors,
+		protected $injector: IInjector,
+		protected $options: IOptions,
+		protected $platformValidationService: IPlatformValidationService,
+		protected $projectDataService: IProjectDataService
+	) {
+		super(
+			$devicePlatformsConstants,
+			$errors,
+			$injector,
+			$options,
+			$platformValidationService,
+			$projectDataService
+		);
+	}
+}
+
+injector.registerCommand("run|tvos", RunTvOSCommand);

lib/common/definitions/mobile.d.ts

@@ -1106,6 +1106,7 @@ declare global {
 			isAndroidPlatform(platform: string): boolean;
 			isiOSPlatform(platform: string): boolean;
 			isvisionOSPlatform(platform: string): boolean;
+			istvOSPlatform(platform: string): boolean;
 			isApplePlatform(platform: string): boolean;
 			normalizePlatformName(platform: string): string;
 			validatePlatformName(platform: string): string;
@@ -1150,10 +1151,12 @@ declare global {
 			iOS: string;
 			Android: string;
 			visionOS: string;
+			tvOS: string;
 
 			isiOS(value: string): boolean;
 			isAndroid(value: string): boolean;
 			isvisionOS(value: string): boolean;
+			istvOS(value: string): boolean;
 		}
 
 		interface IDeviceApplication {

lib/common/mobile/device-platforms-constants.ts

@@ -6,6 +6,7 @@ export class DevicePlatformsConstants
 	public iOS = "iOS";
 	public Android = "Android";
 	public visionOS = "visionOS";
+	public tvOS = "tvOS";
 
 	public isiOS(value: string) {
 		return value.toLowerCase() === this.iOS.toLowerCase();
@@ -18,5 +19,9 @@ export class DevicePlatformsConstants
 	public isvisionOS(value: string) {
 		return value.toLowerCase() === this.visionOS.toLowerCase();
 	}
+
+	public istvOS(value: string) {
+		return value.toLowerCase() === this.tvOS.toLowerCase();
+	}
 }
 injector.register("devicePlatformsConstants", DevicePlatformsConstants);

lib/common/mobile/ios/device/ios-device.ts

@@ -159,6 +159,9 @@ export class IOSDevice extends IOSDeviceBase {
 			} else if (_.startsWith(productType, "realitydevice")) {
 				// visionos
 				isArm64Architecture = true;
+			} else if (_.startsWith(productType, "appletv")) {
+				// tvos (Apple TV HD and later are arm64)
+				isArm64Architecture = true;
 			}
 
 			activeArchitecture = isArm64Architecture ? "arm64" : "armv7";
@@ -173,6 +176,10 @@ export class IOSDevice extends IOSDeviceBase {
 			// visionos
 			return this.$devicePlatformsConstants.visionOS;
 		}
+		if (_.startsWith(productType, "appletv")) {
+			// tvos
+			return this.$devicePlatformsConstants.tvOS;
+		}
 		return this.$devicePlatformsConstants.iOS;
 	}
 }

lib/common/mobile/ios/simulator/ios-emulator-services.ts

@@ -24,14 +24,14 @@ class IosEmulatorServices implements Mobile.IiOSSimulatorService {
 
 		try {
 			if (
-				options.platform === this.$devicePlatformsConstants.visionOS &&
+				(options.platform === this.$devicePlatformsConstants.visionOS ||
+					options.platform === this.$devicePlatformsConstants.tvOS) &&
 				!options.emulatorIdOrName
 			) {
-				// find first available visionOS simulator (for now).
+				// find first available visionOS / tvOS simulator (for now).
 				const { devices } = await this.tryGetiOSSimDevices();
 				options.emulatorIdOrName = devices.find(
-					(device) =>
-						device.platform === this.$devicePlatformsConstants.visionOS
+					(device) => device.platform === options.platform
 				)?.id;
 			}
 

lib/common/mobile/log-filter.ts

@@ -44,7 +44,9 @@ export class LogFilter implements Mobile.ILogFilter {
 				platform.toLowerCase() ===
 					this.$devicePlatformsConstants.iOS.toLowerCase() ||
 				platform.toLowerCase() ===
-					this.$devicePlatformsConstants.visionOS.toLowerCase()
+					this.$devicePlatformsConstants.visionOS.toLowerCase() ||
+				platform.toLowerCase() ===
+					this.$devicePlatformsConstants.tvOS.toLowerCase()
 			) {
 				return this.$injector.resolve("iOSLogFilter");
 			} else if (

lib/common/mobile/mobile-core/devices-service.ts

@@ -831,15 +831,14 @@ export class DevicesService
 			}
 		}
 
-		// make sure if the target platform is visionOS we don't try to run it on an already running iOS simulator...
+		// make sure if the target platform is visionOS or tvOS we don't try to run it on an already running iOS simulator...
 		if (
-			data.platform === this.$devicePlatformsConstants.visionOS &&
+			(data.platform === this.$devicePlatformsConstants.visionOS ||
+				data.platform === this.$devicePlatformsConstants.tvOS) &&
 			deviceInstances.length
 		) {
 			const runningDeviceInstance = deviceInstances.find(
-				(device) =>
-					device.deviceInfo.platform ===
-					this.$devicePlatformsConstants.visionOS,
+				(device) => device.deviceInfo.platform === data.platform,
 			);
 			if (!runningDeviceInstance) {
 				return this.startEmulatorCore(data);

lib/common/mobile/mobile-core/ios-device-discovery.ts

@@ -28,7 +28,10 @@ export class IOSDeviceDiscovery extends DeviceDiscovery {
 			return;
 		}
 
-		if (this.$mobileHelper.isvisionOSPlatform(options.platform)) {
+		if (
+			this.$mobileHelper.isvisionOSPlatform(options.platform) ||
+			this.$mobileHelper.istvOSPlatform(options.platform)
+		) {
 			// look for ios devices - same logic.
 			options.platform = this.$devicePlatformsConstants.iOS;
 		}