feat: add beforePack hook (#6176)

Author: gaodeng

.changeset/stale-candles-boil.md

@@ -0,0 +1,5 @@
+---
+"app-builder-lib": minor
+---
+
+feat: add `beforePack` hook to build process with the same payload interface as that of `afterPack`

packages/app-builder-lib/scheme.json

@@ -6025,6 +6025,20 @@
       ],
       "description": "The function (or path to file or module id) to be [run after all artifacts are build](#afterAllArtifactBuild)."
     },
+    "beforePack": {
+      "anyOf": [
+        {
+          "typeof": "function"
+        },
+        {
+          "type": [
+            "null",
+            "string"
+          ]
+        }
+      ],
+      "description": "The function (or path to file or module id) to be [run before pack](#beforepack)"
+    },
     "afterPack": {
       "anyOf": [
         {

packages/app-builder-lib/src/configuration.ts

@@ -195,6 +195,8 @@ export interface Configuration extends PlatformSpecificBuildOptions {
    */
   readonly framework?: string | null
 
+  readonly beforePack?: ((context: BeforePackContext) => Promise<any> | any) | string | null
+
   /**
    * The function (or path to file or module id) to be [run after pack](#afterpack) (but before pack into distributable format and sign).
    */
@@ -262,14 +264,16 @@ export interface Configuration extends PlatformSpecificBuildOptions {
   readonly removePackageKeywords?: boolean
 }
 
-export interface AfterPackContext {
+interface PackContext {
   readonly outDir: string
   readonly appOutDir: string
   readonly packager: PlatformPackager<any>
   readonly electronPlatformName: string
   readonly arch: Arch
   readonly targets: Array<Target>
 }
+export type AfterPackContext = PackContext
+export type BeforePackContext = PackContext
 
 export interface MetadataDirectories {
   /**

packages/app-builder-lib/src/platformPackager.ts

@@ -201,6 +201,18 @@ export abstract class PlatformPackager<DC extends PlatformSpecificBuildOptions>
       return
     }
 
+    const beforePack = resolveFunction(this.config.beforePack, "beforePack")
+    if (beforePack != null) {
+      await beforePack({
+        appOutDir,
+        outDir,
+        arch,
+        targets,
+        packager: this,
+        electronPlatformName: platformName,
+      })
+    }
+
     await this.info.installAppDependencies(this.platform, arch)
 
     if (this.info.cancellationToken.cancelled) {