@theia/external-terminal 1.34.1 → 1.34.3

package/src/common/external-terminal.ts

@@ -1,55 +1,55 @@
-// *****************************************************************************
-// Copyright (C) 2021 Ericsson and others.
-//
-// This program and the accompanying materials are made available under the
-// terms of the Eclipse Public License v. 2.0 which is available at
-// http://www.eclipse.org/legal/epl-2.0.
-//
-// This Source Code may also be made available under the following Secondary
-// Licenses when the conditions for such availability set forth in the Eclipse
-// Public License v. 2.0 are satisfied: GNU General Public License, version 2
-// with the GNU Classpath Exception which is available at
-// https://www.gnu.org/software/classpath/license.html.
-//
-// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
-// *****************************************************************************
-
-export const ExternalTerminalService = Symbol('ExternalTerminalService');
-export const externalTerminalServicePath = '/services/external-terminal';
-
-/**
- * Represents the external terminal configuration options.
- */
-export interface ExternalTerminalConfiguration {
-    /**
-     * The external terminal executable for Windows.
-     */
-    'terminal.external.windowsExec': string;
-    /**
-     * The external terminal executable for OSX.
-     */
-    'terminal.external.osxExec': string;
-    /**
-     * The external terminal executable for Linux.
-     */
-    'terminal.external.linuxExec': string;
-}
-
-export interface ExternalTerminalService {
-
-    /**
-     * Open a native terminal in the designated working directory.
-     *
-     * @param configuration the configuration for opening external terminals.
-     * @param cwd the string URI of the current working directory where the terminal should open from.
-     */
-    openTerminal(configuration: ExternalTerminalConfiguration, cwd: string): Promise<void>;
-
-    /**
-     * Get the default executable.
-     *
-     * @returns the default terminal executable.
-     */
-    getDefaultExec(): Promise<string>;
-
-}
+// *****************************************************************************
+// Copyright (C) 2021 Ericsson and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
+// *****************************************************************************
+
+export const ExternalTerminalService = Symbol('ExternalTerminalService');
+export const externalTerminalServicePath = '/services/external-terminal';
+
+/**
+ * Represents the external terminal configuration options.
+ */
+export interface ExternalTerminalConfiguration {
+    /**
+     * The external terminal executable for Windows.
+     */
+    'terminal.external.windowsExec': string;
+    /**
+     * The external terminal executable for OSX.
+     */
+    'terminal.external.osxExec': string;
+    /**
+     * The external terminal executable for Linux.
+     */
+    'terminal.external.linuxExec': string;
+}
+
+export interface ExternalTerminalService {
+
+    /**
+     * Open a native terminal in the designated working directory.
+     *
+     * @param configuration the configuration for opening external terminals.
+     * @param cwd the string URI of the current working directory where the terminal should open from.
+     */
+    openTerminal(configuration: ExternalTerminalConfiguration, cwd: string): Promise<void>;
+
+    /**
+     * Get the default executable.
+     *
+     * @returns the default terminal executable.
+     */
+    getDefaultExec(): Promise<string>;
+
+}

package/src/electron-browser/external-terminal-contribution.ts

