Optionally provide build tasks for library products

Author: award999

assets/test/defaultPackage/Package.swift

@@ -9,6 +9,10 @@ let package = Package(
         .library(
             name: "PackageLib",
             targets: ["PackageLib"]),
+        .library(
+            name: "PackageLib2",
+            type: .dynamic,
+            targets: ["PackageLib"]),
     ],
     targets: [
         // Targets are the basic building blocks of a package. A target can define a module or a test suite.

assets/test/defaultPackage/Package@swift-6.0.swift

@@ -12,6 +12,10 @@ let package = Package(
         .library(
             name: "PackageLib",
             targets: ["PackageLib"]),
+        .library(
+            name: "PackageLib2",
+            type: .dynamic,
+            targets: ["PackageLib"]),
     ],
     targets: [
         // Targets are the basic building blocks of a package. A target can define a module or a test suite.

package.json

@@ -651,6 +651,12 @@
             ],
             "scope": "application"
           },
+          "swift.createTasksForLibraryProducts": {
+            "type": "boolean",
+            "default": false,
+            "markdownDescription": "When enabled, the extension will create \"swift\" build tasks for library products in the package manifest. Note that automatic library products will not be included.",
+            "scope": "machine-overridable"
+          },
           "swift.showCreateSwiftProjectInWelcomePage": {
             "type": "boolean",
             "default": true,

src/SwiftPackage.ts

@@ -37,6 +37,10 @@ export interface Product {
     type: { executable?: null; library?: string[] };
 }
 
+export function isAutomatic(product: Product): boolean {
+    return (product.type.library || []).includes("automatic");
+}
+
 /** Swift Package Manager target */
 export interface Target {
     name: string;

src/configuration.ts

@@ -405,6 +405,12 @@ const configuration = {
             .getConfiguration("swift")
             .get<ShowBuildStatusOptions>("showBuildStatus", "swiftStatus");
     },
+    /** create build tasks for the library products of the package(s) */
+    get createTasksForLibraryProducts(): boolean {
+        return vscode.workspace
+            .getConfiguration("swift")
+            .get<boolean>("createTasksForLibraryProducts", false);
+    },
     /** background compilation */
     get backgroundCompilation(): boolean {
         return vscode.workspace

src/tasks/SwiftTaskProvider.ts

@@ -15,7 +15,7 @@
 import * as vscode from "vscode";
 import { WorkspaceContext } from "../WorkspaceContext";
 import { FolderContext } from "../FolderContext";
-import { Product } from "../SwiftPackage";
+import { isAutomatic, Product } from "../SwiftPackage";
 import configuration, {
     ShowBuildStatusOptions,
     substituteVariablesInString,
@@ -425,6 +425,16 @@ export class SwiftTaskProvider implements vscode.TaskProvider {
             for (const executable of executables) {
                 tasks.push(...createBuildTasks(executable, folderContext));
             }
+
+            if (configuration.createTasksForLibraryProducts) {
+                const libraries = await folderContext.swiftPackage.libraryProducts;
+                for (const lib of libraries) {
+                    if (isAutomatic(lib)) {
+                        continue;
+                    }
+                    tasks.push(...createBuildTasks(lib, folderContext));
+                }
+            }
         }
         return tasks;
     }

test/integration-tests/tasks/SwiftTaskProvider.test.ts

@@ -26,7 +26,11 @@ import { executeTaskAndWaitForResult, waitForEndTaskProcess } from "../../utilit
 import { Version } from "../../../src/utilities/version";
 import { FolderContext } from "../../../src/FolderContext";
 import { mockGlobalObject } from "../../MockUtils";
-import { activateExtensionForSuite, folderInRootWorkspace } from "../utilities/testutilities";
+import {
+    activateExtensionForSuite,
+    folderInRootWorkspace,
+    updateSettings,
+} from "../utilities/testutilities";
 
 suite("SwiftTaskProvider Test Suite", () => {
     let workspaceContext: WorkspaceContext;
@@ -92,6 +96,13 @@ suite("SwiftTaskProvider Test Suite", () => {
     });
 
     suite("provideTasks", () => {
+        let resetSettings: (() => Promise<void>) | undefined;
+        teardown(async () => {
+            if (resetSettings) {
+                await resetSettings();
+            }
+        });
+
         suite("includes build all task from extension", () => {
             let task: vscode.Task | undefined;
 
@@ -150,6 +161,41 @@ suite("SwiftTaskProvider Test Suite", () => {
             expect(task?.detail).to.include("swift build --product PackageExe");
         });
 
+        test("includes library build tasks task", async () => {
+            const taskProvider = workspaceContext.taskProvider;
+            let tasks = await taskProvider.provideTasks(new vscode.CancellationTokenSource().token);
+            let task = tasks.find(t => t.name === "Build Debug PackageLib2 (defaultPackage)");
+            expect(task).to.be.undefined;
+            task = tasks.find(t => t.name === "Build Release PackageLib2 (defaultPackage)");
+            expect(task).to.be.undefined;
+
+            resetSettings = await updateSettings({
+                "swift.createTasksForLibraryProducts": true,
+            });
+
+            tasks = await taskProvider.provideTasks(new vscode.CancellationTokenSource().token);
+            task = tasks.find(t => t.name === "Build Debug PackageLib2 (defaultPackage)");
+            expect(
+                task,
+                'expected to find a task named "Build Debug PackageLib2 (defaultPackage)", instead found ' +
+                    tasks.map(t => t.name)
+            ).to.not.be.undefined;
+            expect(task?.detail).to.include("swift build --product PackageLib2");
+            task = tasks.find(t => t.name === "Build Release PackageLib2 (defaultPackage)");
+            expect(
+                task,
+                'expected to find a task named "Build Release PackageLib2 (defaultPackage)", instead found ' +
+                    tasks.map(t => t.name)
+            ).to.not.be.undefined;
+            expect(task?.detail).to.include("swift build -c release --product PackageLib2");
+
+            // Don't include automatic products
+            task = tasks.find(t => t.name === "Build Debug PackageLib (defaultPackage)");
+            expect(task).to.be.undefined;
+            task = tasks.find(t => t.name === "Build Release PackageLib (defaultPackage)");
+            expect(task).to.be.undefined;
+        });
+
         test("includes product release task", async () => {
             const taskProvider = workspaceContext.taskProvider;
             const tasks = await taskProvider.provideTasks(