Method launch

src/extension/sdk/dev_tools/manager.ts:347–392

(allowLaunchThroughService: boolean, session: DartDebugSessionInformation & { vmServiceUri: string } | undefined, options: DevToolsOptions, forceShow: boolean)

	}

	private async launch(allowLaunchThroughService: boolean, session: DartDebugSessionInformation & { vmServiceUri: string } | undefined, options: DevToolsOptions, forceShow: boolean) {
		const url = await this.devtoolsUrl;
		if (!url) {
			this.showError(`DevTools URL not available`);
			return;
		}

		const queryParams: Record<string, string | undefined> = {
			...this.getDefaultQueryParams(),
			ideFeature: options.commandSource,
			inspectorRef: options.inspectorRef,
			theme: config.useDevToolsDarkTheme && options.location === "external" ? "dark" : undefined,
		};

		const pageId = options.pageId ?? this.getDefaultPage().id;
		const page = devToolsPages.find((p) => p.id === pageId);
		const routeId = page ? this.routeIdForPage(page) : pageId;

		// Try to launch via service if allowed.
		if (allowLaunchThroughService && session && await this.launchThroughService(session, { ...options, queryParams, page: routeId }))
			return true;

		// Otherwise, fall back to embedded or launching manually.
		if (pageId)
			queryParams.page = routeId;
		const vmServiceUri = page?.isStaticTool ? undefined : session?.vmServiceUri;
		// We currently only support embedded for pages we know about statically, although since we seem
		// to only use that for a title, we may be able to relax that.
		if (options.location !== "external") {
			if (this.dartCapabilities.requiresDevToolsEmbedFlag)
				queryParams.embed = "true";
			queryParams.embedMode = "one";
			const fullUrls = await this.buildDevToolsUrl(url, queryParams, vmServiceUri, session?.clientVmServiceUri);
			const exposedUrls = await exposeWebViewUrls(fullUrls, this.logger);

			const pageInfo = page ?? { id: pageId, title: pageId.replace(/_ext$/, "") };
			await this.launchInEmbeddedWebView(exposedUrls, session, pageInfo, options.location, options.triggeredAutomatically, forceShow);
		} else {
			const fullUrls = await this.buildDevToolsUrl(url, queryParams, vmServiceUri, session?.clientVmServiceUri);
			// For the browser, we don't care about auth URLs, but call exposeUrl so we get better logging because
			// "Open DevTools in Browser" is a convenient way to help troubleshoot URL mapping issues like
			// https://github.com/flutter/devtools/issues/9827
			const exposedUrl = await envUtils.exposeUrl(fullUrls.viewUrl, this.logger);
			await envUtils.openInBrowser(exposedUrl, this.logger);
		}
	}

	private getCacheBust(): string {
		// Add the version to the querystring to avoid any caching of the index.html page.