nativescript 9.0.4-dev.1 → 9.0.4-dev.2

package/lib/common/mobile/android/android-virtual-device-service.js

@@ -69,6 +69,9 @@ class AndroidVirtualDeviceService {
     get pathToEmulatorExecutable() {
         const emulatorExecutableName = "emulator";
         if (this.androidHome) {
+            // Check https://developer.android.com/studio/releases/sdk-tools.html (25.3.0)
+            // Since this version of SDK tools, the emulator is a separate package.
+            // However the emulator executable still exists in the "tools" dir.
             const pathToEmulatorFromAndroidStudio = path.join(this.androidHome, emulatorExecutableName, emulatorExecutableName);
             const realFilePath = this.$hostInfo.isWindows
                 ? `${pathToEmulatorFromAndroidStudio}.exe`
@@ -108,6 +111,17 @@ class AndroidVirtualDeviceService {
             client.on("data", (data) => {
                 output += data.toString();
                 const imageIdentifier = this.getImageIdentifierFromClientOutput(output);
+                // old output should look like:
+                // Android Console: type 'help' for a list of commands
+                // OK
+                // <Name of image>
+                // OK
+                // new output should look like:
+                // Android Console: type 'help' for a list of commands
+                // OK
+                // a\u001b[K\u001b[Dav\u001b[K\u001b[D\u001b[Davd\u001b...
+                // <Name of image>
+                // OK
                 if (imageIdentifier && !isResolved) {
                     this.mapEmulatorIdToImageIdentifier[emulatorId] = imageIdentifier;
                     this.clearNetConnection(client, timer);
@@ -159,6 +173,8 @@ class AndroidVirtualDeviceService {
         if (this.pathToAvdManagerExecutable &&
             this.$fs.exists(this.pathToAvdManagerExecutable)) {
             if (process.env.JAVA_HOME) {
+                // In case JAVA_HOME is set, but it points to incorrect directory (i.e. there's no java in $JAVA_HOME/bin/java), avdmanager will fail
+                // no matter if you have correct java in PATH.
                 canExecute = !!(await this.$sysInfo.getJavaVersionFromJavaHome());
             }
             else {
@@ -230,6 +246,13 @@ class AndroidVirtualDeviceService {
         const avdOutput = output.split(constants_1.AndroidVirtualDevice.AVAILABLE_AVDS_MESSAGE);
         const availableDevices = avdOutput && avdOutput[1] && avdOutput[1].trim();
         if (availableDevices) {
+            // In some cases `avdmanager list avds` command prints:
+            //	`The following Android Virtual Devices could not be loaded:
+            //	Name: Pixel_2_XL_API_28
+            //	Path: /Users/<username>/.android/avd/Pixel_2_XL_API_28.avd
+            //	Error: Google pixel_2_xl no longer exists as a device`
+            // These devices sometimes are valid so try to parse them.
+            // Also these devices are printed at the end of the output and are separated with 2 new lines from the valid devices output.
             const parts = availableDevices.split(/(?:\r?\n){2}/);
             const items = [parts[0], parts[1]].filter((item) => !!item);
             for (const item of items) {
@@ -246,6 +269,7 @@ class AndroidVirtualDeviceService {
     }
     getAvdManagerDeviceInfo(output) {
         const avdManagerDeviceInfo = Object.create(null);
+        // Split by `\n`, not EOL as the avdmanager and android executables print results with `\n` only even on Windows
         _.reduce(output.split("\n"), (result, row) => {
             const [key, value] = row.split(": ").map((part) => part.trim());
             switch (key) {
@@ -292,6 +316,7 @@ class AndroidVirtualDeviceService {
         };
     }
     getImageIdentifierFromClientOutput(output) {
+        // The lines should be trimmed after the split because the output has \r\n and when using split(EOL) on mac each line ends with \r.
         const lines = _.map(output.split(os_1.EOL), (line) => line.trim());
         const firstIndexOfOk = _.indexOf(lines, "OK");
         if (firstIndexOfOk < 0) {
@@ -340,3 +365,4 @@ __decorate([
     (0, decorators_1.cache)()
 ], AndroidVirtualDeviceService.prototype, "getConfigurationError", null);
 yok_1.injector.register("androidVirtualDeviceService", AndroidVirtualDeviceService);
+//# sourceMappingURL=android-virtual-device-service.js.map

package/lib/common/mobile/android/device-android-debug-bridge.js

@@ -30,3 +30,4 @@ class DeviceAndroidDebugBridge extends android_debug_bridge_1.AndroidDebugBridge
     }
 }
 exports.DeviceAndroidDebugBridge = DeviceAndroidDebugBridge;
+//# sourceMappingURL=device-android-debug-bridge.js.map

package/lib/common/mobile/android/genymotion/genymotion-service.js

@@ -42,6 +42,7 @@ class AndroidGenymotionService {
             .map(async (row) => {
             const match = row.match(/^(.+?)\s+device$/);
             if (match && match[1]) {
+                // possible genymotion emulator
                 const emulatorId = match[1];
                 const result = (await this.isGenymotionEmulator(emulatorId))
                     ? emulatorId
@@ -92,6 +93,7 @@ class AndroidGenymotionService {
         this.$emulatorHelper.setRunningAndroidEmulatorProperties(runningEmulatorId, runningEmulator);
         return runningEmulator;
     }
+    // https://wiki.appcelerator.org/display/guides2/Installing+Genymotion
     get playerSearchPaths() {
         return {
             darwin: [
@@ -133,13 +135,14 @@ class AndroidGenymotionService {
             vendor: constants_1.AndroidVirtualDevice.GENYMOTION_VENDOR_NAME,
             status: constants_1.NOT_RUNNING_EMULATOR_STATUS,
             errorHelp: [configurationError, error].filter((item) => !!item).join(os_1.EOL) || null,
-            isTablet: false,
+            isTablet: false, //TODO: Consider how to populate this correctly when the device is not running
             type: constants_1.DeviceTypes.Emulator,
             connectionTypes: [constants_2.DeviceConnectionType.Local],
             platform: this.$devicePlatformsConstants.Android,
         };
     }
     getSdkVersion(output) {
+        // Example -> Name: android_version, value: 6.0.0, timestamp: 1530090506102029000, flags:
         const androidApiLevelRow = output
             .split("\n")
             .filter((row) => !!row)
@@ -165,6 +168,7 @@ In case you have installed Genymotion in a different location, please add the pa
     }
     async getConfigurationError() {
         const result = await this.$childProcess.trySpawnFromCloseEvent(this.pathToEmulatorExecutable, [], {}, { throwError: false });
+        // When player is spawned, it always prints message on stderr.
         if (result &&
             result.stderr &&
             result.stderr.indexOf(constants_1.AndroidVirtualDevice.GENYMOTION_DEFAULT_STDERR_STRING) === -1) {
@@ -182,3 +186,4 @@ __decorate([
     (0, decorators_1.cache)()
 ], AndroidGenymotionService.prototype, "getConfigurationError", null);
 yok_1.injector.register("androidGenymotionService", AndroidGenymotionService);
+//# sourceMappingURL=genymotion-service.js.map

package/lib/common/mobile/android/genymotion/virtualbox-service.js

@@ -34,6 +34,7 @@ class VirtualBoxService {
                     .split(os_1.EOL)
                     .filter((row) => !!row)
                     .map((row) => {
+                    // Example row: "Google Nexus 4 - 5.0.0 - API 21 - 768x1280" {9d9beef2-cc60-4a54-bcc0-cc1dbf89811f}
                     const [rawName, rawId] = row.split('" ');
                     const id = rawId.substr(1, rawId.length - 2);
                     const name = rawName.substr(1, rawName.length - 1);
@@ -70,6 +71,15 @@ class VirtualBoxService {
         if (this.$hostInfo.isWindows) {
             let searchPath = null;
             try {
+                /* This can be used as interface!!!!
+                    arch:null
+                    hive:"HKLM"
+                    host:""
+                    key:"\Software\Oracle\VirtualBox"
+                    name:"InstallDir"
+                    type:"REG_SZ"
+                    value:"C:\Program Files\Oracle\VirtualBox\"
+                */
                 const result = await (0, helpers_1.getWinRegPropertyValue)("\\Software\\Oracle\\VirtualBox", "InstallDir");
                 searchPath = result && result.value ? result.value : null;
             }
@@ -102,3 +112,4 @@ __decorate([
     (0, decorators_1.cache)()
 ], VirtualBoxService.prototype, "getvBoxManagePath", null);
 yok_1.injector.register("virtualBoxService", VirtualBoxService);
+//# sourceMappingURL=virtualbox-service.js.map

package/lib/common/mobile/android/logcat-helper.js

@@ -40,6 +40,7 @@ class LogcatHelper {
                     }
                 }
                 catch (err) {
+                    // Ignore the error, the process is dead.
                 }
             });
             lineStream.on("data", (lineBuffer) => {
@@ -60,6 +61,7 @@ class LogcatHelper {
                     return;
                 const lines = (lineBuffer.toString() || "").split("\n");
                 for (let line of lines) {
+                    // 2024-06-26 16:43:22.286   630-659   ActivityManager system_server I  Start proc 8854:org.nativescript.uitestsapp/u0a190 for next-top-activity {org.nativescript.uitestsapp/com.tns.NativeScriptActivity}
                     const startProc = /Start proc (?<pid>[0-9]+):(?<appId>.+?)\//.exec(line);
                     if (startProc &&
                         ((_b = startProc.groups) === null || _b === void 0 ? void 0 : _b.appId) === options.appId &&
@@ -86,6 +88,9 @@ class LogcatHelper {
             lineStream.removeAllListeners();
         });
     }
+    /**
+     * Stops the logcat process for the specified device if keepSingleProcess is not passed on start
+     */
     stop(deviceIdentifier) {
         if (this.mapDevicesLoggingData[deviceIdentifier] &&
             !this.mapDevicesLoggingData[deviceIdentifier].keepSingleProcess) {
@@ -102,6 +107,9 @@ class LogcatHelper {
         (_e = loggingData.lineStream) === null || _e === void 0 ? void 0 : _e.removeAllListeners();
         delete this.mapDevicesLoggingData[deviceIdentifier];
     }
+    /**
+     * @deprecated - we likely don't need this anymore, and can simplify the code...
+     */
     async isLogcatPidSupported(deviceIdentifier) {
         const device = await this.$devicesService.getDevice(deviceIdentifier);
         const minAndroidWithLogcatPidSupport = "7.0.0";
@@ -111,6 +119,7 @@ class LogcatHelper {
     async getLogcatStream(deviceIdentifier, pid) {
         const isLogcatPidSupported = await this.isLogcatPidSupported(deviceIdentifier);
         const adb = this.$injector.resolve(device_android_debug_bridge_1.DeviceAndroidDebugBridge, { identifier: deviceIdentifier });
+        // -T 1 - shows only new logs after starting adb logcat
         const logcatCommand = ["logcat", "-T", "1"];
         const acceptedTags = [
             "chromium",
@@ -123,6 +132,7 @@ class LogcatHelper {
         if (pid && isLogcatPidSupported) {
             logcatCommand.push(`--pid=${pid}`);
             acceptedTags.forEach((tag) => {
+                // -s <tag> - shows only logs with the specified tag
                 logcatCommand.push("-s", tag);
             });
         }
@@ -133,6 +143,8 @@ class LogcatHelper {
     }
     async getAppStartTrackingLogcatStream(deviceIdentifier, appId) {
         const adb = this.$injector.resolve(device_android_debug_bridge_1.DeviceAndroidDebugBridge, { identifier: deviceIdentifier });
+        // -b system  - shows the system buffer/logs only
+        // -T 1 			- shows only new logs after starting adb logcat
         const logcatCommand = [
             `logcat`,
             `-b`,
@@ -153,3 +165,4 @@ class LogcatHelper {
 }
 exports.LogcatHelper = LogcatHelper;
 yok_1.injector.register("logcatHelper", LogcatHelper);
+//# sourceMappingURL=logcat-helper.js.map

package/lib/common/mobile/application-manager-base.js

@@ -36,6 +36,9 @@ class ApplicationManagerBase extends events_1.EventEmitter {
         if (!this.checkForApplicationUpdatesPromise) {
             this.checkForApplicationUpdatesPromise = new Promise(async (resolve, reject) => {
                 let isFulfilled = false;
+                // As this method is called on 500ms, but it's execution may last much longer
+                // use locking, so the next executions will not get into the body, while the first one is still working.
+                // In case we do not break the next executions, we'll report each app as newly installed several times.
                 try {
                     const currentlyInstalledAppIdentifiers = await this.getInstalledApplications();
                     const previouslyInstalledAppIdentifiers = this.lastInstalledAppIdentifiers || [];
@@ -80,6 +83,7 @@ class ApplicationManagerBase extends events_1.EventEmitter {
         _.each(notAvailableAppsForDebugging, (appInfo) => {
             this.emit("debuggableAppLost", appInfo);
             if (_.has(this.lastAvailableDebuggableAppViews, appInfo.appIdentifier)) {
+                // Prevent emitting debuggableViewLost when application cannot be debugged anymore.
                 delete this.lastAvailableDebuggableAppViews[appInfo.appIdentifier];
             }
         });
@@ -98,6 +102,7 @@ class ApplicationManagerBase extends events_1.EventEmitter {
             _.each(newAvailableViews, (debugWebViewInfo) => {
                 this.emit("debuggableViewFound", appIdentifier, debugWebViewInfo);
             });
+            // Determine which of the views had changed since last check and raise debuggableViewChanged event for them:
             const keptViews = _.differenceBy(currentlyAvailableViews, newAvailableViews, "id");
             _.each(keptViews, (view) => {
                 const previousTimeViewInfo = _.find(previouslyAvailableViews, (previousView) => previousView.id === view.id);
@@ -111,3 +116,4 @@ class ApplicationManagerBase extends events_1.EventEmitter {
     }
 }
 exports.ApplicationManagerBase = ApplicationManagerBase;
+//# sourceMappingURL=application-manager-base.js.map

package/lib/common/mobile/device-emitter.js

@@ -15,7 +15,10 @@ class DeviceEmitter extends events_1.EventEmitter {
         this.$devicesService.on(constants_1.DeviceDiscoveryEventNames.DEVICE_FOUND, (device) => {
             this.emit(constants_1.DeviceDiscoveryEventNames.DEVICE_FOUND, device.deviceInfo);
             this.attachApplicationChangedHandlers(device);
+            // await: Do not await as this will require to mark the lambda with async keyword, but there's no way to await the lambda itself.
+            /* tslint:disable:no-floating-promises */
             device.openDeviceLogStream();
+            /* tslint:enable:no-floating-promises */
         });
         this.$devicesService.on(constants_1.DeviceDiscoveryEventNames.DEVICE_LOST, (device) => {
             this.emit(constants_1.DeviceDiscoveryEventNames.DEVICE_LOST, device.deviceInfo);
@@ -59,3 +62,4 @@ class DeviceEmitter extends events_1.EventEmitter {
 }
 exports.DeviceEmitter = DeviceEmitter;
 yok_1.injector.register("deviceEmitter", DeviceEmitter);
+//# sourceMappingURL=device-emitter.js.map

package/lib/common/mobile/device-log-emitter.js

@@ -38,3 +38,4 @@ class DeviceLogEmitter extends device_log_provider_base_1.DeviceLogProviderBase
 }
 exports.DeviceLogEmitter = DeviceLogEmitter;
 yok_1.injector.register("deviceLogProvider", DeviceLogEmitter);
+//# sourceMappingURL=device-log-emitter.js.map

package/lib/common/mobile/device-log-provider-base.js

@@ -63,3 +63,4 @@ class DeviceLogProviderBase extends events_1.EventEmitter {
     }
 }
 exports.DeviceLogProviderBase = DeviceLogProviderBase;
+//# sourceMappingURL=device-log-provider-base.js.map

package/lib/common/mobile/device-log-provider.js

@@ -35,6 +35,7 @@ class DeviceLogProvider extends device_log_provider_base_1.DeviceLogProviderBase
         this.colorPoolIndex = 0;
     }
     logData(lineText, platform, deviceIdentifier) {
+        // console.log(lineText)
         const loggingOptions = this.getDeviceLogOptionsForDevice(deviceIdentifier);
         let data = this.$logFilter.filterData(platform, lineText, loggingOptions);
         data = this.$logSourceMapService.replaceWithOriginalFileLocations(platform, data, loggingOptions);
@@ -52,6 +53,7 @@ class DeviceLogProvider extends device_log_provider_base_1.DeviceLogProviderBase
             return this.deviceColorMap.get(deviceIdentifier);
         }
         const color = this.colorPool[this.colorPoolIndex];
+        // wrap around if we have no more colors in the pool
         this.colorPoolIndex =
             this.colorPoolIndex === this.colorPool.length - 1
                 ? 0
@@ -61,10 +63,13 @@ class DeviceLogProvider extends device_log_provider_base_1.DeviceLogProviderBase
     }
     logDataCore(data, deviceIdentifier) {
         var _a, _b, _c;
+        // todo: use config to set logger - --env.classicLogs is temporary!
         if ("classicLogs" in ((_a = this.$options.env) !== null && _a !== void 0 ? _a : {})) {
+            // legacy logging
             this.$logger.info(data, { [constants_2.LoggerConfigData.skipNewLine]: true });
             return;
         }
+        // todo: extract into an injectable printer/logger service
         let shouldPrepend = false;
         let splitIndexes = [];
         const lines = data
@@ -119,7 +124,25 @@ class DeviceLogProvider extends device_log_provider_base_1.DeviceLogProviderBase
     printLine(prefix, ...parts) {
         const fullLine = parts.join(" ");
         console.log(prefix, fullLine);
+        /**
+         * Note: Disabled
+         *
+         * This splits the output into lines that fit within the current
+         * terminal width, however this makes copying json objects that
+         * span across multiple lines difficult, as it introduces
+         * whitespace & line breaks
+         */
+        // const maxWidth = process.stdout.columns - 2;
+        // if (!maxWidth || maxWidth < 10 || fullLine.length < maxWidth) {
+        // 	console.log(prefix, fullLine);
+        // } else {
+        // 	for (let i = 0; i < fullLine.length; i += maxWidth) {
+        // 		const part = fullLine.substring(i, i + maxWidth);
+        // 		console.log(prefix, part);
+        // 	}
+        // }
     }
 }
 exports.DeviceLogProvider = DeviceLogProvider;
 yok_1.injector.register("deviceLogProvider", DeviceLogProvider);
+//# sourceMappingURL=device-log-provider.js.map

package/lib/common/mobile/device-platforms-constants.js

@@ -20,3 +20,4 @@ class DevicePlatformsConstants {
 }
 exports.DevicePlatformsConstants = DevicePlatformsConstants;
 yok_1.injector.register("devicePlatformsConstants", DevicePlatformsConstants);
+//# sourceMappingURL=device-platforms-constants.js.map

package/lib/common/mobile/emulator-helper.js

@@ -6,6 +6,7 @@ const _ = require("lodash");
 const yok_1 = require("../yok");
 class EmulatorHelper {
     constructor() {
+        // https://developer.android.com/guide/topics/manifest/uses-sdk-element
         this.mapAndroidApiLevelToVersion = {
             "android-36": "16.0.0",
             "android-35": "15.0.0",
@@ -80,7 +81,9 @@ class EmulatorHelper {
         emulator.identifier = emulatorId;
         emulator.status = constants_1.RUNNING_EMULATOR_STATUS;
         emulator.type = constants_1.DeviceTypes.Device;
+        //emulator.isTablet; // TODO: consider to do this here!!!
     }
 }
 exports.EmulatorHelper = EmulatorHelper;
 yok_1.injector.register("emulatorHelper", EmulatorHelper);
+//# sourceMappingURL=emulator-helper.js.map

package/lib/common/mobile/ios/device/ios-application-manager.js

@@ -115,9 +115,11 @@ class IOSApplicationManager extends application_manager_base_1.ApplicationManage
         await this.device.openDeviceLogStream();
     }
     getDebuggableApps() {
+        // Implement when we can find debuggable applications for iOS.
         return Promise.resolve([]);
     }
     getDebuggableAppViews(appIdentifiers) {
+        // Implement when we can find debuggable applications for iOS.
         return Promise.resolve(null);
     }
 }
@@ -128,3 +130,4 @@ __decorate([
 __decorate([
     (0, decorators_1.cache)()
 ], IOSApplicationManager.prototype, "startDeviceLog", null);
+//# sourceMappingURL=ios-application-manager.js.map

package/lib/common/mobile/ios/device/ios-device-file-system.js

@@ -104,3 +104,4 @@ class IOSDeviceFileSystem {
 }
 exports.IOSDeviceFileSystem = IOSDeviceFileSystem;
 IOSDeviceFileSystem.AFC_DELETE_FILE_NOT_FOUND_ERROR = 8;
+//# sourceMappingURL=ios-device-file-system.js.map

package/lib/common/mobile/ios/device/ios-device-operations.js

@@ -44,6 +44,7 @@ class IOSDeviceOperations extends events_1.EventEmitter {
             if (options && options.shouldReturnImmediateResult) {
                 return;
             }
+            // We need this because we need to make sure that we have devices.
             await new Promise((resolve, reject) => {
                 let iterationsCount = 0;
                 const maxIterationsCount = 3;
@@ -125,6 +126,8 @@ class IOSDeviceOperations extends events_1.EventEmitter {
         return this.getMultipleResults(() => this.deviceLib.stop(stopArray), errorHandler);
     }
     dispose(signal) {
+        // We need to check if we should dispose the device lib.
+        // For example we do not want to dispose it when we start printing the device logs.
         if (this.shouldDispose && this.deviceLib) {
             this.deviceLib.removeAllListeners();
             this.deviceLib.dispose(signal);
@@ -195,3 +198,4 @@ __decorate([
     (0, decorators_1.cache)()
 ], IOSDeviceOperations.prototype, "attacheDeviceLogDataHandler", null);
 yok_1.injector.register("iosDeviceOperations", IOSDeviceOperations);
+//# sourceMappingURL=ios-device-operations.js.map

package/lib/common/mobile/ios/device/ios-device.js

@@ -106,6 +106,7 @@ class IOSDevice extends ios_device_base_1.IOSDeviceBase {
             const majorVersionAsString = productType.match(/.*?(\d+)\,(\d+)/)[1];
             const majorVersion = parseInt(majorVersionAsString);
             let isArm64Architecture = false;
+            //https://en.wikipedia.org/wiki/List_of_iOS_devices
             if (_.startsWith(productType, "iphone")) {
                 isArm64Architecture = majorVersion >= 6;
             }
@@ -116,6 +117,7 @@ class IOSDevice extends ios_device_base_1.IOSDeviceBase {
                 isArm64Architecture = majorVersion >= 7;
             }
             else if (_.startsWith(productType, "realitydevice")) {
+                // visionos
                 isArm64Architecture = true;
             }
             activeArchitecture = isArm64Architecture ? "arm64" : "armv7";
@@ -125,6 +127,7 @@ class IOSDevice extends ios_device_base_1.IOSDeviceBase {
     getPlatform(productType) {
         productType = productType.toLowerCase().trim();
         if (_.startsWith(productType, "realitydevice")) {
+            // visionos
             return this.$devicePlatformsConstants.visionOS;
         }
         return this.$devicePlatformsConstants.iOS;
@@ -135,3 +138,4 @@ __decorate([
     (0, decorators_1.cache)()
 ], IOSDevice.prototype, "openDeviceLogStream", null);
 yok_1.injector.register("iOSDevice", IOSDevice);
+//# sourceMappingURL=ios-device.js.map

package/lib/common/mobile/ios/ios-device-base.js

@@ -83,3 +83,4 @@ exports.IOSDeviceBase = IOSDeviceBase;
 __decorate([
     (0, decorators_1.performanceLog)()
 ], IOSDeviceBase.prototype, "getDebugSocket", null);
+//# sourceMappingURL=ios-device-base.js.map

package/lib/common/mobile/ios/ios-device-product-name-mapper.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const yok_1 = require("../../yok");
 class IosDeviceProductNameMapper {
     constructor() {
+        // http://support.hockeyapp.net/kb/client-integration-ios-mac-os-x/ios-device-types
         this.map = {
             "iPhone1,1": "iPhone",
             "iPhone1,2": "iPhone 3G",
@@ -63,3 +64,4 @@ class IosDeviceProductNameMapper {
     }
 }
 yok_1.injector.register("iOSDeviceProductNameMapper", IosDeviceProductNameMapper);
+//# sourceMappingURL=ios-device-product-name-mapper.js.map

package/lib/common/mobile/ios/ios-log-filter.js

@@ -22,3 +22,4 @@ class IOSLogFilter {
 }
 exports.IOSLogFilter = IOSLogFilter;
 yok_1.injector.register("iOSLogFilter", IOSLogFilter);
+//# sourceMappingURL=ios-log-filter.js.map

package/lib/common/mobile/ios/simulator/ios-emulator-services.js

@@ -18,6 +18,7 @@ class IosEmulatorServices {
         try {
             if (options.platform === this.$devicePlatformsConstants.visionOS &&
                 !options.emulatorIdOrName) {
+                // find first available visionOS simulator (for now).
                 const { devices } = await this.tryGetiOSSimDevices();
                 options.emulatorIdOrName = (_a = devices.find((device) => device.platform === this.$devicePlatformsConstants.visionOS)) === null || _a === void 0 ? void 0 : _a.id;
             }
@@ -51,6 +52,8 @@ class IosEmulatorServices {
     }
     async connectToPort(data) {
         try {
+            // node v17+ resolves localhost to ::1 (ipv6) instead of 127.0.0.1 (ipv4)
+            // so we explicitly pass ipv4
             const socket = net.connect(data.port, "127.0.0.1");
             return socket;
         }
@@ -108,3 +111,4 @@ class IosEmulatorServices {
     }
 }
 yok_1.injector.register("iOSEmulatorServices", IosEmulatorServices);
+//# sourceMappingURL=ios-emulator-services.js.map

package/lib/common/mobile/ios/simulator/ios-sim-resolver.js

@@ -21,3 +21,4 @@ exports.IOSSimResolver = IOSSimResolver;
 IOSSimResolver.iOSSimName = "ios-sim-portable";
 IOSSimResolver.iOSStandaloneExecutableName = "ios-sim-standalone.js";
 yok_1.injector.register("iOSSimResolver", IOSSimResolver);
+//# sourceMappingURL=ios-sim-resolver.js.map

package/lib/common/mobile/ios/simulator/ios-simulator-application-manager.js

@@ -73,8 +73,13 @@ class IOSSimulatorApplicationManager extends application_manager_base_1.Applicat
         return [];
     }
     async getDebuggableAppViews(appIdentifiers) {
+        // Implement when we can find debuggable applications for iOS.
         return Promise.resolve(null);
     }
+    // iOS will kill the app if we freeze it in the NativeScript Runtime and wait for debug-brk.
+    // In order to avoid that, we are attaching lldb and passing it "process continue".
+    // In this way, iOS will not kill the app because it has a native debugger attached
+    // and the users will be able to attach a debug session using the debug-brk flag.
     attachNativeDebugger(appId, pid) {
         this._lldbProcesses[appId] = this.$childProcess.spawn("lldb", ["-p", pid]);
         if (log4js.levels.TRACE.isGreaterThanOrEqualTo(this.$logger.getLevel())) {
@@ -116,3 +121,4 @@ __decorate([
 __decorate([
     (0, decorators_1.cache)()
 ], IOSSimulatorApplicationManager.prototype, "startDeviceLog", null);
+//# sourceMappingURL=ios-simulator-application-manager.js.map

package/lib/common/mobile/ios/simulator/ios-simulator-device.js

@@ -65,11 +65,15 @@ class IOSSimulator extends ios_device_base_1.IOSDeviceBase {
         let socket;
         const attachRequestMessage = this.$iOSNotification.getAttachRequest(appId, this.deviceInfo.identifier);
         await this.$iOSEmulatorServices.postDarwinNotification(attachRequestMessage, this.deviceInfo.identifier);
+        // Retry posting the notification every five seconds, in case the AttachRequest
+        // event handler wasn't registered when the first one was sent
         const postNotificationRetryInterval = setInterval(() => {
             this.$iOSEmulatorServices
                 .postDarwinNotification(attachRequestMessage, this.deviceInfo.identifier)
                 .catch((e) => this.$logger.error(e));
         }, 5e3);
+        // the internal retry-mechanism of getDebuggerPort will ensure the above
+        // interval has a chance to execute multiple times
         const port = await super.getDebuggerPort(appId).finally(() => {
             clearInterval(postNotificationRetryInterval);
         });
@@ -88,3 +92,4 @@ exports.IOSSimulator = IOSSimulator;
 __decorate([
     (0, decorators_1.cache)()
 ], IOSSimulator.prototype, "openDeviceLogStream", null);
+//# sourceMappingURL=ios-simulator-device.js.map

package/lib/common/mobile/ios/simulator/ios-simulator-file-system.js

@@ -54,3 +54,4 @@ class IOSSimulatorFileSystem {
     }
 }
 exports.IOSSimulatorFileSystem = IOSSimulatorFileSystem;
+//# sourceMappingURL=ios-simulator-file-system.js.map

package/lib/common/mobile/ios/simulator/ios-simulator-log-provider.js

@@ -56,3 +56,4 @@ class IOSSimulatorLogProvider extends events_1.EventEmitter {
 }
 exports.IOSSimulatorLogProvider = IOSSimulatorLogProvider;
 yok_1.injector.register("iOSSimulatorLogProvider", IOSSimulatorLogProvider);
+//# sourceMappingURL=ios-simulator-log-provider.js.map

package/lib/common/mobile/local-to-device-path-data-factory.js

@@ -35,3 +35,4 @@ class LocalToDevicePathDataFactory {
 }
 exports.LocalToDevicePathDataFactory = LocalToDevicePathDataFactory;
 yok_1.injector.register("localToDevicePathDataFactory", LocalToDevicePathDataFactory);
+//# sourceMappingURL=local-to-device-path-data-factory.js.map

package/lib/common/mobile/log-filter.js

@@ -24,6 +24,7 @@ class LogFilter {
         if (deviceLogFilter) {
             return deviceLogFilter.filterData(data, loggingOptions);
         }
+        // In case the platform is not valid, just return the data without filtering.
         return data;
     }
     getDeviceLogFilterInstance(platform) {
@@ -49,3 +50,4 @@ class LogFilter {
 }
 exports.LogFilter = LogFilter;
 yok_1.injector.register("logFilter", LogFilter);
+//# sourceMappingURL=log-filter.js.map

package/lib/common/mobile/logging-levels.js

@@ -10,3 +10,4 @@ class LoggingLevels {
 }
 exports.LoggingLevels = LoggingLevels;
 yok_1.injector.register("loggingLevels", LoggingLevels);
+//# sourceMappingURL=logging-levels.js.map

package/lib/common/mobile/mobile-core/android-device-discovery.js

@@ -38,6 +38,7 @@ class AndroidDeviceDiscovery extends device_discovery_1.DeviceDiscovery {
     }
     async checkCurrentData(result) {
         const currentDevices = result.map((element) => {
+            // http://developer.android.com/tools/help/adb.html#devicestatus
             const data = element.split("\t");
             const identifier = data[0];
             const status = data[1];
@@ -70,3 +71,4 @@ class AndroidDeviceDiscovery extends device_discovery_1.DeviceDiscovery {
 }
 exports.AndroidDeviceDiscovery = AndroidDeviceDiscovery;
 yok_1.injector.register("androidDeviceDiscovery", AndroidDeviceDiscovery);
+//# sourceMappingURL=android-device-discovery.js.map

package/lib/common/mobile/mobile-core/android-emulator-discovery.js

@@ -21,9 +21,11 @@ class AndroidEmulatorDiscovery extends events_1.EventEmitter {
         const availableEmulatorsOutput = await this.$androidEmulatorServices.getEmulatorImages();
         const currentEmulators = availableEmulatorsOutput.devices;
         const cachedEmulators = _.values(this._emulators);
+        // Remove old emulators
         const lostEmulators = _(cachedEmulators)
             .reject((e) => _.some(currentEmulators, (emulator) => emulator && e && emulator.imageIdentifier === e.imageIdentifier))
             .value();
+        // Add new emulators
         const foundEmulators = _(currentEmulators)
             .reject((e) => _.some(cachedEmulators, (emulator) => emulator && e && emulator.imageIdentifier === e.imageIdentifier))
             .value();
@@ -52,3 +54,4 @@ class AndroidEmulatorDiscovery extends events_1.EventEmitter {
 }
 exports.AndroidEmulatorDiscovery = AndroidEmulatorDiscovery;
 yok_1.injector.register("androidEmulatorDiscovery", AndroidEmulatorDiscovery);
+//# sourceMappingURL=android-emulator-discovery.js.map