@@ -1,116 +1,116 @@
-// *****************************************************************************
-// Copyright (C) 2021 Ericsson and others.
-//
-// This program and the accompanying materials are made available under the
-// terms of the Eclipse Public License v. 2.0 which is available at
-// http://www.eclipse.org/legal/epl-2.0.
-//
-// This Source Code may also be made available under the following Secondary
-// Licenses when the conditions for such availability set forth in the Eclipse
-// Public License v. 2.0 are satisfied: GNU General Public License, version 2
-// with the GNU Classpath Exception which is available at
-// https://www.gnu.org/software/classpath/license.html.
-//
-// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
-// *****************************************************************************
-
-import { inject, injectable } from '@theia/core/shared/inversify';
-import { Command, CommandContribution, CommandRegistry } from '@theia/core/lib/common';
-import { EnvVariablesServer } from '@theia/core/lib/common/env-variables';
-import { KeybindingContribution, KeybindingRegistry, LabelProvider } from '@theia/core/lib/browser';
-import { EditorManager } from '@theia/editor/lib/browser/editor-manager';
-import { WorkspaceService } from '@theia/workspace/lib/browser';
-import { ExternalTerminalService } from '../common/external-terminal';
-import { ExternalTerminalPreferenceService } from './external-terminal-preference';
-import { QuickPickService } from '@theia/core/lib/common/quick-pick-service';
-import { nls } from '@theia/core/lib/common/nls';
-
-export namespace ExternalTerminalCommands {
-    export const OPEN_NATIVE_CONSOLE = Command.toDefaultLocalizedCommand({
-        id: 'workbench.action.terminal.openNativeConsole',
-        label: 'Open New External Terminal'
-    });
-}
-
-@injectable()
-export class ExternalTerminalFrontendContribution implements CommandContribution, KeybindingContribution {
-
-    @inject(EditorManager)
-    protected readonly editorManager: EditorManager;
-
-    @inject(EnvVariablesServer)
-    protected readonly envVariablesServer: EnvVariablesServer;
-
-    @inject(LabelProvider)
-    protected readonly labelProvider: LabelProvider;
-
-    @inject(QuickPickService)
-    protected readonly quickPickService: QuickPickService;
-
-    @inject(ExternalTerminalService)
-    protected readonly externalTerminalService: ExternalTerminalService;
-
-    @inject(ExternalTerminalPreferenceService)
-    protected readonly externalTerminalPreferences: ExternalTerminalPreferenceService;
-
-    @inject(WorkspaceService)
-    protected readonly workspaceService: WorkspaceService;
-
-    registerCommands(commands: CommandRegistry): void {
-        commands.registerCommand(ExternalTerminalCommands.OPEN_NATIVE_CONSOLE, {
-            execute: () => this.openExternalTerminal()
-        });
-    }
-
-    registerKeybindings(keybindings: KeybindingRegistry): void {
-        keybindings.registerKeybinding({
-            command: ExternalTerminalCommands.OPEN_NATIVE_CONSOLE.id,
-            keybinding: 'ctrlcmd+shift+c',
-            when: '!terminalFocus'
-        });
-    }
-
-    /**
-     * Open a native console on the host machine.
-     *
-     * - If multi-root workspace is open, displays a quick pick to let users choose which workspace to spawn the terminal.
-     * - If only one workspace is open, the terminal spawns at the root of the current workspace.
-     * - If no workspace is open and there is an active editor, the terminal spawns at the parent folder of that file.
-     * - If no workspace is open and there are no active editors, the terminal spawns at user home directory.
-     */
-    protected async openExternalTerminal(): Promise<void> {
-        const configuration = this.externalTerminalPreferences.getExternalTerminalConfiguration();
-
-        if (this.workspaceService.isMultiRootWorkspaceOpened) {
-            const chosenWorkspaceRoot = await this.selectCwd();
-            if (chosenWorkspaceRoot) {
-                await this.externalTerminalService.openTerminal(configuration, chosenWorkspaceRoot);
-            }
-            return;
-        }
-
-        if (this.workspaceService.opened) {
-            const workspaceRootUri = this.workspaceService.tryGetRoots()[0].resource;
-            await this.externalTerminalService.openTerminal(configuration, workspaceRootUri.toString());
-            return;
-        }
-
-        const fallbackUri = this.editorManager.activeEditor?.editor.uri.parent ?? await this.envVariablesServer.getHomeDirUri();
-        await this.externalTerminalService.openTerminal(configuration, fallbackUri.toString());
-    }
-
-    /**
-     * Display a quick pick for user to choose a target workspace in opened workspaces.
-     */
-    protected async selectCwd(): Promise<string | undefined> {
-        const roots = this.workspaceService.tryGetRoots();
-        const selectedItem = await this.quickPickService.show(roots.map(
-            ({ resource }) => ({
-                label: this.labelProvider.getName(resource),
-                description: this.labelProvider.getLongName(resource),
-                value: resource.toString()
-            })
-        ), { placeholder: nls.localize('theia/external-terminal/cwd', 'Select current working directory for new external terminal') });
-        return selectedItem?.value;
-    }
-}
+// *****************************************************************************
+// Copyright (C) 2021 Ericsson and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
+// *****************************************************************************
+
+import { inject, injectable } from '@theia/core/shared/inversify';
+import { Command, CommandContribution, CommandRegistry } from '@theia/core/lib/common';
+import { EnvVariablesServer } from '@theia/core/lib/common/env-variables';
+import { KeybindingContribution, KeybindingRegistry, LabelProvider } from '@theia/core/lib/browser';
+import { EditorManager } from '@theia/editor/lib/browser/editor-manager';
+import { WorkspaceService } from '@theia/workspace/lib/browser';
+import { ExternalTerminalService } from '../common/external-terminal';
+import { ExternalTerminalPreferenceService } from './external-terminal-preference';
+import { QuickPickService } from '@theia/core/lib/common/quick-pick-service';
+import { nls } from '@theia/core/lib/common/nls';
+
+export namespace ExternalTerminalCommands {
+    export const OPEN_NATIVE_CONSOLE = Command.toDefaultLocalizedCommand({
+        id: 'workbench.action.terminal.openNativeConsole',
+        label: 'Open New External Terminal'
+    });
+}
+
+@injectable()
+export class ExternalTerminalFrontendContribution implements CommandContribution, KeybindingContribution {
+
+    @inject(EditorManager)
+    protected readonly editorManager: EditorManager;
+
+    @inject(EnvVariablesServer)
+    protected readonly envVariablesServer: EnvVariablesServer;
+
+    @inject(LabelProvider)
+    protected readonly labelProvider: LabelProvider;
+
+    @inject(QuickPickService)
+    protected readonly quickPickService: QuickPickService;
+
+    @inject(ExternalTerminalService)
+    protected readonly externalTerminalService: ExternalTerminalService;
+
+    @inject(ExternalTerminalPreferenceService)
+    protected readonly externalTerminalPreferences: ExternalTerminalPreferenceService;
+
+    @inject(WorkspaceService)
+    protected readonly workspaceService: WorkspaceService;
+
+    registerCommands(commands: CommandRegistry): void {
+        commands.registerCommand(ExternalTerminalCommands.OPEN_NATIVE_CONSOLE, {
+            execute: () => this.openExternalTerminal()
+        });
+    }
+
+    registerKeybindings(keybindings: KeybindingRegistry): void {
+        keybindings.registerKeybinding({
+            command: ExternalTerminalCommands.OPEN_NATIVE_CONSOLE.id,
+            keybinding: 'ctrlcmd+shift+c',
+            when: '!terminalFocus'
+        });
+    }
+
+    /**
+     * Open a native console on the host machine.
+     *
+     * - If multi-root workspace is open, displays a quick pick to let users choose which workspace to spawn the terminal.
+     * - If only one workspace is open, the terminal spawns at the root of the current workspace.
+     * - If no workspace is open and there is an active editor, the terminal spawns at the parent folder of that file.
+     * - If no workspace is open and there are no active editors, the terminal spawns at user home directory.
+     */
+    protected async openExternalTerminal(): Promise<void> {
+        const configuration = this.externalTerminalPreferences.getExternalTerminalConfiguration();
+
+        if (this.workspaceService.isMultiRootWorkspaceOpened) {
+            const chosenWorkspaceRoot = await this.selectCwd();
+            if (chosenWorkspaceRoot) {
+                await this.externalTerminalService.openTerminal(configuration, chosenWorkspaceRoot);
+            }
+            return;
+        }
+
+        if (this.workspaceService.opened) {
+            const workspaceRootUri = this.workspaceService.tryGetRoots()[0].resource;
+            await this.externalTerminalService.openTerminal(configuration, workspaceRootUri.toString());
+            return;
+        }
+
+        const fallbackUri = this.editorManager.activeEditor?.editor.uri.parent ?? await this.envVariablesServer.getHomeDirUri();
+        await this.externalTerminalService.openTerminal(configuration, fallbackUri.toString());
+    }
+
+    /**
+     * Display a quick pick for user to choose a target workspace in opened workspaces.
+     */
+    protected async selectCwd(): Promise<string | undefined> {
+        const roots = this.workspaceService.tryGetRoots();
+        const selectedItem = await this.quickPickService.show(roots.map(
+            ({ resource }) => ({
+                label: this.labelProvider.getName(resource),
+                description: this.labelProvider.getLongName(resource),
+                value: resource.toString()
+            })
+        ), { placeholder: nls.localize('theia/external-terminal/cwd', 'Select current working directory for new external terminal') });
+        return selectedItem?.value;
+    }
+}

