Upload SourceMap During Project Build¶

 npm install @cloudcare/webpack-plugin --D

// ....
const { SourceMapUploadWebpackPlugin } = require("@cloudcare/webpack-plugin")
module.exports = ({ mode }) => ({
  //.....
  devtool: "hidden-source-map",
  plugins: [
    //.....
    new SourceMapUploadWebpackPlugin({
      applicationId: "xxxxx", //  Guance application appid
      apiKey: "xxxxxxxx", // open apikey
      server: "https://console.xxx-xxx.cn",
      filepaths: ["dist/"], // Directory to search, can be a file or directory
      logLevel: "verbose", // Log level, optional
      root: "dist/", // Directory to calculate relative paths, optional
      env: "production", // Guance application env, optional
      version: "1.0.0", // Guance application version, optional
    }),
  ],
})

interface Options {
  /**
   *
   * File/directory to search for sourcemaps.
   * All files matching the "extensions" list but not matching the "ignore" list will be searched
   * for sourcemap JSON or `//#sourceMappingURL=` comments to find the generated file + sourcemap pairs, then the sourcemaps will be uploaded.
   */
  filepaths: Array<string> | string

  /**
   * Guance platform generated openApi Key, refer to (https://docs.guance.com/en/management/api-key/open-api/#_1) for generation method
   */
  apiKey: string

  /**
   * Guance platform OpenAPi service
   */
  server: string
  /**
   * Guance RUM application corresponding applicationId (required)
   */
  applicationId: string
  /**
   * Guance RUM application corresponding version (optional)
   */
  version?: string
  /**
   * Guance RUM application corresponding env (optional)
   */
  env?: string

  /**
   * Find all matching files but do not upload, useful for debugging
   */
  dryRun?: boolean

  /**
   * Delete all found sourcemap files after upload.
   */
  deleteAfterUpload?: boolean
  /**
   * If sourcemaps cannot be matched to their generated files by their sourceMappingURL, try to match them by filename on the local disk
   */
  matchSourcemapsByFilename: ?boolean

  /**
   * List of file extensions to search for in the directory
   * Default [".js", ".map"].
   */
  extensions?: Array<string>

  /**
   * List of files to ignore
   */
  ignore?: Array<string>

  /**
   * Directory to calculate relative paths. The relative paths of sourcemaps should be included in the path that generates the error, so
   * this parameter is used to control the relative directory to upload
   * Default relative path from the execution directory to the search directory path.relative(process.cwd(), filepath)
   */
  root?: string
  /**
   * Log level for debugging
   */
  logLevel?: "quiet" | "normal" | "verbose"
  /**
   * Whether to ignore errors on failure, this configuration ensures that errors do not interrupt the build process. Default false, meaning errors will be thrown normally
   */
  warnOnFailure?: boolean
}

 const { SourceMapUploadWebpackPlugin } = require('@cloudcare/webpack-plugin')
 = require('@cloudcare/webpack-plugin')

module.exports = {
  // Ensure that Webpack has been configured to output sourcemaps,
  // but without the `sourceMappingURL` references in buidl artifacts.
  devtool: 'hidden-source-map',
  // ...
  plugins: [
    // Enable our plugin to upload the sourcemaps once the build has completed.
    // This assumes NODE_ENV is how you distinguish production builds. If that
    // is not the case for you, you will have to tweak this logic.
    process.env.NODE_ENV === 'production'
      ? [
          new SourceMapUploadWebpackPlugin({
            ...
            deleteAfterUpload: true,
            matchSourcemapsByFilename: true,
          }),
        ]
      : [],
  ],
}