nativescript 9.0.0-alpha.2 → 9.0.0-alpha.3

package/lib/services/cleanup-service.js

@@ -20,56 +20,56 @@ class CleanupService {
     async addCleanupCommand(commandInfo) {
         const cleanupProcess = await this.getCleanupProcess();
         cleanupProcess.send({
-            messageType: "AddCleanCommand",
+            messageType: "AddCleanCommand" /* CleanupProcessMessage.AddCleanCommand */,
             commandInfo,
         });
     }
     async removeCleanupCommand(commandInfo) {
         const cleanupProcess = await this.getCleanupProcess();
         cleanupProcess.send({
-            messageType: "RemoveCleanCommand",
+            messageType: "RemoveCleanCommand" /* CleanupProcessMessage.RemoveCleanCommand */,
             commandInfo,
         });
     }
     async addRequest(requestInfo) {
         const cleanupProcess = await this.getCleanupProcess();
         cleanupProcess.send({
-            messageType: "AddRequest",
+            messageType: "AddRequest" /* CleanupProcessMessage.AddRequest */,
             requestInfo,
         });
     }
     async removeRequest(requestInfo) {
         const cleanupProcess = await this.getCleanupProcess();
         cleanupProcess.send({
-            messageType: "RemoveRequest",
+            messageType: "RemoveRequest" /* CleanupProcessMessage.RemoveRequest */,
             requestInfo,
         });
     }
     async addCleanupDeleteAction(filePath) {
         const cleanupProcess = await this.getCleanupProcess();
         cleanupProcess.send({
-            messageType: "AddDeleteFileAction",
+            messageType: "AddDeleteFileAction" /* CleanupProcessMessage.AddDeleteFileAction */,
             filePath,
         });
     }
     async removeCleanupDeleteAction(filePath) {
         const cleanupProcess = await this.getCleanupProcess();
         cleanupProcess.send({
-            messageType: "RemoveDeleteFileAction",
+            messageType: "RemoveDeleteFileAction" /* CleanupProcessMessage.RemoveDeleteFileAction */,
             filePath,
         });
     }
     async addCleanupJS(jsCommand) {
         const cleanupProcess = await this.getCleanupProcess();
         cleanupProcess.send({
-            messageType: "AddJSFileToRequire",
+            messageType: "AddJSFileToRequire" /* CleanupProcessMessage.AddJSFileToRequire */,
             jsCommand,
         });
     }
     async removeCleanupJS(jsCommand) {
         const cleanupProcess = await this.getCleanupProcess();
         cleanupProcess.send({
-            messageType: "RemoveJSFileToRequire",
+            messageType: "RemoveJSFileToRequire" /* CleanupProcessMessage.RemoveJSFileToRequire */,
             jsCommand,
         });
     }
@@ -92,6 +92,8 @@ class CleanupService {
     setShouldDispose(shouldDispose) {
         this.shouldDispose = shouldDispose;
     }
+    // TODO: Consider extracting this method to a separate service
+    // as it has the same logic as the one used in analytics-service
     getCleanupProcess() {
         return new Promise((resolve, reject) => {
             const cleanupProcessArgs = this.getCleanupProcessArgs();
@@ -110,11 +112,12 @@ class CleanupService {
                 clearTimeout(timeoutId);
                 if (!isSettled) {
                     isSettled = true;
+                    // In case we throw error here, CLI will break its execution.
                     reject(err);
                 }
             });
             cleanupProcess.on("message", (data) => {
-                if (data === "ProcessReadyToReceive") {
+                if (data === "ProcessReadyToReceive" /* DetachedProcessMessages.ProcessReadyToReceive */) {
                     clearTimeout(timeoutId);
                     if (!isSettled) {
                         isSettled = true;
@@ -163,3 +166,4 @@ __decorate([
     (0, decorators_1.cache)()
 ], CleanupService.prototype, "getCleanupProcess", null);
 yok_1.injector.register("cleanupService", CleanupService);
+//# sourceMappingURL=cleanup-service.js.map

package/lib/services/cocoapods-platform-manager.js

@@ -82,6 +82,7 @@ class CocoaPodsPlatformManager {
         _.each(allPodfiles, (podfileContent) => {
             const platformMatch = platformRowRegExp.exec(podfileContent);
             const podfilePathMatch = podfilePathRegExp.exec(podfileContent) || [];
+            // platform without version -> select it with highest priority
             if (platformMatch && platformMatch[0] && !platformMatch[2]) {
                 selectedPlatformData = {
                     version: null,
@@ -90,6 +91,7 @@ class CocoaPodsPlatformManager {
                 };
                 return false;
             }
+            // platform with version
             if (platformMatch && platformMatch[0] && platformMatch[2]) {
                 if (!selectedPlatformData ||
                     semver.gt(semver.coerce(platformMatch[2]), semver.coerce(selectedPlatformData.version))) {
@@ -104,6 +106,12 @@ class CocoaPodsPlatformManager {
         return selectedPlatformData;
     }
     shouldReplacePlatformSection(projectData, oldPodfilePlatformData, currentPodfilePlatformData) {
+        // The selected platform should be replaced in the following cases:
+        // 1. When the pod file is from App_Resources and the selected platform is not from App_Resources
+        // 2. When the pod file is from App_Resources, the selected platform is also from App_Resources
+        // and the pod's version is greater than the selected one
+        // 3. When the pod file doesn't have platform's version -> `platform :ios`
+        // 4. When the pod file has a version greater than the selected platform's version
         const appResourcesPodfilePath = path.join(projectData.getAppResourcesDirectoryPath(), "iOS", constants_1.PODFILE_NAME);
         const isFromAppResources = oldPodfilePlatformData.path !== appResourcesPodfilePath &&
             currentPodfilePlatformData.path === appResourcesPodfilePath;
@@ -135,3 +143,4 @@ class CocoaPodsPlatformManager {
 }
 exports.CocoaPodsPlatformManager = CocoaPodsPlatformManager;
 yok_1.injector.register("cocoaPodsPlatformManager", CocoaPodsPlatformManager);
+//# sourceMappingURL=cocoapods-platform-manager.js.map

package/lib/services/cocoapods-service.js

@@ -34,6 +34,12 @@ class CocoaPodsService {
         let podTool = this.$config.USE_POD_SANDBOX ? "sandbox-pod" : "pod";
         const args = ["install"];
         if (process.platform === "darwin" && process.arch === "arm64") {
+            // check if pod is installed as an x86_64 binary or a native arm64 one
+            // we run the following:
+            // arch -x86_64 pod --version
+            // if it's an arm64 binary, we'll get something like this as a result:
+            // arch: posix_spawnp: pod: Bad CPU type in executable
+            // in which case, we should run it natively.
             const res = await this.$childProcess
                 .exec("arch -x86_64 pod --version", null, {
                 showStderr: true,
@@ -47,8 +53,11 @@ class CocoaPodsService {
                 podTool = "arch";
             }
         }
+        // cocoapods print a lot of non-error information on stderr. Pipe the `stderr` to `stdout`, so we won't polute CLI's stderr output.
         const podInstallResult = await this.$childProcess.spawnFromEvent(podTool, args, "close", { cwd: projectRoot, stdio: ["pipe", process.stdout, process.stdout] }, { throwError: false });
         if (podInstallResult.exitCode !== 0) {
+            // https://github.com/CocoaPods/CocoaPods/blob/92aaf0f1120d32f3487960b485fb69fcaf61486c/lib/cocoapods/resolver.rb#L498
+            // TODO add article
             const versionResolutionHint = podInstallResult.exitCode === 31
                 ? `For more information on resolving CocoaPod issues in NativeScript read.`
                 : "";
@@ -80,6 +89,7 @@ ${versionResolutionHint}`);
     }
     async applyPodfileArchExclusions(projectData, platformData) {
         const xcodeVersionData = await this.$xcodeSelectService.getXcodeVersion();
+        // only apply EXCLUDED_ARCHS workaround on XCode 12
         if (+xcodeVersionData.major !== 12) {
             return;
         }
@@ -98,6 +108,7 @@ end`.trim();
             this.$fs.writeFile(exclusionsPodfile, exclusions);
         }
         await this.applyPodfileToProject("NativeScript-CLI-Architecture-Exclusions", exclusionsPodfile, projectData, platformData);
+        // clean up
         this.$fs.deleteFile(exclusionsPodfile);
     }
     async applyPodfileFromExtensions(projectData, platformData) {
@@ -120,6 +131,7 @@ end`.trim();
             podfilePath: path.join(extensionFolderPath, name, constants.PODFILE_NAME),
         }));
         extensionsPodfile.forEach(({ targetName, podfilePath }) => {
+            // Remove the data between #Begin Podfile and #EndPodfile
             const regExpToRemove = new RegExp(`${this.getExtensionPodfileHeader(podfilePath, targetName)}[\\s\\S]*?${this.getExtensionPodfileEnd()}`, "mg");
             projectPodFileContent = projectPodFileContent.replace(regExpToRemove, "");
             if (this.$fs.exists(podfilePath)) {
@@ -146,6 +158,7 @@ end`.trim();
             ? this.$fs.readText(pathToProjectPodfile).trim()
             : "";
         if (projectPodfileContent.indexOf(podfileContent) === -1) {
+            // Remove old occurences of the plugin from the project's Podfile.
             this.removePodfileFromProject(moduleName, podfilePath, projectData, nativeProjectPath);
             let finalPodfileContent = this.$fs.exists(pathToProjectPodfile)
                 ? this.getPodfileContentWithoutTarget(projectData, this.$fs.readText(pathToProjectPodfile))
@@ -163,6 +176,7 @@ end`.trim();
     removePodfileFromProject(moduleName, podfilePath, projectData, projectRoot) {
         if (this.$fs.exists(this.getProjectPodfilePath(projectRoot))) {
             let projectPodFileContent = this.$fs.readText(this.getProjectPodfilePath(projectRoot));
+            // Remove the data between #Begin Podfile and #EndPodfile
             const regExpToRemove = new RegExp(`${this.getPluginPodfileHeader(podfilePath)}[\\s\\S]*?${this.getPluginPodfileEnd()}`, "mg");
             projectPodFileContent = projectPodFileContent.replace(regExpToRemove, "");
             projectPodFileContent = this.removePostInstallHook(moduleName, projectPodFileContent);
@@ -183,7 +197,7 @@ end`.trim();
         }
     }
     getPluginPodfilePath(pluginData) {
-        const pluginPlatformsFolderPath = pluginData.pluginPlatformsFolderPath("ios");
+        const pluginPlatformsFolderPath = pluginData.pluginPlatformsFolderPath("ios" /* PlatformTypes.ios */);
         const pluginPodFilePath = path.join(pluginPlatformsFolderPath, constants_1.PODFILE_NAME);
         return pluginPodFilePath;
     }
@@ -219,6 +233,7 @@ end`.trim();
         if (_.startsWith(projectPodfileContent, podFileHeader)) {
             projectPodfileContent = projectPodfileContent.substr(podFileHeader.length);
             const podFileFooter = this.getPodfileFooter();
+            // Only remove the final end in case the file starts with the podFileHeader
             if (_.endsWith(projectPodfileContent, podFileFooter)) {
                 projectPodfileContent = projectPodfileContent.substr(0, projectPodfileContent.length - podFileFooter.length);
             }
@@ -239,6 +254,8 @@ end`.trim();
         return projectPodFileContent;
     }
     getHookBasicFuncNameForPlugin(hookName, pluginName) {
+        // nativescript-hook and nativescript_hook should have different names, so replace all _ with ___ first and then replace all special symbols with _
+        // This will lead to a clash in case plugins are called nativescript-hook and nativescript___hook
         const replacedPluginName = pluginName
             .replace(/_/g, "___")
             .replace(/[^A-Za-z0-9_]/g, "_");
@@ -252,6 +269,7 @@ end`.trim();
             const newFunctionName = `${this.getHookBasicFuncNameForPlugin(hookName, pluginName)}_${newFunctions.length}`;
             let newDefinition = `def ${newFunctionName}`;
             const rubyFunction = { functionName: newFunctionName };
+            // firstGroup is the block parameter, secondGroup is the block parameter name.
             if (firstGroup && secondGroup) {
                 newDefinition = `${newDefinition} (${secondGroup})`;
                 rubyFunction.functionParameters = secondGroup;
@@ -262,6 +280,7 @@ end`.trim();
         return { replacedContent, newFunctions };
     }
     getPluginPodfileHeader(pluginPodFilePath) {
+        // escape special + from the podfile path (pnpm)
         pluginPodFilePath = pluginPodFilePath.replace(/\+/g, "\\+");
         return `# Begin Podfile - ${pluginPodFilePath}`;
     }
@@ -331,3 +350,4 @@ exports.CocoaPodsService = CocoaPodsService;
 CocoaPodsService.PODFILE_POST_INSTALL_SECTION_NAME = "post_install";
 CocoaPodsService.INSTALLER_BLOCK_PARAMETER_NAME = "installer";
 yok_1.injector.register("cocoapodsService", CocoaPodsService);
+//# sourceMappingURL=cocoapods-service.js.map

package/lib/services/debug-data-service.js

@@ -19,3 +19,4 @@ class DebugDataService {
 }
 exports.DebugDataService = DebugDataService;
 yok_1.injector.register("debugDataService", DebugDataService);
+//# sourceMappingURL=debug-data-service.js.map

package/lib/services/debug-service-base.js

@@ -27,6 +27,12 @@ class DebugServiceBase extends events_1.EventEmitter {
         };
     }
     getChromeDebugUrl(debugOptions, port) {
+        // corresponds to 55.0.2883 Chrome version
+        // SHA is taken from https://chromium.googlesource.com/chromium/src/+/55.0.2883.100
+        // This SHA is old and does not support debugging with HMR.
+        // In case we want to stick with concrete SHA, get it from one of the tags https://chromium.googlesource.com/chromium/src/
+        // IMPORTANT: When you get the SHA, ensure you are using the `parent` commit, not the actual one.
+        // Using the actual commit will result in 404 error in the remote serve.
         const commitSHA = debugOptions.devToolsCommit || "02e6bde1bbe34e43b309d4ef774b1168d25fd024";
         const devToolsProtocol = `devtools`;
         let chromeDevToolsPrefix = `${devToolsProtocol}://devtools/remote/serve_file/@${commitSHA}`;
@@ -42,3 +48,4 @@ class DebugServiceBase extends events_1.EventEmitter {
     }
 }
 exports.DebugServiceBase = DebugServiceBase;
+//# sourceMappingURL=debug-service-base.js.map

package/lib/services/device/device-install-app-service.js

@@ -21,7 +21,7 @@ class DeviceInstallAppService {
         const projectData = this.$projectDataService.getProjectData(buildData.projectDir);
         const platformData = this.$platformsDataService.getPlatformData(platform, projectData);
         await this.$analyticsService.trackEventActionInGoogleAnalytics({
-            action: "Deploy",
+            action: "Deploy" /* TrackActionNames.Deploy */,
             device,
             projectDir: projectData.projectDir,
         });
@@ -77,3 +77,4 @@ class DeviceInstallAppService {
 }
 exports.DeviceInstallAppService = DeviceInstallAppService;
 yok_1.injector.register("deviceInstallAppService", DeviceInstallAppService);
+//# sourceMappingURL=device-install-app-service.js.map

package/lib/services/doctor-service.js

@@ -52,9 +52,13 @@ class DoctorService {
             this.printPackageManagerTip();
         }
         if (!configOptions || configOptions.trackResult) {
+            // TODO(Analytics): Consider sending this information to Google Analytics
+            // await this.$analyticsService.track("DoctorEnvironmentSetup", hasWarnings ? "incorrect" : "correct");
         }
         if (hasWarnings) {
             this.$logger.info("There seem to be issues with your configuration.");
+            // cleanup the cache file as there seems to be issues with the current config
+            // all projects need to be rechecked
             this.$fs.deleteFile(this.jsonFileSettingsPath);
         }
         else {
@@ -68,6 +72,7 @@ class DoctorService {
         catch (err) {
             this.$logger.error("Cannot get the latest versions information from npm. Please try again later.");
         }
+        // todo: check for deprecated imports from `tns-core-modules`
         this.checkForDeprecatedShortImportsInAppDir(configOptions.projectDir);
         await this.$injector
             .resolve("platformEnvironmentRequirements")
@@ -80,12 +85,12 @@ class DoctorService {
     }
     async runSetupScript() {
         await this.$analyticsService.trackEventActionInGoogleAnalytics({
-            action: "Run Setup Script",
+            action: "Run Setup Script" /* TrackActionNames.RunSetupScript */,
             additionalData: "Starting",
         });
         if (this.$hostInfo.isLinux) {
             await this.$analyticsService.trackEventActionInGoogleAnalytics({
-                action: "Run Setup Script",
+                action: "Run Setup Script" /* TrackActionNames.RunSetupScript */,
                 additionalData: "Skipped as OS is Linux",
             });
             return;
@@ -98,13 +103,13 @@ class DoctorService {
             await this.runSetupScriptCore(DoctorService.WindowsSetupScriptExecutable, DoctorService.WindowsSetupScriptArguments);
         }
         await this.$analyticsService.trackEventActionInGoogleAnalytics({
-            action: "Run Setup Script",
+            action: "Run Setup Script" /* TrackActionNames.RunSetupScript */,
             additionalData: "Finished",
         });
     }
     async canExecuteLocalBuild(configuration) {
         await this.$analyticsService.trackEventActionInGoogleAnalytics({
-            action: "Check Local Build Setup",
+            action: "Check Local Build Setup" /* TrackActionNames.CheckLocalBuildSetup */,
             additionalData: "Starting",
         });
         const sysInfoConfig = {
@@ -116,9 +121,11 @@ class DoctorService {
         const warnings = this.filterInfosByType(infos, doctor_1.constants.WARNING_TYPE_NAME);
         const hasWarnings = warnings.length > 0;
         if (hasWarnings) {
+            // cleanup the cache file as there seems to be issues with the current config
+            // all projects need to be rechecked
             this.$fs.deleteFile(this.jsonFileSettingsPath);
             await this.$analyticsService.trackEventActionInGoogleAnalytics({
-                action: "Check Local Build Setup",
+                action: "Check Local Build Setup" /* TrackActionNames.CheckLocalBuildSetup */,
                 additionalData: `Warnings:${warnings.map((w) => w.message).join("__")}`,
             });
             this.printInfosCore(infos);
@@ -128,7 +135,7 @@ class DoctorService {
             await this.$jsonFileSettingsService.saveSetting(this.getKeyForConfiguration(sysInfoConfig), infos);
         }
         await this.$analyticsService.trackEventActionInGoogleAnalytics({
-            action: "Check Local Build Setup",
+            action: "Check Local Build Setup" /* TrackActionNames.CheckLocalBuildSetup */,
             additionalData: `Finished: Is setup correct: ${!hasWarnings}`,
         });
         return !hasWarnings;
@@ -176,6 +183,13 @@ class DoctorService {
             .getFsStats(path.join(pathToTnsCoreModules, entry))
             .isDirectory());
         const stringRegularExpressionsPerDir = coreModulesSubDirs.map((c) => {
+            // require("text");
+            // require("text/smth");
+            // require(   "text/smth");
+            // require(   "text/smth"   );
+            // import * as text from "text";
+            // import { a } from "text";
+            // import {a } from "text/abc"
             const subDirPart = `[\"\']${c}[\"\'/]`;
             return `(\\brequire\\s*?\\(\\s*?${subDirPart})|(\\bimport\\b.*?from\\s*?${subDirPart})`;
         });
@@ -273,3 +287,4 @@ __decorate([
     (0, decorators_1.cache)()
 ], DoctorService.prototype, "$jsonFileSettingsService", null);
 yok_1.injector.register("doctorService", DoctorService);
+//# sourceMappingURL=doctor-service.js.map

package/lib/services/extensibility-service.js

@@ -119,12 +119,17 @@ class ExtensibilityService {
         for (const extensionData of allExtensions) {
             const extensionName = extensionData.package.name;
             try {
+                // now get full package.json for the latest version of the package
                 const registryData = await this.$packageManager.getRegistryPackageData(extensionName);
                 const latestPackageData = registryData.versions[registryData["dist-tags"].latest];
                 const commands = latestPackageData &&
                     latestPackageData.nativescript &&
                     latestPackageData.nativescript.commands;
                 if (commands && commands.length) {
+                    // For each default command we need to add its short syntax in the array of commands.
+                    // For example in case there's a default command called devices list, the commands array will contain devices|*list.
+                    // However, in case the user executes just tns devices, CLI will still execute the tns devices list command.
+                    // So we need to add the devices command as well.
                     _.filter(commands, (command) => command.indexOf(inputOpts.defaultCommandDelimiter) !== -1).forEach((defaultCommand) => {
                         commands.push(defaultCommand.replace(defaultCommandRegExp, ""));
                     });
@@ -146,6 +151,7 @@ class ExtensibilityService {
                 }
             }
             catch (err) {
+                // We do not want to stop the whole process in case we are unable to find data for one of the extensions.
                 this.$logger.trace(`Unable to get data for ${extensionName}. Error is: ${err}`);
             }
         }
@@ -178,6 +184,7 @@ class ExtensibilityService {
         this.assertExtensionsDirExists();
         if (!this.$fs.exists(this.pathToPackageJson)) {
             this.$logger.trace(`Creating ${this.pathToPackageJson}.`);
+            // create default package.json
             this.$fs.writeJson(this.pathToPackageJson, {
                 name: "nativescript-extensibility",
                 version: "1.0.0",
@@ -199,3 +206,4 @@ __decorate([
     (0, decorators_1.cache)()
 ], ExtensibilityService.prototype, "assertPackageJsonExists", null);
 yok_1.injector.register("extensibilityService", ExtensibilityService);
+//# sourceMappingURL=extensibility-service.js.map

package/lib/services/files-hash-service.js

@@ -61,3 +61,4 @@ class FilesHashService {
 }
 exports.FilesHashService = FilesHashService;
 yok_1.injector.register("filesHashService", FilesHashService);
+//# sourceMappingURL=files-hash-service.js.map

package/lib/services/hmr-status-service.js

@@ -56,6 +56,7 @@ class HmrStatusService {
             name: "failedLiveSync",
             platform: this.$devicePlatformsConstants.iOS.toLowerCase(),
         });
+        // webpack5
         const statusStringMap = {
             success: constants_1.HmrConstants.HMR_SUCCESS_STATUS,
             failure: constants_1.HmrConstants.HMR_ERROR_STATUS,
@@ -126,3 +127,4 @@ __decorate([
     (0, decorators_1.cache)()
 ], HmrStatusService.prototype, "attachToHmrStatusEvent", null);
 yok_1.injector.register("hmrStatusService", HmrStatusService);
+//# sourceMappingURL=hmr-status-service.js.map

package/lib/services/info-service.js

@@ -12,3 +12,4 @@ class InfoService {
 }
 exports.InfoService = InfoService;
 yok_1.injector.register("infoService", InfoService);
+//# sourceMappingURL=info-service.js.map

package/lib/services/initialize-service.js

@@ -6,6 +6,8 @@ const _ = require("lodash");
 const constants_1 = require("../constants");
 const yok_1 = require("../common/yok");
 class InitializeService {
+    // NOTE: Do not inject anything here, use $injector.resolve in the code
+    // Injecting something may lead to logger initialization, but we want to initialize it from here.
     constructor($injector) {
         this.$injector = $injector;
     }
@@ -33,6 +35,7 @@ class InitializeService {
             }
         }
         if ($options.json) {
+            // speed up --json commands by not gathering system warnings...
             $logger.trace("Skipping system warnings for --json commands");
         }
         else {
@@ -44,7 +47,7 @@ class InitializeService {
         const systemWarnings = await $sysInfo.getSystemWarnings();
         _.each(systemWarnings, (systemWarning) => {
             const message = `${os_1.EOL}${systemWarning.message}${os_1.EOL}`;
-            if (systemWarning.severity === "high") {
+            if (systemWarning.severity === "high" /* SystemWarningsSeverity.high */) {
                 $logger.error(message);
             }
             else {
@@ -55,3 +58,4 @@ class InitializeService {
 }
 exports.InitializeService = InitializeService;
 yok_1.injector.register("initializeService", InitializeService);
+//# sourceMappingURL=initialize-service.js.map

package/lib/services/ios/export-options-plist-service.js

@@ -54,11 +54,13 @@ class ExportOptionsPlistService {
         plistTemplate += `
 </dict>
 </plist>`;
+        // Save the options...
         const exportOptionsPlistFilePath = await this.$tempService.path({
             prefix: "export-",
             suffix: ".plist",
         });
         this.$fs.writeFile(exportOptionsPlistFilePath, plistTemplate);
+        // The xcodebuild exportPath expects directory and writes the <project-name>.ipa at that directory.
         const exportFileDir = path.resolve(path.dirname(archivePath));
         const exportFilePath = path.join(exportFileDir, projectData.projectName + ".ipa");
         return { exportFileDir, exportFilePath, exportOptionsPlistFilePath };
@@ -96,6 +98,7 @@ class ExportOptionsPlistService {
     <false/>
 </dict>
 </plist>`;
+        // Save the options...
         const exportOptionsPlistFilePath = await this.$tempService.path({
             prefix: "export-",
             suffix: ".plist",
@@ -118,3 +121,4 @@ class ExportOptionsPlistService {
 }
 exports.ExportOptionsPlistService = ExportOptionsPlistService;
 yok_1.injector.register("exportOptionsPlistService", ExportOptionsPlistService);
+//# sourceMappingURL=export-options-plist-service.js.map

package/lib/services/ios/ios-signing-service.js

@@ -45,6 +45,7 @@ class IOSSigningService {
         let shouldUpdateXcode = false;
         if (signing && signing.style === "Automatic") {
             if (signing.team !== teamId) {
+                // Maybe the provided team is name such as "Telerik AD" and we need to convert it to CH******37
                 const teamIdsForName = await this.$iOSProvisionService.getTeamIdsWithName(teamId);
                 if (!teamIdsForName.some((id) => id === signing.team)) {
                     shouldUpdateXcode = true;
@@ -78,6 +79,7 @@ class IOSSigningService {
     }
     async setupSigningFromProvision(projectRoot, projectData, provision, mobileProvisionData) {
         if (!provision) {
+            // read uuid from Xcode an cache...
             return;
         }
         const xcode = this.$pbxprojDomXcode.Xcode.open(this.getPbxProjPath(projectData, projectRoot));
@@ -110,6 +112,7 @@ class IOSSigningService {
                 this.$logger.trace(`Set Manual signing style and provisioning profile: ${configuration.name} (${configuration.uuid})`);
             });
             xcode.save();
+            // this.cache(uuid);
         }
         else {
             this.$logger.trace(`The specified provisioning profile is already set in the Xcode: ${provision}`);
@@ -266,3 +269,4 @@ class IOSSigningService {
 }
 exports.IOSSigningService = IOSSigningService;
 yok_1.injector.register("iOSSigningService", IOSSigningService);
+//# sourceMappingURL=ios-signing-service.js.map

package/lib/services/ios/spm-service.js

@@ -15,11 +15,16 @@ class SPMService {
         const spmPackages = this.$projectConfigService.getValue(`${platform}.SPMPackages`, []);
         return spmPackages;
     }
+    // note: this is not used anywhere at the moment.
+    // public hasSPMPackages(projectData: IProjectData): boolean {
+    // 	return this.getSPMPackages(projectData).length > 0;
+    // }
     async applySPMPackages(platformData, projectData, pluginSpmPackages) {
         var _a;
         try {
             const spmPackages = this.getSPMPackages(projectData, platformData.platformNameLowerCase);
             if (pluginSpmPackages === null || pluginSpmPackages === void 0 ? void 0 : pluginSpmPackages.length) {
+                // include swift packages from plugin configs
                 spmPackages.push(...pluginSpmPackages);
             }
             if (!spmPackages.length) {
@@ -33,17 +38,21 @@ class SPMService {
                 enableAndroid: false,
             });
             await project.load();
+            // note: in trapeze both visionOS and iOS are handled by the ios project.
             if (!project.ios) {
                 this.$logger.trace("SPM: no iOS project found via trapeze.");
                 return;
             }
+            // todo: handle removing packages? Or just warn and require a clean?
             for (const pkg of spmPackages) {
                 if ("path" in pkg) {
+                    // resolve the path relative to the project root
                     this.$logger.trace("SPM: resolving path for package: ", pkg.path);
                     pkg.path = path.resolve(projectData.projectDir, pkg.path);
                 }
                 this.$logger.trace(`SPM: adding package ${pkg.name} to project.`, pkg);
                 await project.ios.addSPMPackage(projectData.projectName, pkg);
+                // Add to other Targets if specified (like widgets, etc.)
                 if ((_a = pkg.targets) === null || _a === void 0 ? void 0 : _a.length) {
                     for (const target of pkg.targets) {
                         await project.ios.addSPMPackage(target, pkg);
@@ -51,6 +60,7 @@ class SPMService {
                 }
             }
             await project.commit();
+            // finally resolve the dependencies
             await this.resolveSPMDependencies(platformData, projectData);
         }
         catch (err) {
@@ -72,3 +82,4 @@ class SPMService {
 }
 exports.SPMService = SPMService;
 yok_1.injector.register("spmService", SPMService);
+//# sourceMappingURL=spm-service.js.map

package/lib/services/ios/xcodebuild-args-service.js

@@ -88,6 +88,8 @@ class XcodebuildArgsService {
     }
     getXcodeProjectArgs(platformData, projectData) {
         const xcworkspacePath = path.join(platformData.projectRoot, `${projectData.projectName}.xcworkspace`);
+        // Introduced in Xcode 14+
+        // ref: https://forums.swift.org/t/telling-xcode-14-beta-4-to-trust-build-tool-plugins-programatically/59305/5
         const skipPackageValidation = "-skipPackagePluginValidation";
         const extraArgs = [
             "-scheme",
@@ -95,6 +97,12 @@ class XcodebuildArgsService {
             skipPackageValidation,
         ];
         const BUILD_SETTINGS_FILE_PATH = path.join(projectData.appResourcesDirectoryPath, platformData.normalizedPlatformName, constants.BUILD_XCCONFIG_FILE_NAME);
+        // Only include explicit properties from build.xcconfig
+        // Note: we could include entire file via -xcconfig flag
+        // however doing so introduces unwanted side effects
+        // like cocoapods issues related to ASSETCATALOG_COMPILER_APPICON_NAME
+        // references: https://medium.com/@iostechset/why-cocoapods-eats-app-icons-79fe729808d4
+        // https://github.com/CocoaPods/CocoaPods/issues/7003
         const deployTargetProperty = "IPHONEOS_DEPLOYMENT_TARGET";
         const deployTargetVersion = this.$xcconfigService.readPropertyValue(BUILD_SETTINGS_FILE_PATH, deployTargetProperty);
         if (deployTargetVersion) {
@@ -144,3 +152,4 @@ class XcodebuildArgsService {
 }
 exports.XcodebuildArgsService = XcodebuildArgsService;
 yok_1.injector.register("xcodebuildArgsService", XcodebuildArgsService);
+//# sourceMappingURL=xcodebuild-args-service.js.map

package/lib/services/ios/xcodebuild-command-service.js

@@ -27,3 +27,4 @@ class XcodebuildCommandService {
 }
 exports.XcodebuildCommandService = XcodebuildCommandService;
 yok_1.injector.register("xcodebuildCommandService", XcodebuildCommandService);
+//# sourceMappingURL=xcodebuild-command-service.js.map

package/lib/services/ios/xcodebuild-service.js

@@ -64,7 +64,7 @@ class XcodebuildService {
             output.exportFileDir,
             "-exportOptionsPlist",
             output.exportOptionsPlistFilePath,
-            provision ? "" : "-allowProvisioningUpdates",
+            provision ? "" : "-allowProvisioningUpdates", // no profiles specificed so let xcode decide.
         ];
         await this.$xcodebuildCommandService.executeCommand(args, {
             cwd: platformData.projectRoot,
@@ -74,3 +74,4 @@ class XcodebuildService {
 }
 exports.XcodebuildService = XcodebuildService;
 yok_1.injector.register("xcodebuildService", XcodebuildService);
+//# sourceMappingURL=xcodebuild-service.js.map

package/lib/services/ios-debugger-port-service.js

@@ -125,3 +125,4 @@ __decorate([
     (0, decorators_1.cache)()
 ], IOSDebuggerPortService.prototype, "attachToAttachRequestEvent", null);
 yok_1.injector.register("iOSDebuggerPortService", IOSDebuggerPortService);
+//# sourceMappingURL=ios-debugger-port-service.js.map

package/lib/services/ios-device-debug-service.js

@@ -138,3 +138,4 @@ __decorate([
     (0, decorators_1.performanceLog)()
 ], IOSDeviceDebugService.prototype, "openAppInspector", null);
 yok_1.injector.register("iOSDeviceDebugService", IOSDeviceDebugService, false);
+//# sourceMappingURL=ios-device-debug-service.js.map

package/lib/services/ios-entitlements-service.js

@@ -65,3 +65,4 @@ class IOSEntitlementsService {
 exports.IOSEntitlementsService = IOSEntitlementsService;
 IOSEntitlementsService.DefaultEntitlementsName = "app.entitlements";
 yok_1.injector.register("iOSEntitlementsService", IOSEntitlementsService);
+//# sourceMappingURL=ios-entitlements-service.js.map

package/lib/services/ios-extensions-service.js

@@ -50,3 +50,4 @@ class IOSExtensionsService {
 }
 exports.IOSExtensionsService = IOSExtensionsService;
 yok_1.injector.register("iOSExtensionsService", IOSExtensionsService);
+//# sourceMappingURL=ios-extensions-service.js.map