package/src/electron-browser/external-terminal-frontend-module.ts

@@ -1,33 +1,33 @@
-// *****************************************************************************
-// Copyright (C) 2021 Ericsson and others.
-//
-// This program and the accompanying materials are made available under the
-// terms of the Eclipse Public License v. 2.0 which is available at
-// http://www.eclipse.org/legal/epl-2.0.
-//
-// This Source Code may also be made available under the following Secondary
-// Licenses when the conditions for such availability set forth in the Eclipse
-// Public License v. 2.0 are satisfied: GNU General Public License, version 2
-// with the GNU Classpath Exception which is available at
-// https://www.gnu.org/software/classpath/license.html.
-//
-// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
-// *****************************************************************************
-
-import { ContainerModule, interfaces } from '@theia/core/shared/inversify';
-import { CommandContribution } from '@theia/core/lib/common';
-import { KeybindingContribution, WebSocketConnectionProvider } from '@theia/core/lib/browser';
-import { bindExternalTerminalPreferences } from './external-terminal-preference';
-import { ExternalTerminalFrontendContribution } from './external-terminal-contribution';
-import { ExternalTerminalService, externalTerminalServicePath } from '../common/external-terminal';
-
-export default new ContainerModule((bind: interfaces.Bind) => {
-    bind(ExternalTerminalFrontendContribution).toSelf().inSingletonScope();
-    bindExternalTerminalPreferences(bind);
-    [CommandContribution, KeybindingContribution].forEach(serviceIdentifier =>
-        bind(serviceIdentifier).toService(ExternalTerminalFrontendContribution)
-    );
-    bind(ExternalTerminalService).toDynamicValue(ctx =>
-        WebSocketConnectionProvider.createProxy<ExternalTerminalService>(ctx.container, externalTerminalServicePath)
-    ).inSingletonScope();
-});
+// *****************************************************************************
+// Copyright (C) 2021 Ericsson and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
+// *****************************************************************************
+
+import { ContainerModule, interfaces } from '@theia/core/shared/inversify';
+import { CommandContribution } from '@theia/core/lib/common';
+import { KeybindingContribution, WebSocketConnectionProvider } from '@theia/core/lib/browser';
+import { bindExternalTerminalPreferences } from './external-terminal-preference';
+import { ExternalTerminalFrontendContribution } from './external-terminal-contribution';
+import { ExternalTerminalService, externalTerminalServicePath } from '../common/external-terminal';
+
+export default new ContainerModule((bind: interfaces.Bind) => {
+    bind(ExternalTerminalFrontendContribution).toSelf().inSingletonScope();
+    bindExternalTerminalPreferences(bind);
+    [CommandContribution, KeybindingContribution].forEach(serviceIdentifier =>
+        bind(serviceIdentifier).toService(ExternalTerminalFrontendContribution)
+    );
+    bind(ExternalTerminalService).toDynamicValue(ctx =>
+        WebSocketConnectionProvider.createProxy<ExternalTerminalService>(ctx.container, externalTerminalServicePath)
+    ).inSingletonScope();
+});

