Fix "Cannot find connected devices" error when the env is not properly configured and "Sync to Playground" option is selected

Fatme · Fatme · commit c91958d2c682 · 2018-09-14T11:14:00.000+03:00
diff --git a/lib/bootstrap.ts b/lib/bootstrap.ts
@@ -130,6 +130,7 @@ $injector.require("androidLiveSyncService", "./services/livesync/android-livesyn
 $injector.require("iOSLiveSyncService", "./services/livesync/ios-livesync-service");
 $injector.require("usbLiveSyncService", "./services/livesync/livesync-service"); // The name is used in https://github.com/NativeScript/nativescript-dev-typescript
 $injector.require("previewAppLiveSyncService", "./services/livesync/playground/preview-app-livesync-service");
+$injector.require("previewAppPluginsService", "./services/livesync/playground/preview-app-plugins-service");
 $injector.require("previewSdkService", "./services/livesync/playground/preview-sdk-service");
 $injector.requirePublic("sysInfo", "./sys-info");
 
diff --git a/lib/commands/run.ts b/lib/commands/run.ts
@@ -3,6 +3,7 @@ import { ANDROID_RELEASE_BUILD_ERROR_MESSAGE } from "../constants";
 import { cache } from "../common/decorators";
 
 export class RunCommandBase implements ICommand {
+	private liveSyncCommandHelperAdditionalOptions: ILiveSyncCommandHelperAdditionalOptions = <ILiveSyncCommandHelperAdditionalOptions>{};
 
 	public platform: string;
 	constructor(private $projectData: IProjectData,
@@ -13,7 +14,7 @@ export class RunCommandBase implements ICommand {
 
 	public allowedParameters: ICommandParameter[] = [];
 	public async execute(args: string[]): Promise<void> {
-		return this.$liveSyncCommandHelper.executeCommandLiveSync(this.platform);
+		return this.$liveSyncCommandHelper.executeCommandLiveSync(this.platform, this.liveSyncCommandHelperAdditionalOptions);
 	}
 
 	public async canExecute(args: string[]): Promise<boolean> {
@@ -28,7 +29,11 @@ export class RunCommandBase implements ICommand {
 			this.platform = this.$devicePlatformsConstants.Android;
 		}
 
-		await this.$liveSyncCommandHelper.validatePlatform(this.platform);
+		const validatePlatformOutput = await this.$liveSyncCommandHelper.validatePlatform(this.platform);
+		if (validatePlatformOutput && validatePlatformOutput[this.platform.toLowerCase()]) {
+			const checkEnvironmentRequirementsOutput = validatePlatformOutput[this.platform.toLowerCase()].checkEnvironmentRequirementsOutput;
+			this.liveSyncCommandHelperAdditionalOptions.syncToPreviewApp = checkEnvironmentRequirementsOutput && checkEnvironmentRequirementsOutput.selectedOption === "Sync to Playground";
+		}
 
 		return true;
 	}
@@ -68,7 +73,8 @@ export class RunIosCommand implements ICommand {
 	}
 
 	public async canExecute(args: string[]): Promise<boolean> {
-		return await this.runCommand.canExecute(args) && await this.$platformService.validateOptions(this.$options.provision, this.$options.teamId, this.$projectData, this.$platformsData.availablePlatforms.iOS);
+		const result = await this.runCommand.canExecute(args) && await this.$platformService.validateOptions(this.$options.provision, this.$options.teamId, this.$projectData, this.$platformsData.availablePlatforms.iOS);
+		return result;
 	}
 }
 
@@ -110,6 +116,7 @@ export class RunAndroidCommand implements ICommand {
 		if (this.$options.release && (!this.$options.keyStorePath || !this.$options.keyStorePassword || !this.$options.keyStoreAlias || !this.$options.keyStoreAliasPassword)) {
 			this.$errors.fail(ANDROID_RELEASE_BUILD_ERROR_MESSAGE);
 		}
+
 		return this.$platformService.validateOptions(this.$options.provision, this.$options.teamId, this.$projectData, this.$platformsData.availablePlatforms.Android);
 	}
 }
diff --git a/lib/definitions/livesync.d.ts b/lib/definitions/livesync.d.ts
@@ -524,6 +524,7 @@ interface ILiveSyncCommandHelperAdditionalOptions extends IBuildPlatformAction,
 	 * @returns {string} The build output directory.
 	 */
 	getOutputDirectory?(options: IOutputDirectoryOptions): string;
+	syncToPreviewApp?: boolean;
 }
 
 interface ILiveSyncCommandHelper {
@@ -542,7 +543,7 @@ interface ILiveSyncCommandHelper {
 	 * @param {string} platform The platform to be validated.
 	 * @return {Promise<void>}
 	 */
-	validatePlatform(platform: string): Promise<void>;
+	validatePlatform(platform: string): Promise<IDictionary<IValidateOutput>>;
 
 	/**
 	 * Executes livesync operation. Meant to be called from within a command.
diff --git a/lib/definitions/platform.d.ts b/lib/definitions/platform.d.ts
@@ -391,5 +391,10 @@ interface IUpdateAppOptions extends IOptionalFilesToSync, IOptionalFilesToRemove
 }
 
 interface IPlatformEnvironmentRequirements {
-	checkEnvironmentRequirements(platform?: string, projectDir?: string, runtimeVersion?: string): Promise<boolean>;
+	checkEnvironmentRequirements(platform?: string, projectDir?: string, runtimeVersion?: string): Promise<ICheckEnvironmentRequirementsOutput>;
+}
+
+interface ICheckEnvironmentRequirementsOutput {
+	canExecute: boolean;
+	selectedOption: string;
 }
diff --git a/lib/definitions/preview-app-livesync.d.ts b/lib/definitions/preview-app-livesync.d.ts
@@ -16,4 +16,8 @@ declare global {
 		applyChanges(files: FilePayload[]): Promise<void>;
 		stop(): void;
 	}
+
+	interface IPreviewAppPluginsService {
+		comparePluginsOnDevice(device: Device): Promise<void>;
+	}
 }
diff --git a/lib/definitions/project.d.ts b/lib/definitions/project.d.ts
@@ -319,7 +319,7 @@ interface ICleanNativeAppData extends IProjectDir, IPlatform { }
 
 interface IPlatformProjectService extends NodeJS.EventEmitter, IPlatformProjectServiceBase {
 	getPlatformData(projectData: IProjectData): IPlatformData;
-	validate(projectData: IProjectData): Promise<void>;
+	validate(projectData: IProjectData): Promise<IValidateOutput>;
 	createProject(frameworkDir: string, frameworkVersion: string, projectData: IProjectData, config: ICreateProjectOptions): Promise<void>;
 	interpolateData(projectData: IProjectData, platformSpecificData: IPlatformSpecificData): Promise<void>;
 	interpolateConfigurationFile(projectData: IProjectData, platformSpecificData: IPlatformSpecificData): void;
@@ -438,6 +438,10 @@ interface IPlatformProjectService extends NodeJS.EventEmitter, IPlatformProjectS
 	checkIfPluginsNeedBuild(projectData: IProjectData): Promise<Array<any>>;
 }
 
+interface IValidateOutput {
+	checkEnvironmentRequirementsOutput: ICheckEnvironmentRequirementsOutput;
+}
+
 interface ITestExecutionService {
 	startTestRunner(platform: string, projectData: IProjectData, projectFilesConfig: IProjectFilesConfig): Promise<void>;
 	startKarmaServer(platform: string, projectData: IProjectData, projectFilesConfig: IProjectFilesConfig): Promise<void>;
diff --git a/lib/helpers/livesync-command-helper.ts b/lib/helpers/livesync-command-helper.ts
@@ -26,6 +26,10 @@ export class LiveSyncCommandHelper implements ILiveSyncCommandHelper {
 			this.$logger.info("Skipping node_modules folder! Use the syncAllFiles option to sync files from this folder.");
 		}
 
+		if (additionalOptions && additionalOptions.syncToPreviewApp) {
+			return;
+		}
+
 		const emulator = this.$options.emulator;
 		await this.$devicesService.initialize({
 			deviceId: this.$options.device,
@@ -123,15 +127,20 @@ export class LiveSyncCommandHelper implements ILiveSyncCommandHelper {
 		await this.$liveSyncService.liveSync(deviceDescriptors, liveSyncInfo);
 	}
 
-	public async validatePlatform(platform: string) {
+	public async validatePlatform(platform: string): Promise<IDictionary<IValidateOutput>> {
+		const result: IDictionary<IValidateOutput> = {};
+
 		const availablePlatforms = this.getPlatformsForOperation(platform);
 		for (const availablePlatform of availablePlatforms) {
 			const platformData = this.$platformsData.getPlatformData(availablePlatform, this.$projectData);
 			const platformProjectService = platformData.platformProjectService;
-			await platformProjectService.validate(this.$projectData);
+			const validateOutput = await platformProjectService.validate(this.$projectData);
+			result[availablePlatform.toLowerCase()] = validateOutput;
 		}
 
 		this.$bundleValidatorHelper.validate();
+
+		return result;
 	}
 
 	private async runInReleaseMode(platform: string, additionalOptions?: ILiveSyncCommandHelperAdditionalOptions): Promise<void> {
diff --git a/lib/services/android-project-service.ts b/lib/services/android-project-service.ts
@@ -118,12 +118,16 @@ export class AndroidProjectService extends projectServiceBaseLib.PlatformProject
 		}
 	}
 
-	public async validate(projectData: IProjectData): Promise<void> {
+	public async validate(projectData: IProjectData): Promise<IValidateOutput> {
 		this.validatePackageName(projectData.projectId);
 		this.validateProjectName(projectData.projectName);
 
-		await this.$platformEnvironmentRequirements.checkEnvironmentRequirements(this.getPlatformData(projectData).normalizedPlatformName, projectData.projectDir);
+		const checkEnvironmentRequirementsOutput = await this.$platformEnvironmentRequirements.checkEnvironmentRequirements(this.getPlatformData(projectData).normalizedPlatformName, projectData.projectDir);
 		this.$androidToolsInfo.validateTargetSdk({ showWarningsAsErrors: true });
+
+		return {
+			checkEnvironmentRequirementsOutput
+		};
 	}
 
 	public async validatePlugins(): Promise<void> { /* */ }
diff --git a/lib/services/ios-project-service.ts b/lib/services/ios-project-service.ts
@@ -133,17 +133,21 @@ export class IOSProjectService extends projectServiceBaseLib.PlatformProjectServ
 		return path.join(this.getPlatformData(projectData).projectRoot, projectData.projectName, "Resources");
 	}
 
-	public async validate(projectData: IProjectData): Promise<void> {
+	public async validate(projectData: IProjectData): Promise<IValidateOutput> {
 		if (!this.$hostInfo.isDarwin) {
 			return;
 		}
 
-		await this.$platformEnvironmentRequirements.checkEnvironmentRequirements(this.getPlatformData(projectData).normalizedPlatformName, projectData.projectDir);
+		const checkEnvironmentRequirementsOutput = await this.$platformEnvironmentRequirements.checkEnvironmentRequirements(this.getPlatformData(projectData).normalizedPlatformName, projectData.projectDir);
 
 		const xcodeBuildVersion = await this.getXcodeVersion();
 		if (helpers.versionCompare(xcodeBuildVersion, IOSProjectService.XCODEBUILD_MIN_VERSION) < 0) {
 			this.$errors.fail("NativeScript can only run in Xcode version %s or greater", IOSProjectService.XCODEBUILD_MIN_VERSION);
 		}
+
+		return {
+			checkEnvironmentRequirementsOutput
+		};
 	}
 
 	// TODO: Remove Promise, reason: readDirectory - unable until androidProjectService has async operations.
diff --git a/lib/services/platform-environment-requirements.ts b/lib/services/platform-environment-requirements.ts
@@ -31,7 +31,7 @@ export class PlatformEnvironmentRequirements implements IPlatformEnvironmentRequ
 	private static MISSING_LOCAL_AND_CLOUD_SETUP_MESSAGE = `You are missing the ${NATIVESCRIPT_CLOUD_EXTENSION_NAME} extension and you will not be able to execute cloud builds. ${PlatformEnvironmentRequirements.MISSING_LOCAL_SETUP_MESSAGE} ${PlatformEnvironmentRequirements.CHOOSE_OPTIONS_MESSAGE} `;
 	private static MISSING_LOCAL_BUT_CLOUD_SETUP_MESSAGE = `You have ${NATIVESCRIPT_CLOUD_EXTENSION_NAME} extension installed, so you can execute cloud builds, but ${_.lowerFirst(PlatformEnvironmentRequirements.MISSING_LOCAL_SETUP_MESSAGE)}`;
 	private static RUN_TNS_SETUP_MESSAGE = 'Run $ tns setup command to run the setup script to try to automatically configure your environment for local builds.';
-	private static SYNC_TO_PREVIEW_APP_MESSAGE = `Select "Sync to Playground" to enjoy NativeScript without any local setup. All you need is a couple of companion apps installed on you devices.`;
+	private static SYNC_TO_PREVIEW_APP_MESSAGE = `Select "Sync to Playground" to enjoy NativeScript without any local setup. All you need is a couple of companion apps installed on your devices.`;
 	private static RUN_PREVIEW_COMMAND_MESSAGE = `Run $ tns preview command to enjoy NativeScript without any local setup.`;
 
 	private cliCommandToCloudCommandName: IStringDictionary = {
@@ -40,13 +40,18 @@ export class PlatformEnvironmentRequirements implements IPlatformEnvironmentRequ
 		"deploy": "tns cloud deploy"
 	};
 
-	public async checkEnvironmentRequirements(platform?: string, projectDir?: string, runtimeVersion?: string): Promise<boolean> {
+	public async checkEnvironmentRequirements(platform?: string, projectDir?: string, runtimeVersion?: string): Promise<ICheckEnvironmentRequirementsOutput> {
+		let selectedOption = null;
+
 		if (process.env.NS_SKIP_ENV_CHECK) {
 			await this.$analyticsService.trackEventActionInGoogleAnalytics({
 				action: TrackActionNames.CheckEnvironmentRequirements,
 				additionalData: "Skipped: NS_SKIP_ENV_CHECK is set"
 			});
-			return true;
+			return {
+				canExecute: true,
+				selectedOption
+			};
 		}
 
 		const canExecute = await this.$doctorService.canExecuteLocalBuild(platform, projectDir, runtimeVersion);
@@ -75,7 +80,7 @@ export class PlatformEnvironmentRequirements implements IPlatformEnvironmentRequ
 					PlatformEnvironmentRequirements.MANUALLY_SETUP_OPTION_NAME,
 				];
 
-			const selectedOption = await this.promptForChoice({ infoMessage, choices });
+			selectedOption = await this.promptForChoice({ infoMessage, choices });
 
 			await this.processCloudBuildsIfNeeded(selectedOption, platform);
 			this.processManuallySetupIfNeeded(selectedOption, platform);
@@ -85,7 +90,10 @@ export class PlatformEnvironmentRequirements implements IPlatformEnvironmentRequ
 				await this.$doctorService.runSetupScript();
 
 				if (await this.$doctorService.canExecuteLocalBuild(platform, projectDir, runtimeVersion)) {
-					return true;
+					return {
+						canExecute: true,
+						selectedOption
+					};
 				}
 
 				if (this.$nativeScriptCloudExtensionService.isInstalled()) {
@@ -116,7 +124,10 @@ export class PlatformEnvironmentRequirements implements IPlatformEnvironmentRequ
 			if (selectedOption === PlatformEnvironmentRequirements.BOTH_CLOUD_SETUP_AND_LOCAL_SETUP_OPTION_NAME) {
 				await this.processBothCloudBuildsAndSetupScript();
 				if (await this.$doctorService.canExecuteLocalBuild(platform, projectDir, runtimeVersion)) {
-					return true;
+					return {
+						canExecute: true,
+						selectedOption
+					};
 				}
 
 				this.processManuallySetup(platform);
@@ -125,7 +136,10 @@ export class PlatformEnvironmentRequirements implements IPlatformEnvironmentRequ
 			this.processTryCloudSetupIfNeeded(selectedOption, platform);
 		}
 
-		return true;
+		return {
+			canExecute,
+			selectedOption
+		};
 	}
 
 	private async processCloudBuildsIfNeeded(selectedOption: string, platform?: string): Promise<void> {
diff --git a/test/stubs.ts b/test/stubs.ts
@@ -331,8 +331,8 @@ export class PlatformProjectServiceStub extends EventEmitter implements IPlatfor
 	validateOptions(): Promise<boolean> {
 		return Promise.resolve(true);
 	}
-	validate(): Promise<void> {
-		return Promise.resolve();
+	validate(): Promise<IValidateOutput> {
+		return Promise.resolve(<IValidateOutput>{});
 	}
 	validatePlugins(projectData: IProjectData) {
 		return Promise.resolve();

Original file line number	Diff line number	Diff line change
`@@ -3,6 +3,7 @@ import { ANDROID_RELEASE_BUILD_ERROR_MESSAGE } from "../constants";`
`3`	`3`	`import { cache } from "../common/decorators";`
`4`	`4`
`5`	`5`	`export class RunCommandBase implements ICommand {`
	`6`	`+ private liveSyncCommandHelperAdditionalOptions: ILiveSyncCommandHelperAdditionalOptions = <ILiveSyncCommandHelperAdditionalOptions>{};`
`6`	`7`
`7`	`8`	`public platform: string;`
`8`	`9`	`constructor(private $projectData: IProjectData,`
`@@ -13,7 +14,7 @@ export class RunCommandBase implements ICommand {`
`13`	`14`
`14`	`15`	`public allowedParameters: ICommandParameter[] = [];`
`15`	`16`	`public async execute(args: string[]): Promise<void> {`
`16`		`- return this.$liveSyncCommandHelper.executeCommandLiveSync(this.platform);`
	`17`	`+ return this.$liveSyncCommandHelper.executeCommandLiveSync(this.platform, this.liveSyncCommandHelperAdditionalOptions);`
`17`	`18`	`}`
`18`	`19`
`19`	`20`	`public async canExecute(args: string[]): Promise<boolean> {`
`@@ -28,7 +29,11 @@ export class RunCommandBase implements ICommand {`
`28`	`29`	`this.platform = this.$devicePlatformsConstants.Android;`
`29`	`30`	`}`
`30`	`31`
`31`		`- await this.$liveSyncCommandHelper.validatePlatform(this.platform);`
	`32`	`+ const validatePlatformOutput = await this.$liveSyncCommandHelper.validatePlatform(this.platform);`
	`33`	`+ if (validatePlatformOutput && validatePlatformOutput[this.platform.toLowerCase()]) {`
	`34`	`+ const checkEnvironmentRequirementsOutput = validatePlatformOutput[this.platform.toLowerCase()].checkEnvironmentRequirementsOutput;`
	`35`	`+ this.liveSyncCommandHelperAdditionalOptions.syncToPreviewApp = checkEnvironmentRequirementsOutput && checkEnvironmentRequirementsOutput.selectedOption === "Sync to Playground";`
	`36`	`+ }`
`32`	`37`
`33`	`38`	`return true;`
`34`	`39`	`}`
`@@ -68,7 +73,8 @@ export class RunIosCommand implements ICommand {`
`68`	`73`	`}`
`69`	`74`
`70`	`75`	`public async canExecute(args: string[]): Promise<boolean> {`
`71`		`- return await this.runCommand.canExecute(args) && await this.$platformService.validateOptions(this.$options.provision, this.$options.teamId, this.$projectData, this.$platformsData.availablePlatforms.iOS);`
	`76`	`+ const result = await this.runCommand.canExecute(args) && await this.$platformService.validateOptions(this.$options.provision, this.$options.teamId, this.$projectData, this.$platformsData.availablePlatforms.iOS);`
	`77`	`+ return result;`
`72`	`78`	`}`
`73`	`79`	`}`
`74`	`80`
`@@ -110,6 +116,7 @@ export class RunAndroidCommand implements ICommand {`
`110`	`116`	`if (this.$options.release && (!this.$options.keyStorePath \|\| !this.$options.keyStorePassword \|\| !this.$options.keyStoreAlias \|\| !this.$options.keyStoreAliasPassword)) {`
`111`	`117`	`this.$errors.fail(ANDROID_RELEASE_BUILD_ERROR_MESSAGE);`
`112`	`118`	`}`
	`119`	`+`
`113`	`120`	`return this.$platformService.validateOptions(this.$options.provision, this.$options.teamId, this.$projectData, this.$platformsData.availablePlatforms.Android);`
`114`	`121`	`}`
`115`	`122`	`}`
Original file line number	Diff line number	Diff line change
`@@ -391,5 +391,10 @@ interface IUpdateAppOptions extends IOptionalFilesToSync, IOptionalFilesToRemove`
`391`	`391`	`}`
`392`	`392`
`393`	`393`	`interface IPlatformEnvironmentRequirements {`
`394`		`- checkEnvironmentRequirements(platform?: string, projectDir?: string, runtimeVersion?: string): Promise<boolean>;`
	`394`	`+ checkEnvironmentRequirements(platform?: string, projectDir?: string, runtimeVersion?: string): Promise<ICheckEnvironmentRequirementsOutput>;`
	`395`	`+}`
	`396`	`+`
	`397`	`+interface ICheckEnvironmentRequirementsOutput {`
	`398`	`+ canExecute: boolean;`
	`399`	`+ selectedOption: string;`
`395`	`400`	`}`
Original file line number	Diff line number	Diff line change
`@@ -16,4 +16,8 @@ declare global {`
`16`	`16`	`applyChanges(files: FilePayload[]): Promise<void>;`
`17`	`17`	`stop(): void;`
`18`	`18`	`}`
	`19`	`+`
	`20`	`+ interface IPreviewAppPluginsService {`
	`21`	`+ comparePluginsOnDevice(device: Device): Promise<void>;`
	`22`	`+ }`
`19`	`23`	`}`
Original file line number	Diff line number	Diff line change
`@@ -118,12 +118,16 @@ export class AndroidProjectService extends projectServiceBaseLib.PlatformProject`
`118`	`118`	`}`
`119`	`119`	`}`
`120`	`120`
`121`		`- public async validate(projectData: IProjectData): Promise<void> {`
	`121`	`+ public async validate(projectData: IProjectData): Promise<IValidateOutput> {`
`122`	`122`	`this.validatePackageName(projectData.projectId);`
`123`	`123`	`this.validateProjectName(projectData.projectName);`
`124`	`124`
`125`		`- await this.$platformEnvironmentRequirements.checkEnvironmentRequirements(this.getPlatformData(projectData).normalizedPlatformName, projectData.projectDir);`
	`125`	`+ const checkEnvironmentRequirementsOutput = await this.$platformEnvironmentRequirements.checkEnvironmentRequirements(this.getPlatformData(projectData).normalizedPlatformName, projectData.projectDir);`
`126`	`126`	`this.$androidToolsInfo.validateTargetSdk({ showWarningsAsErrors: true });`
	`127`	`+`
	`128`	`+ return {`
	`129`	`+ checkEnvironmentRequirementsOutput`
	`130`	`+ };`
`127`	`131`	`}`
`128`	`132`
`129`	`133`	`public async validatePlugins(): Promise<void> { /* */ }`
Original file line number	Diff line number	Diff line change
`@@ -133,17 +133,21 @@ export class IOSProjectService extends projectServiceBaseLib.PlatformProjectServ`
`133`	`133`	`return path.join(this.getPlatformData(projectData).projectRoot, projectData.projectName, "Resources");`
`134`	`134`	`}`
`135`	`135`
`136`		`- public async validate(projectData: IProjectData): Promise<void> {`
	`136`	`+ public async validate(projectData: IProjectData): Promise<IValidateOutput> {`
`137`	`137`	`if (!this.$hostInfo.isDarwin) {`
`138`	`138`	`return;`
`139`	`139`	`}`
`140`	`140`
`141`		`- await this.$platformEnvironmentRequirements.checkEnvironmentRequirements(this.getPlatformData(projectData).normalizedPlatformName, projectData.projectDir);`
	`141`	`+ const checkEnvironmentRequirementsOutput = await this.$platformEnvironmentRequirements.checkEnvironmentRequirements(this.getPlatformData(projectData).normalizedPlatformName, projectData.projectDir);`
`142`	`142`
`143`	`143`	`const xcodeBuildVersion = await this.getXcodeVersion();`
`144`	`144`	`if (helpers.versionCompare(xcodeBuildVersion, IOSProjectService.XCODEBUILD_MIN_VERSION) < 0) {`
`145`	`145`	`this.$errors.fail("NativeScript can only run in Xcode version %s or greater", IOSProjectService.XCODEBUILD_MIN_VERSION);`
`146`	`146`	`}`
	`147`	`+`
	`148`	`+ return {`
	`149`	`+ checkEnvironmentRequirementsOutput`
	`150`	`+ };`
`147`	`151`	`}`
`148`	`152`
`149`	`153`	`// TODO: Remove Promise, reason: readDirectory - unable until androidProjectService has async operations.`