NativeScript · shirakaba · Jul 30, 2025 · Jul 30, 2025 · Jul 30, 2025 · Aug 20, 2025
diff --git a/NativeScript/CMakeLists.txt b/NativeScript/CMakeLists.txt
@@ -305,6 +305,12 @@ if(TARGET_PLATFORM_MACOS)
 
   set(METADATA_FILE "metadata.macos.nsmd")
 elseif(TARGET_PLATFORM_IOS)
+  # Convert the Info.plist from binary format to XML format.
+  # This seemed to unblock a build error when using in React Native.
+  add_custom_command(TARGET ${NAME} POST_BUILD
+    COMMAND plutil -convert xml1 $<TARGET_FILE_DIR:${NAME}>/Info.plist
+  )
+
   if(TARGET_PLATFORM_SIM)
     set(METADATA_FILE "metadata.ios-sim.nsmd")
   else()

diff --git a/build_all_ios.sh b/build_all_ios.sh
@@ -1,14 +1,39 @@
 #!/bin/bash
 set -e
 
+TARGET_ENGINE=${TARGET_ENGINE:=v8} # default to v8 for compat
+
+# See build_nativescript.sh for all supported flags. This parent script is only
+# interested in --no-engine.
+for arg in $@; do
+  case $arg in
+    --v8) TARGET_ENGINE=v8 ;;
+    --quickjs) TARGET_ENGINE=quickjs ;;
+    --jsc) TARGET_ENGINE=jsc ;;
+    --hermes) TARGET_ENGINE=hermes ;;
+    --no-engine) TARGET_ENGINE=none ;;
+    *) ;;
+  esac
+done
+
 rm -rf ./dist
 # don't run if NO_UPDATE_VERSION is set
 # if [ -z "$NO_UPDATE_VERSION" ]; then
   # TODO: integrate version into runtime
   # ./update_version.sh
 # fi
 ./build_metadata_generator.sh
-./build_nativescript.sh --no-vision $1
+./build_nativescript.sh --no-vision $1 $2
 ./build_tklivesync.sh --no-vision
 ./prepare_dSYMs.sh
-./build_npm_ios.sh
+
+if [[ "$TARGET_ENGINE" == "none" ]]; then
+  # If you're building *with* --no-engine, you're trying to make an npm release
+  # of a workspace under ./packages/*, like @nativescript/ios-node-api.
+  echo "Skipping build_npm_ios.sh due to --no-engine flag."
+  echo "build_all_ios.sh finished!"
+else
+  # If you're building *without* --no-engine, you're trying to make an npm
+  # release of the root-level workspace, @nativescript/ios.
+  ./build_npm_ios.sh
+fi
diff --git a/build_all_vision.sh b/build_all_vision.sh
@@ -1,10 +1,35 @@
 #!/bin/bash
 set -e
 
+TARGET_ENGINE=${TARGET_ENGINE:=v8} # default to v8 for compat
+
+# See build_nativescript.sh for all supported flags. This parent script is only
+# interested in --no-engine.
+for arg in $@; do
+  case $arg in
+    --v8) TARGET_ENGINE=v8 ;;
+    --quickjs) TARGET_ENGINE=quickjs ;;
+    --jsc) TARGET_ENGINE=jsc ;;
+    --hermes) TARGET_ENGINE=hermes ;;
+    --no-engine) TARGET_ENGINE=none ;;
+    *) ;;
+  esac
+done
+
 rm -rf ./dist
 ./update_version.sh
 ./build_metadata_generator.sh
-./build_nativescript.sh --no-catalyst --no-iphone --no-sim
+./build_nativescript.sh --no-catalyst --no-iphone --no-sim $1
 ./build_tklivesync.sh --no-catalyst --no-iphone --no-sim
 ./prepare_dSYMs.sh
-./build_npm_vision.sh
+
+if [[ "$TARGET_ENGINE" == "none" ]]; then
+  # If you're building *with* --no-engine, you're trying to make an npm release
+  # of a workspace under ./packages/*, like @nativescript/ios-node-api.
+  echo "Skipping build_npm_vision.sh due to --no-engine flag."
+  echo "build_all_vision.sh finished!"
+else
+  # If you're building *without* --no-engine, you're trying to make an npm
+  # release of the root-level workspace, @nativescript/ios.
+  ./build_npm_vision.sh
+fi
diff --git a/build_nativescript.sh b/build_nativescript.sh
@@ -177,10 +177,22 @@ fi
 
 if [[ -n "${XCFRAMEWORKS[@]}" ]]; then
 