package/src/electron-browser/external-terminal-preference.ts

@@ -1,106 +1,106 @@
-// *****************************************************************************
-// Copyright (C) 2021 Ericsson and others.
-//
-// This program and the accompanying materials are made available under the
-// terms of the Eclipse Public License v. 2.0 which is available at
-// http://www.eclipse.org/legal/epl-2.0.
-//
-// This Source Code may also be made available under the following Secondary
-// Licenses when the conditions for such availability set forth in the Eclipse
-// Public License v. 2.0 are satisfied: GNU General Public License, version 2
-// with the GNU Classpath Exception which is available at
-// https://www.gnu.org/software/classpath/license.html.
-//
-// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
-// *****************************************************************************
-
-import { inject, injectable, interfaces, postConstruct } from '@theia/core/shared/inversify';
-import {
-    createPreferenceProxy,
-    PreferenceSchema,
-    PreferenceService,
-    PreferenceProxy
-} from '@theia/core/lib/browser';
-import { PreferenceSchemaProvider } from '@theia/core/lib/browser/preferences/preference-contribution';
-import { isWindows, isOSX } from '@theia/core/lib/common/os';
-import { ExternalTerminalService, ExternalTerminalConfiguration } from '../common/external-terminal';
-import { nls } from '@theia/core/lib/common/nls';
-
-export const ExternalTerminalPreferences = Symbol('ExternalTerminalPreferences');
-export type ExternalTerminalPreferences = PreferenceProxy<ExternalTerminalConfiguration>;
-
-export const ExternalTerminalSchemaPromise = Symbol('ExternalTerminalSchemaPromise');
-export type ExternalTerminalSchemaPromise = Promise<PreferenceSchema>;
-
-export function bindExternalTerminalPreferences(bind: interfaces.Bind): void {
-    bind(ExternalTerminalSchemaPromise).toDynamicValue(
-        ctx => getExternalTerminalSchema(ctx.container.get(ExternalTerminalService))
-    ).inSingletonScope();
-    bind(ExternalTerminalPreferences).toDynamicValue(
-        ctx => createPreferenceProxy(
-            ctx.container.get(PreferenceService),
-            ctx.container.get(ExternalTerminalSchemaPromise),
-        )
-    ).inSingletonScope();
-    bind(ExternalTerminalPreferenceService).toSelf().inSingletonScope();
-}
-
-@injectable()
-export class ExternalTerminalPreferenceService {
-
-    @inject(ExternalTerminalPreferences)
-    protected readonly preferences: ExternalTerminalPreferences;
-
-    @inject(PreferenceSchemaProvider)
-    protected readonly preferenceSchemaProvider: PreferenceSchemaProvider;
-
-    @inject(ExternalTerminalSchemaPromise)
-    protected readonly promisedSchema: ExternalTerminalSchemaPromise;
-
-    @postConstruct()
-    protected init(): void {
-        this.promisedSchema.then(schema => this.preferenceSchemaProvider.setSchema(schema));
-    }
-
-    /**
-     * Get the external terminal configurations from preferences.
-     */
-    getExternalTerminalConfiguration(): ExternalTerminalConfiguration {
-        return {
-            'terminal.external.linuxExec': this.preferences['terminal.external.linuxExec'],
-            'terminal.external.osxExec': this.preferences['terminal.external.osxExec'],
-            'terminal.external.windowsExec': this.preferences['terminal.external.windowsExec'],
-        };
-    }
-}
-
-/**
- * Use the backend {@link ExternalTerminalService} to establish the schema for the `ExternalTerminalPreferences`.
- *
- * @param externalTerminalService the external terminal backend service.
- * @returns a preference schema with the OS default exec set by the backend service.
- */
-export async function getExternalTerminalSchema(externalTerminalService: ExternalTerminalService): Promise<PreferenceSchema> {
-    const hostExec = await externalTerminalService.getDefaultExec();
-    return {
-        type: 'object',
-        properties: {
-            'terminal.external.windowsExec': {
-                type: 'string',
-                typeDetails: { isFilepath: true },
-                description: nls.localizeByDefault('Customizes which terminal to run on Windows.'),
-                default: `${isWindows ? hostExec : 'C:\\WINDOWS\\System32\\cmd.exe'}`
-            },
-            'terminal.external.osxExec': {
-                type: 'string',
-                description: nls.localizeByDefault('Customizes which terminal application to run on macOS.'),
-                default: `${isOSX ? hostExec : 'Terminal.app'}`
-            },
-            'terminal.external.linuxExec': {
-                type: 'string',
-                description: nls.localizeByDefault('Customizes which terminal to run on Linux.'),
-                default: `${!(isWindows || isOSX) ? hostExec : 'xterm'}`
-            }
-        }
-    };
-}
+// *****************************************************************************
+// Copyright (C) 2021 Ericsson and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
+// *****************************************************************************
+
+import { inject, injectable, interfaces, postConstruct } from '@theia/core/shared/inversify';
+import {
+    createPreferenceProxy,
+    PreferenceSchema,
+    PreferenceService,
+    PreferenceProxy
+} from '@theia/core/lib/browser';
+import { PreferenceSchemaProvider } from '@theia/core/lib/browser/preferences/preference-contribution';
+import { isWindows, isOSX } from '@theia/core/lib/common/os';
+import { ExternalTerminalService, ExternalTerminalConfiguration } from '../common/external-terminal';
+import { nls } from '@theia/core/lib/common/nls';
+
+export const ExternalTerminalPreferences = Symbol('ExternalTerminalPreferences');
+export type ExternalTerminalPreferences = PreferenceProxy<ExternalTerminalConfiguration>;
+
+export const ExternalTerminalSchemaPromise = Symbol('ExternalTerminalSchemaPromise');
+export type ExternalTerminalSchemaPromise = Promise<PreferenceSchema>;
+
+export function bindExternalTerminalPreferences(bind: interfaces.Bind): void {
+    bind(ExternalTerminalSchemaPromise).toDynamicValue(
+        ctx => getExternalTerminalSchema(ctx.container.get(ExternalTerminalService))
+    ).inSingletonScope();
+    bind(ExternalTerminalPreferences).toDynamicValue(
+        ctx => createPreferenceProxy(
+            ctx.container.get(PreferenceService),
+            ctx.container.get(ExternalTerminalSchemaPromise),
+        )
+    ).inSingletonScope();
+    bind(ExternalTerminalPreferenceService).toSelf().inSingletonScope();
+}
+
+@injectable()
+export class ExternalTerminalPreferenceService {
+
+    @inject(ExternalTerminalPreferences)
+    protected readonly preferences: ExternalTerminalPreferences;
+
+    @inject(PreferenceSchemaProvider)
+    protected readonly preferenceSchemaProvider: PreferenceSchemaProvider;
+
+    @inject(ExternalTerminalSchemaPromise)
+    protected readonly promisedSchema: ExternalTerminalSchemaPromise;
+
+    @postConstruct()
+    protected init(): void {
+        this.promisedSchema.then(schema => this.preferenceSchemaProvider.setSchema(schema));
+    }
+
+    /**
+     * Get the external terminal configurations from preferences.
+     */
+    getExternalTerminalConfiguration(): ExternalTerminalConfiguration {
+        return {
+            'terminal.external.linuxExec': this.preferences['terminal.external.linuxExec'],
+            'terminal.external.osxExec': this.preferences['terminal.external.osxExec'],
+            'terminal.external.windowsExec': this.preferences['terminal.external.windowsExec'],
+        };
+    }
+}
+
+/**
+ * Use the backend {@link ExternalTerminalService} to establish the schema for the `ExternalTerminalPreferences`.
+ *
+ * @param externalTerminalService the external terminal backend service.
+ * @returns a preference schema with the OS default exec set by the backend service.
+ */
+export async function getExternalTerminalSchema(externalTerminalService: ExternalTerminalService): Promise<PreferenceSchema> {
+    const hostExec = await externalTerminalService.getDefaultExec();
+    return {
+        type: 'object',
+        properties: {
+            'terminal.external.windowsExec': {
+                type: 'string',
+                typeDetails: { isFilepath: true },
+                description: nls.localizeByDefault('Customizes which terminal to run on Windows.'),
+                default: `${isWindows ? hostExec : 'C:\\WINDOWS\\System32\\cmd.exe'}`
+            },
+            'terminal.external.osxExec': {
+                type: 'string',
+                description: nls.localizeByDefault('Customizes which terminal application to run on macOS.'),
+                default: `${isOSX ? hostExec : 'Terminal.app'}`
+            },
+            'terminal.external.linuxExec': {
+                type: 'string',
+                description: nls.localizeByDefault('Customizes which terminal to run on Linux.'),
+                default: `${!(isWindows || isOSX) ? hostExec : 'xterm'}`
+            }
+        }
+    };
+}