Upload SourceMap during project build¶

 npm install @cloudcare/webpack-plugin --D

// ....
const { GuanceSourceMapUploadWebpackPlugin } = require('@cloudcare/webpack-plugin')
module.exports = ({ mode }) => ({
  //.....
  devtool: 'hidden-source-map',
  plugins: [
    //.....
    new GuanceSourceMapUploadWebpackPlugin({
      applicationId: 'xxxxx', // Guance appid
      apiKey: 'xxxxxxxx', // open apikey
      server: 'https://console.guance-xxx.cn',
      filepaths: ['dist/'], // Directories or files to search
      logLevel: 'verbose', // Log print 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 {
  /**
   *
   * Files/directories to search for sourcemaps.
   * All files matching the "extensions configuration" list but not matching the "ignore configuration" will be searched for
   * sourcemap JSON or `//#sourceMappingURL=` comments, so generated files + source maps pairs are found, then source maps will be uploaded.
   */
  filepaths: Array<string> | string

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

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

  /**
   * Find all eligible files without uploading them, useful for debugging.
   */
  dryRun?: boolean

  /**
   * Delete all found source map files after uploading.
   */
  deleteAfterUpload?: boolean
  /**
   * If source maps cannot be matched with generated files via sourceMappingURL, attempt to match by filename on local disk.
   */
  matchSourcemapsByFilename: ?boolean

  /**
   * List of extensions to look for under directories.
   * Default [".js", ".map"].
   */
  extensions?: Array<string>

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

  /**
   * Directory to calculate relative paths. The relative path of uploaded sourcemaps should be included within the error path, thus
   * this parameter controls the uploaded relative directory.
   * Default relative path from execution directory to search directory path.relative(process.cwd(), filepath).
   */
  root?: string
  /**
   * Used during debugging, sets the log level.
   */
  logLevel?: 'quiet' | 'normal' | 'verbose'
}

 const { GuanceSourceMapUploadWebpackPlugin } = 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 build 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 GuanceSourceMapUploadWebpackPlugin({
            ...
            deleteAfterUpload: true,
            matchSourcemapsByFilename: true,
          }),
        ]
      : [],
  ],
}