-checkpoint "Creating NativeScript.xcframework"
-OUTPUT_DIR="$DIST/NativeScript.xcframework"
-rm -rf $OUTPUT_DIR
-xcodebuild -create-xcframework ${XCFRAMEWORKS[@]} -output "$OUTPUT_DIR"
+
+if [[ "$TARGET_ENGINE" == "none" ]]; then
+  checkpoint "Creating the XCFramework (NativeScript.apple.node)"
+
+  # We adhere to the prebuilds standard as described here:
+  # https://github.com/callstackincubator/react-native-node-api/blob/9b231c14459b62d7df33360f930a00343d8c46e6/docs/PREBUILDS.md
+  OUTPUT_DIR="packages/ios/build/Release/NativeScript.apple.node"
+  rm -rf $OUTPUT_DIR
+  deno run -A ./scripts/build_xcframework.mts --output "$OUTPUT_DIR" ${XCFRAMEWORKS[@]}
+else
+  checkpoint "Creating NativeScript.xcframework"
+
+  OUTPUT_DIR="$DIST/NativeScript.xcframework"
+  rm -rf $OUTPUT_DIR
+  xcodebuild -create-xcframework ${XCFRAMEWORKS[@]} -output "$OUTPUT_DIR"
+fi
 
 fi
 

diff --git a/packages/ios/.gitignore b/packages/ios/.gitignore
@@ -0,0 +1 @@
+!build
diff --git a/packages/ios/NativeScript.podspec b/packages/ios/NativeScript.podspec
diff --git a/...ersal/NativeScript.xcframework/Info.plist → ...elease/NativeScript.apple.node/Info.plist b/...ersal/NativeScript.xcframework/Info.plist → ...elease/NativeScript.apple.node/Info.plist
@@ -8,32 +8,32 @@
 			<key>BinaryPath</key>
 			<string>NativeScript.framework/NativeScript</string>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64</string>
+			<string>ios-arm64_x86_64-simulator</string>
 			<key>LibraryPath</key>
 			<string>NativeScript.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
+				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
+			<key>SupportedPlatformVariant</key>
+			<string>simulator</string>
 		</dict>
 		<dict>
 			<key>BinaryPath</key>
 			<string>NativeScript.framework/NativeScript</string>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64_x86_64-simulator</string>
+			<string>ios-arm64</string>
 			<key>LibraryPath</key>
 			<string>NativeScript.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
-				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
-			<key>SupportedPlatformVariant</key>
-			<string>simulator</string>
 		</dict>
 	</array>
 	<key>CFBundlePackageType</key>

