433 lines
17 KiB
TypeScript
433 lines
17 KiB
TypeScript
/*---------------------------------------------------------------------------------------------
|
|
* Copyright (c) Microsoft Corporation. All rights reserved.
|
|
* Licensed under the MIT License. See License.txt in the project root for license information.
|
|
*--------------------------------------------------------------------------------------------*/
|
|
|
|
import 'vs/workbench/browser/style';
|
|
import { localize } from 'vs/nls';
|
|
import { Event, Emitter, setGlobalLeakWarningThreshold } from 'vs/base/common/event';
|
|
import { runWhenIdle } from 'vs/base/common/async';
|
|
import { getZoomLevel, isFirefox, isSafari, isChrome, getPixelRatio } from 'vs/base/browser/browser';
|
|
import { mark } from 'vs/base/common/performance';
|
|
import { onUnexpectedError, setUnexpectedErrorHandler } from 'vs/base/common/errors';
|
|
import { Registry } from 'vs/platform/registry/common/platform';
|
|
import { isWindows, isLinux, isWeb, isNative, isMacintosh } from 'vs/base/common/platform';
|
|
import { IWorkbenchContributionsRegistry, Extensions as WorkbenchExtensions } from 'vs/workbench/common/contributions';
|
|
import { IEditorInputFactoryRegistry, Extensions as EditorExtensions } from 'vs/workbench/common/editor';
|
|
import { getSingletonServiceDescriptors } from 'vs/platform/instantiation/common/extensions';
|
|
import { Position, Parts, IWorkbenchLayoutService, positionToString } from 'vs/workbench/services/layout/browser/layoutService';
|
|
import { IStorageService, WillSaveStateReason, StorageScope, StorageTarget } from 'vs/platform/storage/common/storage';
|
|
import { IConfigurationService } from 'vs/platform/configuration/common/configuration';
|
|
import { IInstantiationService } from 'vs/platform/instantiation/common/instantiation';
|
|
import { ServiceCollection } from 'vs/platform/instantiation/common/serviceCollection';
|
|
import { LifecyclePhase, ILifecycleService, WillShutdownEvent, BeforeShutdownEvent } from 'vs/workbench/services/lifecycle/common/lifecycle';
|
|
import { INotificationService } from 'vs/platform/notification/common/notification';
|
|
import { NotificationService } from 'vs/workbench/services/notification/common/notificationService';
|
|
import { NotificationsCenter } from 'vs/workbench/browser/parts/notifications/notificationsCenter';
|
|
import { NotificationsAlerts } from 'vs/workbench/browser/parts/notifications/notificationsAlerts';
|
|
import { NotificationsStatus } from 'vs/workbench/browser/parts/notifications/notificationsStatus';
|
|
import { registerNotificationCommands } from 'vs/workbench/browser/parts/notifications/notificationsCommands';
|
|
import { NotificationsToasts } from 'vs/workbench/browser/parts/notifications/notificationsToasts';
|
|
import { setARIAContainer } from 'vs/base/browser/ui/aria/aria';
|
|
import { readFontInfo, restoreFontInfo, serializeFontInfo } from 'vs/editor/browser/config/configuration';
|
|
import { BareFontInfo } from 'vs/editor/common/config/fontInfo';
|
|
import { ILogService } from 'vs/platform/log/common/log';
|
|
import { toErrorMessage } from 'vs/base/common/errorMessage';
|
|
import { WorkbenchContextKeysHandler } from 'vs/workbench/browser/contextkeys';
|
|
import { coalesce } from 'vs/base/common/arrays';
|
|
import { InstantiationService } from 'vs/platform/instantiation/common/instantiationService';
|
|
import { Layout } from 'vs/workbench/browser/layout';
|
|
import { IHostService } from 'vs/workbench/services/host/browser/host';
|
|
|
|
export class Workbench extends Layout {
|
|
|
|
private readonly _onBeforeShutdown = this._register(new Emitter<BeforeShutdownEvent>());
|
|
readonly onBeforeShutdown = this._onBeforeShutdown.event;
|
|
|
|
private readonly _onWillShutdown = this._register(new Emitter<WillShutdownEvent>());
|
|
readonly onWillShutdown = this._onWillShutdown.event;
|
|
|
|
private readonly _onShutdown = this._register(new Emitter<void>());
|
|
readonly onShutdown = this._onShutdown.event;
|
|
|
|
constructor(
|
|
parent: HTMLElement,
|
|
private readonly serviceCollection: ServiceCollection,
|
|
logService: ILogService
|
|
) {
|
|
super(parent);
|
|
|
|
this.registerErrorHandler(logService);
|
|
}
|
|
|
|
private registerErrorHandler(logService: ILogService): void {
|
|
|
|
// Listen on unhandled rejection events
|
|
window.addEventListener('unhandledrejection', (event: PromiseRejectionEvent) => {
|
|
|
|
// See https://developer.mozilla.org/en-US/docs/Web/API/PromiseRejectionEvent
|
|
onUnexpectedError(event.reason);
|
|
|
|
// Prevent the printing of this event to the console
|
|
event.preventDefault();
|
|
});
|
|
|
|
// Install handler for unexpected errors
|
|
setUnexpectedErrorHandler(error => this.handleUnexpectedError(error, logService));
|
|
|
|
// Inform user about loading issues from the loader
|
|
interface AnnotatedLoadingError extends Error {
|
|
phase: 'loading';
|
|
moduleId: string;
|
|
neededBy: string[];
|
|
}
|
|
interface AnnotatedFactoryError extends Error {
|
|
phase: 'factory';
|
|
moduleId: string;
|
|
}
|
|
interface AnnotatedValidationError extends Error {
|
|
phase: 'configuration';
|
|
}
|
|
type AnnotatedError = AnnotatedLoadingError | AnnotatedFactoryError | AnnotatedValidationError;
|
|
(<any>window).require.config({
|
|
onError: (err: AnnotatedError) => {
|
|
if (err.phase === 'loading') {
|
|
onUnexpectedError(new Error(localize('loaderErrorNative', "Failed to load a required file. Please restart the application to try again. Details: {0}", JSON.stringify(err))));
|
|
}
|
|
console.error(err);
|
|
}
|
|
});
|
|
}
|
|
|
|
private previousUnexpectedError: { message: string | undefined, time: number } = { message: undefined, time: 0 };
|
|
private handleUnexpectedError(error: unknown, logService: ILogService): void {
|
|
const message = toErrorMessage(error, true);
|
|
if (!message) {
|
|
return;
|
|
}
|
|
|
|
const now = Date.now();
|
|
if (message === this.previousUnexpectedError.message && now - this.previousUnexpectedError.time <= 1000) {
|
|
return; // Return if error message identical to previous and shorter than 1 second
|
|
}
|
|
|
|
this.previousUnexpectedError.time = now;
|
|
this.previousUnexpectedError.message = message;
|
|
|
|
// Log it
|
|
logService.error(message);
|
|
}
|
|
|
|
startup(): IInstantiationService {
|
|
try {
|
|
|
|
// Configure emitter leak warning threshold
|
|
setGlobalLeakWarningThreshold(175);
|
|
|
|
// Services
|
|
const instantiationService = this.initServices(this.serviceCollection);
|
|
|
|
instantiationService.invokeFunction(async accessor => {
|
|
const lifecycleService = accessor.get(ILifecycleService);
|
|
const storageService = accessor.get(IStorageService);
|
|
const configurationService = accessor.get(IConfigurationService);
|
|
const hostService = accessor.get(IHostService);
|
|
|
|
// Layout
|
|
this.initLayout(accessor);
|
|
|
|
// Registries
|
|
Registry.as<IWorkbenchContributionsRegistry>(WorkbenchExtensions.Workbench).start(accessor);
|
|
Registry.as<IEditorInputFactoryRegistry>(EditorExtensions.EditorInputFactories).start(accessor);
|
|
|
|
// Context Keys
|
|
this._register(instantiationService.createInstance(WorkbenchContextKeysHandler));
|
|
|
|
// Register Listeners
|
|
this.registerListeners(lifecycleService, storageService, configurationService, hostService);
|
|
|
|
// Render Workbench
|
|
this.renderWorkbench(instantiationService, accessor.get(INotificationService) as NotificationService, storageService, configurationService);
|
|
|
|
// Workbench Layout
|
|
this.createWorkbenchLayout();
|
|
|
|
// Layout
|
|
this.layout();
|
|
|
|
// Restore
|
|
try {
|
|
await this.restoreWorkbench(accessor.get(ILogService), lifecycleService);
|
|
} catch (error) {
|
|
onUnexpectedError(error);
|
|
}
|
|
});
|
|
|
|
return instantiationService;
|
|
} catch (error) {
|
|
onUnexpectedError(error);
|
|
|
|
throw error; // rethrow because this is a critical issue we cannot handle properly here
|
|
}
|
|
}
|
|
|
|
private initServices(serviceCollection: ServiceCollection): IInstantiationService {
|
|
|
|
// Layout Service
|
|
serviceCollection.set(IWorkbenchLayoutService, this);
|
|
|
|
// !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
|
//
|
|
// NOTE: Please do NOT register services here. Use `registerSingleton()`
|
|
// from `workbench.common.main.ts` if the service is shared between
|
|
// native and web or `workbench.sandbox.main.ts` if the service
|
|
// is native only.
|
|
//
|
|
// DO NOT add services to `workbench.desktop.main.ts`, always add
|
|
// to `workbench.sandbox.main.ts` to support our Electron sandbox
|
|
//
|
|
// !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
|
|
|
// All Contributed Services
|
|
const contributedServices = getSingletonServiceDescriptors();
|
|
for (let [id, descriptor] of contributedServices) {
|
|
serviceCollection.set(id, descriptor);
|
|
}
|
|
|
|
const instantiationService = new InstantiationService(serviceCollection, true);
|
|
|
|
// Wrap up
|
|
instantiationService.invokeFunction(accessor => {
|
|
const lifecycleService = accessor.get(ILifecycleService);
|
|
|
|
// TODO@Sandeep debt around cyclic dependencies
|
|
const configurationService = accessor.get(IConfigurationService) as any;
|
|
if (typeof configurationService.acquireInstantiationService === 'function') {
|
|
setTimeout(() => {
|
|
configurationService.acquireInstantiationService(instantiationService);
|
|
}, 0);
|
|
}
|
|
|
|
// Signal to lifecycle that services are set
|
|
lifecycleService.phase = LifecyclePhase.Ready;
|
|
});
|
|
|
|
return instantiationService;
|
|
}
|
|
|
|
private registerListeners(
|
|
lifecycleService: ILifecycleService,
|
|
storageService: IStorageService,
|
|
configurationService: IConfigurationService,
|
|
hostService: IHostService
|
|
): void {
|
|
|
|
// Configuration changes
|
|
this._register(configurationService.onDidChangeConfiguration(() => this.setFontAliasing(configurationService)));
|
|
|
|
// Font Info
|
|
if (isNative) {
|
|
this._register(storageService.onWillSaveState(e => {
|
|
if (e.reason === WillSaveStateReason.SHUTDOWN) {
|
|
this.storeFontInfo(storageService);
|
|
}
|
|
}));
|
|
} else {
|
|
this._register(lifecycleService.onWillShutdown(() => this.storeFontInfo(storageService)));
|
|
}
|
|
|
|
// Lifecycle
|
|
this._register(lifecycleService.onBeforeShutdown(event => this._onBeforeShutdown.fire(event)));
|
|
this._register(lifecycleService.onWillShutdown(event => this._onWillShutdown.fire(event)));
|
|
this._register(lifecycleService.onShutdown(() => {
|
|
this._onShutdown.fire();
|
|
this.dispose();
|
|
}));
|
|
|
|
// In some environments we do not get enough time to persist state on shutdown.
|
|
// In other cases, VSCode might crash, so we periodically save state to reduce
|
|
// the chance of loosing any state.
|
|
// The window loosing focus is a good indication that the user has stopped working
|
|
// in that window so we pick that at a time to collect state.
|
|
this._register(hostService.onDidChangeFocus(focus => { if (!focus) { storageService.flush(); } }));
|
|
}
|
|
|
|
private fontAliasing: 'default' | 'antialiased' | 'none' | 'auto' | undefined;
|
|
private setFontAliasing(configurationService: IConfigurationService) {
|
|
if (!isMacintosh) {
|
|
return; // macOS only
|
|
}
|
|
|
|
const aliasing = configurationService.getValue<'default' | 'antialiased' | 'none' | 'auto'>('workbench.fontAliasing');
|
|
if (this.fontAliasing === aliasing) {
|
|
return;
|
|
}
|
|
|
|
this.fontAliasing = aliasing;
|
|
|
|
// Remove all
|
|
const fontAliasingValues: (typeof aliasing)[] = ['antialiased', 'none', 'auto'];
|
|
this.container.classList.remove(...fontAliasingValues.map(value => `monaco-font-aliasing-${value}`));
|
|
|
|
// Add specific
|
|
if (fontAliasingValues.some(option => option === aliasing)) {
|
|
this.container.classList.add(`monaco-font-aliasing-${aliasing}`);
|
|
}
|
|
}
|
|
|
|
private restoreFontInfo(storageService: IStorageService, configurationService: IConfigurationService): void {
|
|
|
|
// Restore (native: use storage service, web: use browser specific local storage)
|
|
const storedFontInfoRaw = isNative ? storageService.get('editorFontInfo', StorageScope.GLOBAL) : window.localStorage.getItem('vscode.editorFontInfo');
|
|
if (storedFontInfoRaw) {
|
|
try {
|
|
const storedFontInfo = JSON.parse(storedFontInfoRaw);
|
|
if (Array.isArray(storedFontInfo)) {
|
|
restoreFontInfo(storedFontInfo);
|
|
}
|
|
} catch (err) {
|
|
/* ignore */
|
|
}
|
|
}
|
|
|
|
readFontInfo(BareFontInfo.createFromRawSettings(configurationService.getValue('editor'), getZoomLevel(), getPixelRatio()));
|
|
}
|
|
|
|
private storeFontInfo(storageService: IStorageService): void {
|
|
const serializedFontInfo = serializeFontInfo();
|
|
if (serializedFontInfo) {
|
|
const serializedFontInfoRaw = JSON.stringify(serializedFontInfo);
|
|
|
|
// Font info is very specific to the machine the workbench runs
|
|
// on. As such, in the web, we prefer to store this info in
|
|
// local storage and not global storage because it would not make
|
|
// much sense to synchronize to other machines.
|
|
if (isNative) {
|
|
storageService.store('editorFontInfo', serializedFontInfoRaw, StorageScope.GLOBAL, StorageTarget.MACHINE);
|
|
} else {
|
|
window.localStorage.setItem('vscode.editorFontInfo', serializedFontInfoRaw);
|
|
}
|
|
}
|
|
}
|
|
|
|
private renderWorkbench(instantiationService: IInstantiationService, notificationService: NotificationService, storageService: IStorageService, configurationService: IConfigurationService): void {
|
|
|
|
// ARIA
|
|
setARIAContainer(this.container);
|
|
|
|
// State specific classes
|
|
const platformClass = isWindows ? 'windows' : isLinux ? 'linux' : 'mac';
|
|
const workbenchClasses = coalesce([
|
|
'monaco-workbench',
|
|
platformClass,
|
|
isWeb ? 'web' : undefined,
|
|
isChrome ? 'chromium' : isFirefox ? 'firefox' : isSafari ? 'safari' : undefined,
|
|
...this.getLayoutClasses()
|
|
]);
|
|
|
|
this.container.classList.add(...workbenchClasses);
|
|
document.body.classList.add(platformClass); // used by our fonts
|
|
|
|
if (isWeb) {
|
|
document.body.classList.add('web');
|
|
}
|
|
|
|
// Apply font aliasing
|
|
this.setFontAliasing(configurationService);
|
|
|
|
// Warm up font cache information before building up too many dom elements
|
|
this.restoreFontInfo(storageService, configurationService);
|
|
|
|
// Create Parts
|
|
[
|
|
{ id: Parts.TITLEBAR_PART, role: 'contentinfo', classes: ['titlebar'] },
|
|
{ id: Parts.ACTIVITYBAR_PART, role: 'none', classes: ['activitybar', this.state.sideBar.position === Position.LEFT ? 'left' : 'right'] }, // Use role 'none' for some parts to make screen readers less chatty #114892
|
|
{ id: Parts.SIDEBAR_PART, role: 'none', classes: ['sidebar', this.state.sideBar.position === Position.LEFT ? 'left' : 'right'] },
|
|
{ id: Parts.EDITOR_PART, role: 'main', classes: ['editor'], options: { restorePreviousState: this.state.editor.restoreEditors } },
|
|
{ id: Parts.PANEL_PART, role: 'none', classes: ['panel', positionToString(this.state.panel.position)] },
|
|
{ id: Parts.STATUSBAR_PART, role: 'status', classes: ['statusbar'] }
|
|
].forEach(({ id, role, classes, options }) => {
|
|
const partContainer = this.createPart(id, role, classes);
|
|
|
|
this.getPart(id).create(partContainer, options);
|
|
});
|
|
|
|
// Notification Handlers
|
|
this.createNotificationsHandlers(instantiationService, notificationService);
|
|
|
|
// Add Workbench to DOM
|
|
this.parent.appendChild(this.container);
|
|
}
|
|
|
|
private createPart(id: string, role: string, classes: string[]): HTMLElement {
|
|
const part = document.createElement(role === 'status' ? 'footer' : 'div'); // Use footer element for status bar #98376
|
|
part.classList.add('part', ...classes);
|
|
part.id = id;
|
|
part.setAttribute('role', role);
|
|
if (role === 'status') {
|
|
part.setAttribute('aria-live', 'off');
|
|
}
|
|
|
|
return part;
|
|
}
|
|
|
|
private createNotificationsHandlers(instantiationService: IInstantiationService, notificationService: NotificationService): void {
|
|
|
|
// Instantiate Notification components
|
|
const notificationsCenter = this._register(instantiationService.createInstance(NotificationsCenter, this.container, notificationService.model));
|
|
const notificationsToasts = this._register(instantiationService.createInstance(NotificationsToasts, this.container, notificationService.model));
|
|
this._register(instantiationService.createInstance(NotificationsAlerts, notificationService.model));
|
|
const notificationsStatus = instantiationService.createInstance(NotificationsStatus, notificationService.model);
|
|
|
|
// Visibility
|
|
this._register(notificationsCenter.onDidChangeVisibility(() => {
|
|
notificationsStatus.update(notificationsCenter.isVisible, notificationsToasts.isVisible);
|
|
notificationsToasts.update(notificationsCenter.isVisible);
|
|
}));
|
|
|
|
this._register(notificationsToasts.onDidChangeVisibility(() => {
|
|
notificationsStatus.update(notificationsCenter.isVisible, notificationsToasts.isVisible);
|
|
}));
|
|
|
|
// Register Commands
|
|
registerNotificationCommands(notificationsCenter, notificationsToasts);
|
|
|
|
// Register with Layout
|
|
this.registerNotifications({
|
|
onDidChangeNotificationsVisibility: Event.map(Event.any(notificationsToasts.onDidChangeVisibility, notificationsCenter.onDidChangeVisibility), () => notificationsToasts.isVisible || notificationsCenter.isVisible)
|
|
});
|
|
}
|
|
|
|
private async restoreWorkbench(
|
|
logService: ILogService,
|
|
lifecycleService: ILifecycleService
|
|
): Promise<void> {
|
|
|
|
// Emit a warning after 10s if restore does not complete
|
|
const restoreTimeoutHandle = setTimeout(() => logService.warn('Workbench did not finish loading in 10 seconds, that might be a problem that should be reported.'), 10000);
|
|
|
|
try {
|
|
await super.restoreWorkbenchLayout();
|
|
|
|
clearTimeout(restoreTimeoutHandle);
|
|
} catch (error) {
|
|
onUnexpectedError(error);
|
|
} finally {
|
|
|
|
// Set lifecycle phase to `Restored`
|
|
lifecycleService.phase = LifecyclePhase.Restored;
|
|
|
|
// Set lifecycle phase to `Eventually` after a short delay and when idle (min 2.5sec, max 5sec)
|
|
setTimeout(() => {
|
|
this._register(runWhenIdle(() => lifecycleService.phase = LifecyclePhase.Eventually, 2500));
|
|
}, 2500);
|
|
|
|
// Telemetry: startup metrics
|
|
mark('code/didStartWorkbench');
|
|
|
|
// Perf reporting (devtools)
|
|
performance.measure('perf: workbench create & restore', 'code/didLoadWorkbenchMain', 'code/didStartWorkbench');
|
|
}
|
|
}
|
|
}
|