mozilla官方文档地址：

Firefox Source Tree Documentation — Firefox Source Docs documentationhttps://firefox-source-docs.mozilla.org/其中Configuring Build Options(配置自己的mozconfig)参考：

Firefox Source Tree Documentation — Firefox Source Docs documentationhttps://firefox-source-docs.mozilla.org/        编译成thunderbird主要注意以下配置：

1、--enable-application（又叫--enable-project）

# Build Thunderbird
ac_add_options --enable-application=comm/mail

该选项应该填写mail文件夹的相对路径，esr68相对于esr52来说，将代码结构进行了修改，esr52的代码结构式 comm包含mozilla,esr68的代码结构是mozilla包含comm

2、--enable-optimize(相对-disable-optimize)

ac_add_options --enable-optimize

使能代码优化，不写值是按照默认的优化等级O3进行优化

也可以选择特定的编译器优化选项。在大多数情况下，不要这个做，除非非常了解Mozilla代码库；但是若您使用Microsoft编译器进行构建，您可能确实希望使用它时，使用O1将优化大小。这一点可能与GCC不同。

ac_add_options --enable-optimize=-O2

注意：就使用ac_add_options --enable-optimize别加优化等级最安全了。

3、 Localization配置
 

mk_add_options MOZ_CO_LOCALES=ISOcodeac_add_options --enable-ui-locale=ISOcodeac_add_options --with-l10n-base=/path/to/base/dir

ISOcode：语言文化代码和国家地区对照表，可以百度搜索到

（1）--enable-ui-locale-ISOcode

在mozilla/moz.configure文件中解析该设置选项：

# Localization
# ==============================================================
option('--enable-ui-locale', default='en-US',help='Select the user interface locale (default: en-US)')set_config('MOZ_UI_LOCALE', depends('--enable-ui-locale')(lambda x: x))

MOZ_UI_LOCALE环境变量取值为 --enable-ui-locale设置

编译文件中的$AB_CD取值为$MOZ_UI_LOCALE

在config/config.mk设置了该选项：

# Because you might wish to "make locales AB_CD=ab-CD", we don't hardcode
# MOZ_UI_LOCALE directly, but use an intermediate variable that can be
# overridden by the command line. (Besides, AB_CD is prettier).
AB_CD = $(MOZ_UI_LOCALE)

（2）--with-l10n-base

语言包的所在目录，可以写绝对路径，也可以写相对路径

相对路径比较灵活，比如ac_add_options --with-l10n-base=@TOPSRCDIR@/../l10n

在toolkit/moz.configure中解析：

# L10N
# ==============================================================
option('--with-l10n-base', nargs=1, env='L10NBASEDIR',help='Path to l10n repositories')@depends('--with-l10n-base', 'MOZ_AUTOMATION', target, check_build_environment)
@imports(_from='os.path', _import='isdir')
@imports(_from='os.path', _import='expanduser')
@imports(_from='os', _import='environ')
def l10n_base(value, automation, target, build_env):if value:path = value[0]if not isdir(path):die("Invalid value --with-l10n-base, %s doesn't exist", path)elif automation:if target.os == 'Android':path = os.path.join(build_env.topobjdir, '..', '..', 'l10n-central')else:path = os.path.join(build_env.topobjdir, '..', '..', 'l10n')else:path = os.path.join(environ.get('MOZBUILD_STATE_PATH',expanduser(os.path.join('~', '.mozbuild'))),'l10n-central')return os.path.realpath(os.path.abspath(path))set_config('L10NBASEDIR', l10n_base)

上面的一段代码解析出了l10n_base的绝对路径，并将绝对路径赋值给$L10NBASEDIR

例如：在我的mozconfig里添加了如下配置：

mk_add_options MOZ_CO_LOCALES="zh-CN"
ac_add_options --enable-ui-locale=zh-CN
ac_add_options --with-l10n-base=@TOPSRCDIR@/..

最终对esr68的mac下mozconfig配置如下：

