Function activate

src/extension/extension.ts:131–753

(context: vs.ExtensionContext, isRestart = false)

export const perSessionWebviewStateKey = `webviewState_${(new Date()).getTime()}_${getRandomInt(1, 1000)}`;

export async function activate(context: vs.ExtensionContext, isRestart = false) {
	extensionThisSessionStart = Date.now();

	// Ring logger is only set up once and persists over silent restarts.
	if (!ringLogger)
		ringLogger = logger.onLog((message) => ringLog.log(message.toLine(800)));

	if (isDevExtension)
		context.subscriptions.push(logToConsole(logger));

	// Clear any caches, for example projects that we detected. We might be reloading because
	// a Flutter project was added to a Dart-only workspace.
	clearCaches();

	void vs.commands.executeCommand("setContext", IS_RUNNING_LOCALLY_CONTEXT, isRunningLocally);
	buildLogHeaders();
	if (!extensionLog)
		extensionLog = setupLog(getExtensionLogPath(), LogCategory.General, false);

	const webClient = new WebClient(extensionVersion);

	util.logTime("Code called activate");

	// Wire up a reload command that will re-initialise everything.
	context.subscriptions.push(vs.commands.registerCommand("_dart.reloadExtension", async (reason?: ExtensionRestartReason, data?: string) => {
		reason ??= ExtensionRestartReason.Unknown;
		logger.warn(`Performing extension reload (${reason}, ${data})...`);
		analytics.logExtensionRestart(reason, data);
		await deactivate(true, reason);
		await disposeAllAsync(context.subscriptions);
		await activate(context, true);
		logger.info("Done reloading extension!");
	}));

	// Configure if using flutter-dev.
	setFlutterDev(config.useFlutterDev);

	previousSettingsObject = getSettingsThatRequireRestart();

	util.logTime();
	analytics = new Analytics(logger);

	// Helper to set the tool env using current analytics/env settings.
	const setEnvHelper = () => setupToolEnv({ suppressAnalytics: analytics.isSuppressed, envOverrides: config.env });
	setEnvHelper(); // Set initial values.

	// Rebuild toolEnv when related config changes. This needs to be set up before the SDK search, since it
	// is what causes the config reload when the SDK paths are selected during "Locate SDK".
	context.subscriptions.push(vs.workspace.onDidChangeConfiguration((e) => {
		config.reload();
		if (e.affectsConfiguration("dart.env") || e.affectsConfiguration("dart.allowAnalytics") || e.affectsConfiguration("telemetry.telemetryLevel"))
			setEnvHelper();
	}));

	const sdkUtils = new SdkUtils(logger, context, analytics);
	const workspaceContextUnverified = await sdkUtils.scanWorkspace();
	extensionApiModel.setSdks(workspaceContextUnverified.sdks);
	analytics.workspaceContext = workspaceContextUnverified;