diff --git a/...d/Release/NativeScript.apple.node/ios-arm64/NativeScript.framework/Headers/NativeScript.h b/...d/Release/NativeScript.apple.node/ios-arm64/NativeScript.framework/Headers/NativeScript.h
@@ -0,0 +1,48 @@
+#ifndef NATIVESCRIPT_H
+#define NATIVESCRIPT_H
+
+#ifdef __cplusplus
+
+extern "C"
+
+#endif  // __cplusplus
+
+    void
+    nativescript_init(void* env, const char* metadata_path, const void* metadata_ptr);
+
+#ifdef __OBJC__
+
+#import <Foundation/Foundation.h>
+
+__attribute__((visibility("default")))
+@interface Config : NSObject
+
+@property(nonatomic, retain) NSString* BaseDir;
+@property(nonatomic, retain) NSString* ApplicationPath;
+@property(nonatomic) void* MetadataPtr;
+@property BOOL IsDebug;
+@property BOOL LogToSystemConsole;
+@property int ArgumentsCount;
+@property(nonatomic) char** Arguments;
+
+@end
+
+__attribute__((visibility("default")))
+@interface NativeScript : NSObject
+
+- (instancetype)initWithConfig:(Config*)config;
+- (void)runScriptString:(NSString*)script runLoop:(BOOL)runLoop;
+- (void)restartWithConfig:(Config*)config;
+- (void)shutdownRuntime;
+
+/**
+ WARNING: this method does not return in most applications. (UIApplicationMain)
+ */
+- (void)runMainApplication;
+- (bool)liveSync;
+
+@end
+
+#endif  // __OBJC__
+
+#endif /* NATIVESCRIPT_H */
diff --git a/...ges/ios/build/Release/NativeScript.apple.node/ios-arm64/NativeScript.framework/Info.plist b/...ges/ios/build/Release/NativeScript.apple.node/ios-arm64/NativeScript.framework/Info.plist
@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>BuildMachineOSBuild</key>
+	<string>23G93</string>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>English</string>
+	<key>CFBundleExecutable</key>
+	<string>NativeScript</string>
+	<key>CFBundleIdentifier</key>
+	<string>org.nativescript.runtime</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundlePackageType</key>
+	<string>FMWK</string>
+	<key>CFBundleShortVersionString</key>
+	<string>0.1.0</string>
+	<key>CFBundleSignature</key>
+	<string>????</string>
+	<key>CFBundleSupportedPlatforms</key>
+	<array>
+		<string>iPhoneOS</string>
+	</array>
+	<key>CFBundleVersion</key>
+	<string>0.1.0</string>
+	<key>CSResourcesFileMapped</key>
+	<true/>
+	<key>DTCompiler</key>
+	<string>com.apple.compilers.llvm.clang.1_0</string>
+	<key>DTPlatformBuild</key>
+	<string>22C146</string>
+	<key>DTPlatformName</key>
+	<string>iphoneos</string>
+	<key>DTPlatformVersion</key>
+	<string>18.2</string>
+	<key>DTSDKBuild</key>
+	<string>22C146</string>
+	<key>DTSDKName</key>
+	<string>iphoneos18.2</string>
+	<key>DTXcode</key>
+	<string>1620</string>
+	<key>DTXcodeBuild</key>
+	<string>16C5032a</string>
+	<key>MinimumOSVersion</key>
+	<string>13.0</string>
+	<key>UIDeviceFamily</key>
+	<array>
+		<integer>1</integer>
+		<integer>2</integer>
+	</array>
+	<key>UIRequiredDeviceCapabilities</key>
+	<array>
+		<string>arm64</string>
+	</array>
+</dict>
+</plist>
diff --git a/...s/ios/build/Release/NativeScript.apple.node/ios-arm64/NativeScript.framework/NativeScript b/...s/ios/build/Release/NativeScript.apple.node/ios-arm64/NativeScript.framework/NativeScript
diff --git a/...cript.apple.node/ios-arm64_x86_64-simulator/NativeScript.framework/Headers/NativeScript.h b/...cript.apple.node/ios-arm64_x86_64-simulator/NativeScript.framework/Headers/NativeScript.h
@@ -0,0 +1,48 @@
+#ifndef NATIVESCRIPT_H
+#define NATIVESCRIPT_H
+
+#ifdef __cplusplus
+
+extern "C"
+
+#endif  // __cplusplus
+
+    void
+    nativescript_init(void* env, const char* metadata_path, const void* metadata_ptr);
+
+#ifdef __OBJC__
+
+#import <Foundation/Foundation.h>
+
+__attribute__((visibility("default")))
+@interface Config : NSObject
+
+@property(nonatomic, retain) NSString* BaseDir;
+@property(nonatomic, retain) NSString* ApplicationPath;
+@property(nonatomic) void* MetadataPtr;
+@property BOOL IsDebug;
+@property BOOL LogToSystemConsole;
+@property int ArgumentsCount;
+@property(nonatomic) char** Arguments;
+
+@end
+
+__attribute__((visibility("default")))
+@interface NativeScript : NSObject
+
+- (instancetype)initWithConfig:(Config*)config;
+- (void)runScriptString:(NSString*)script runLoop:(BOOL)runLoop;
+- (void)restartWithConfig:(Config*)config;
+- (void)shutdownRuntime;
+
+/**
+ WARNING: this method does not return in most applications. (UIApplicationMain)
+ */
+- (void)runMainApplication;
+- (bool)liveSync;
+
+@end
+
+#endif  // __OBJC__
+
+#endif /* NATIVESCRIPT_H */
diff --git a/...ease/NativeScript.apple.node/ios-arm64_x86_64-simulator/NativeScript.framework/Info.plist b/...ease/NativeScript.apple.node/ios-arm64_x86_64-simulator/NativeScript.framework/Info.plist
@@ -0,0 +1,53 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>BuildMachineOSBuild</key>
+	<string>23G93</string>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>English</string>
+	<key>CFBundleExecutable</key>
+	<string>NativeScript</string>
+	<key>CFBundleIdentifier</key>
+	<string>org.nativescript.runtime</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundlePackageType</key>
+	<string>FMWK</string>
+	<key>CFBundleShortVersionString</key>
+	<string>0.1.0</string>
+	<key>CFBundleSignature</key>
+	<string>????</string>
+	<key>CFBundleSupportedPlatforms</key>
+	<array>
+		<string>iPhoneSimulator</string>
+	</array>
+	<key>CFBundleVersion</key>
+	<string>0.1.0</string>
+	<key>CSResourcesFileMapped</key>
+	<true/>
+	<key>DTCompiler</key>
+	<string>com.apple.compilers.llvm.clang.1_0</string>
+	<key>DTPlatformBuild</key>
+	<string>22C146</string>
+	<key>DTPlatformName</key>
+	<string>iphonesimulator</string>
+	<key>DTPlatformVersion</key>
+	<string>18.2</string>
+	<key>DTSDKBuild</key>
+	<string>22C146</string>
+	<key>DTSDKName</key>
+	<string>iphonesimulator18.2</string>
+	<key>DTXcode</key>
+	<string>1620</string>
+	<key>DTXcodeBuild</key>
+	<string>16C5032a</string>
+	<key>MinimumOSVersion</key>
+	<string>13.0</string>
+	<key>UIDeviceFamily</key>
+	<array>
+		<integer>1</integer>
+		<integer>2</integer>
+	</array>
+</dict>
+</plist>
diff --git a/...se/NativeScript.apple.node/ios-arm64_x86_64-simulator/NativeScript.framework/NativeScript b/...se/NativeScript.apple.node/ios-arm64_x86_64-simulator/NativeScript.framework/NativeScript