ac_add_options --enable-application=comm/mail
ac_add_options --with-app-basename=Thunderbird
#mk_add_options MOZ_OBJDIR=/Users/apple/ljl/thunderbird-68.0/comm/obj-mail
ac_add_options --target=x86_64-apple-darwin11ac_add_options --disable-tests
ac_add_options --disable-ipdl-tests
ac_add_options --disable-debug
#如果没有这一选项可能会产生运行问题
ac_add_options --disable-debug-symbolsmk_add_options AUTOCONF=/usr/local/Cellar/autoconf@2.13/2.13/2.13/bin/autoconf213#增加SDK的系统头文件和库文件，以在更旧的系统版本上能够运行
ac_add_options --with-macos-sdk=/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.12.sdk
ac_add_options --with-clang-path="/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/clang"
ac_add_options --with-libclang-path="/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/lib"mk_add_options MOZ_CO_LOCALES="zh-CN"
ac_add_options --enable-ui-locale=zh-CN
ac_add_options --with-l10n-base=../../l10n #根据你的实际语言包路径作相应修改ac_add_options --disable-calendar
ac_add_options --disable-updater
ac_add_options --enable-js-shell
ac_add_options --enable-chrome-format=omni
ac_add_options --enable-optimize
ac_add_options --enable-update-channel=release
ac_add_options --enable-rust-simd
ac_add_options --enable-crashreporter
ac_add_options --enable-official-branding

4、本地化

 （1）config/config.mk

ifdef relativesrcdir
MAKE_JARS_FLAGS += --relativesrcdir=$(LOCALE_RELATIVEDIR)
ifneq (en-US,$(AB_CD))
ifdef L10NBASEDIR
MAKE_JARS_FLAGS += --locale-mergedir=$(REAL_LOCALE_MERGEDIR)
MAKE_JARS_FLAGS += --l10n-base=$(L10NBASEDIR)/$(AB_CD)
endif # ! L10NBASEDIR
else
MAKE_JARS_FLAGS += -c $(LOCALE_SRCDIR)
endif # ! en-US
else
MAKE_JARS_FLAGS += -c $(LOCALE_SRCDIR)
endif # ! relativesrcdir

如果$(AB_CD) 不是 en_US并且L10NBASEDIR被定义了，才会在 MAKE_JARS_FLAG中追加 --l10n-base 选项，不满足这两个条件在编译的时候--l10n-base=None

本地化参考官方文档：

Localized Builds — Firefox Source Docs documentation

使用 ./mach build installer-zh_CN 编译检查语言包是否有编译报错，比较便捷

mozilla语言包下载路径：https://hg.mozilla.org/l10n-central/

（2）config/rules.mk

该文件的这段代码调用了jar_maker.py执行脚本，生成jar.mn:

libs realchrome:: $(FINAL_TARGET)/chrome$(call py_action,jar_maker,\$(QUIET) -d $(FINAL_TARGET) \$(MAKE_JARS_FLAGS) $(DEFINES) $(ACDEFINES) \$(JAR_MANIFEST))

（3）python/mozbuild/mozbuild/action/jar_maker.py

jar_maker.py调用了jar.py执行实际的生成操作：

# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0. If a copy of the MPL was not distributed with this
# file, You can obtain one at http://mozilla.org/MPL/2.0/.from __future__ import absolute_importimport sysimport mozbuild.jardef main(args):return mozbuild.jar.main(args)if __name__ == '__main__':sys.exit(main(sys.argv[1:]))

（4）python/mozbuild/mozbuild/jar.py

在main函数中执行生成jar.mn的过程

注意：obj-x86_64-apple-darwin11/config/autoconf.mk文件包含了项目的所有配置，可做参考

5、打包中文语言包

(1) 打包后的中文语言包放在omni.ja压缩包里（omni.ja包 实际是一个zip格式的压缩包，可以使用zip -r 和 unzip 进行压缩和解压缩）

打包脚本路径：comm/mail/installer/package-manifest.in

一下这段是包含本地化脚本的代码：

#ifdef PKG_LOCALE_MANIFEST
#include @PKG_LOCALE_MANIFEST@
#endif

这段话展开就是：

[multilocale]
@RESPATH@/res/multilocale.txt
@RESPATH@/chrome/zh-CN@JAREXT@
@RESPATH@/chrome/zh-CN.manifest

