第三方组件的引入¶

Firefox 源码树引入了许多第三方依赖项。构建系统提供了一种标准化的方法来跟踪

上游源代码许可证、位置和版本
(可选) 上游源代码的修改，包括
1. Mozilla 专属补丁
2. 自定义更新操作，例如排除某些文件、移动文件等。

这是通过添加到第三方源代码中的描述性 moz.yaml 文件以及使用

./mach vendor [options] ./path/to/moz.yaml

与之交互来完成的。

模板 `moz.yaml` 文件¶

# All fields are mandatory unless otherwise noted

schema: 1
# Version of this schema

bugzilla:
    # Bugzilla product and component for this directory and subdirectories.
    product: product name
    component: component name

origin:

    name: name of the package
    # eg. nestegg

    description: short (one line) description

    url: package's homepage url
    # Usually different from repository url

    release: identifier
    # Human-readable identifier for this version/release
    # Generally "version NNN", "tag SSS", "bookmark SSS"

    revision: sha
    # Revision to pull in
    # Must be a long or short commit SHA (long preferred)

    license: MPL-2.0
    # Multiple licenses can be specified (as a YAML list)
    # Where possible using the mnemonic from https://spdx.org/licenses/
    # From a list of approved licenses (to be determined)
    # A "LICENSE" file must exist in the destination directory after patches are applied

    license-file: COPYING
    # optional
    # explicit name of the License file if it's not one of the supported
    # hard-coded value.

vendoring:
    # optional
    # Information needed to update the library automatically.

    url: source url (generally repository clone url)
    # eg. https://github.com/kinetiknz/nestegg.git
    # Any repository host can be specified here, however initially we'll only support
    # automated vendoring from github.com and googlesource.com, to be extended later.

    source-hosting: gitlab
    # name of the infrastructure used to host the sources. Can be one of
    # gitlab, angle, googlesource, codeberg, github or git. The later is
    # more generic but less efficient.

    flavor: regular
    # Type of Vendoring
    # This is either 'regular', 'individual-files', or 'rust'
    # If omitted, will default to 'regular'

    patches:
        - file
        - path/to/file
        - path/*.patch
    # optional
    # List of patch files to apply after vendoring. Applied in the order specified, and
    # alphabetically if globbing is used. Patches must apply cleanly before changes are
    # pushed
    # All patch files are implicitly added to the keep file list.

    keep:
        - file
        - path/to/file
        - another/path
        - *.mozilla
    # optional and regular flavor only
    # List of files in mozilla-central that are not deleted while vendoring
    # Implicitly contains "moz.yaml", any files referenced as patches

    exclude:
        - file
        - path/to/file
        - another/path
        - docs
        - src/*.test
    # optional and regular flavor only
    # Files/paths that will not be vendored from source repository
    # Implicitly contains ".git", and ".gitignore"

    include:
        - file
        - path/to/file
        - another/path
        - docs/LICENSE.*
    # optional and regular flavor only
    # Files/paths that will always be vendored, even if they would
    # otherwise be excluded by "exclude".

    # If neither "exclude" or "include" are set, all files will be vendored
    # Files/paths in "include" will always be vendored, even if excluded
    # eg. excluding "docs/" then including "docs/LICENSE" will vendor just the LICENSE file
    # from the docs directory

    # All three file/path parameters ("keep", "exclude", and "include") support filenames,
    # directory names, and globs/wildcards.

    individual-files:
        - upstream: src_file
          destination: dest_file
        - upstream: src_path/to/src_file
          destination: dest_path/to/dest_file
    # optional and individual-files flavor only
    # Full list of individual upstream files and the destination to which they should be copied

    individual-files-default-upstream: "src/"
    individual-files-default-destination: "{vendor_dir}/"
    individual-files-list:
        - file
        - path/to/file
        - another/path
    # optional and individual-files flavor only
    # Full list of individual files which will be copied from individual-files-default-upstream
    # to individual-files-default-destination
    # individual-files-default-upstream and individual-files-default-destination are required

    # For individual-files flavor either individual-files or individual-files-default-upstream
    # but not both must be set

    update-actions:
        - action: move-file
          from: '{vendor_dir}/origin'
          to: '{vendor_dir}/dest'

        - action: move-dir
          from: '{vendor_dir}/origin'
          to: '{vendor_dir}/dest'

        - action: copy-file
          from: '{vendor_dir}/origin'
          to: '{vendor_dir}/dest'

        - action: delete-path
          path: "src/unused"

        - action: replace-in-file
          pattern: '@REVISION@'
          with: '{revision}'
          file: '{yaml_dir}/vcs_version.h'

        - action: replace-in-file-regex
          file: '{vendor_dir}/lib/arm/armopts.s'
          pattern: '@HAVE_ARM_ASM_((EDSP)|(MEDIA)|(NEON))@'
          with: '1'

        - action: run-script
          script: '{yaml_dir}/update.sh'
          args: ['{revision}']
          cwd: '{cwd}'

    # optional
    # In-tree actions to be executed after vendoring but before pushing.

常见的引入操作¶

更新到最新的上游版本

./mach vendor /path/to/moz.yaml

检查最新版本，如果已经是最新版本则不输出任何内容，如果需要更新则返回版本标识符

./mach vendor /path/to/moz.yaml --check-for-update

引入特定版本

./mach vendor /path/to/moz.yaml -r $REVISION --force

如果存在补丁，则需要两个步骤

通过 --patch-mode none 在不应用补丁的情况下引入（补丁在 update-actions 之后应用）
通过 --patch -mode only 在更新后的源代码上应用补丁

如果不存在补丁，则只需要一个步骤，并且不需要额外的参数。

第三方组件的引入¶

模板 moz.yaml 文件¶

常见的引入操作¶

模板 `moz.yaml` 文件¶