在 comm/mail/installer/package-manifest.in直接加这段话然后mach package也是可以的，只不过代码缺少灵活性

PKG_LOCALE_MANIFEST指的是：

comm/mail/installer/Makefile.in：

DEFINES += -DPKG_LOCALE_MANIFEST=$(commtopobjdir)/mail/installer/locale-manifest.in
MOZ_CHROME_LOCALE_ENTRIES=@RESPATH@/chrome/

locale-manifest.in：

[multilocale]
@RESPATH@/res/multilocale.txt
@RESPATH@/chrome/zh-CN@JAREXT@
@RESPATH@/chrome/zh-CN.manifest

至于这个$(commtopobjdir)/mail/installer/locale-manifest.in文件时如何生成的，详细看以下toolkit/mozapps/installer/packager.mk文件代码：

此处源码有错误，修改为如下逻辑：

ifneq ($(AB_CD),"")
ALL_LOCALES = $(if $(filter $(AB_CD),$(LOCALES)),$(LOCALES),$(LOCALES) $(AB_CD))
else
ALL_LOCALES = $(if $(filter en-US,$(LOCALES)),$(LOCALES),$(LOCALES) en-US)
endif

 生成local_manifest.in和multilocal.txt:

ifneq ($(AB_CD),"")
ALL_LOCALES = $(if $(filter $(AB_CD),$(LOCALES)),$(LOCALES),$(LOCALES) $(AB_CD))
else
ALL_LOCALES = $(if $(filter en-US,$(LOCALES)),$(LOCALES),$(LOCALES) en-US)
endif# Firefox uses @RESPATH@.
# Fennec uses @BINPATH@ and doesn't have the @RESPATH@ variable defined.
ifeq ($(MOZ_BUILD_APP),mobile/android)
BASE_PATH:=@BINPATH@
MULTILOCALE_DIR = $(DIST)/$(BINPATH)/res
else
BASE_PATH:=@RESPATH@
MULTILOCALE_DIR = $(DIST)/$(RESPATH)/res
endif#不走这个版本
# This version of the target uses MOZ_CHROME_MULTILOCALE to build multilocale.txt
# and places it in dist/bin/res - it should be used when packaging a build.
multilocale.txt: LOCALES?=$(MOZ_CHROME_MULTILOCALE)
multilocale.txt:$(call py_action,file_generate,$(MOZILLA_DIR)/toolkit/locales/gen_multilocale.py main '$(MULTILOCALE_DIR)/multilocale.txt' $(MDDEPDIR)/multilocale.txt.pp '$(MULTILOCALE_DIR)/multilocale.txt' $(ALL_LOCALES))#走这个版本
# This version of the target uses AB_CD to build multilocale.txt and places it
# in the $(XPI_NAME)/res dir - it should be used when repackaging a build.
multilocale.txt-%: LOCALES?=$(AB_CD)
multilocale.txt-%: MULTILOCALE_DIR=$(DIST)/xpi-stage/$(XPI_NAME)/res
multilocale.txt-%:$(call py_action,file_generate,$(MOZILLA_DIR)/toolkit/locales/gen_multilocale.py main '$(MULTILOCALE_DIR)/multilocale.txt' $(MDDEPDIR)/multilocale.txt.pp '$(MULTILOCALE_DIR)/multilocale.txt' $(ALL_LOCALES))locale-manifest.in: LOCALES?=$(MOZ_CHROME_MULTILOCALE) //这句话没有
locale-manifest.in: $(GLOBAL_DEPS) FORCE //此处是生成multilocale.txt的代码 $@代表目标，即locale-manifect.inprintf '\n[multilocale]\n' > $@printf '$(BASE_PATH)/res/multilocale.txt\n' >> $@for LOCALE in $(ALL_LOCALES) ;\do \for ENTRY in $(MOZ_CHROME_LOCALE_ENTRIES) ;\do \printf "$$ENTRY""$$LOCALE"'@JAREXT@\n' >> $@; \printf "$$ENTRY""$$LOCALE"'.manifest\n' >> $@; \done \done