2 # vim:set ts=8 sw=8 sts=8 noet:
3 # This Source Code Form is subject to the terms of the Mozilla Public
4 # License, v. 2.0. If a copy of the MPL was not distributed with this
5 # file, You can obtain one at http://mozilla.org/MPL/2.0/.
7 # Build a mozilla application.
10 # 1. hg clone ssh://hg.mozilla.org/mozilla-central mozilla
12 # 3. create your .mozconfig file with
13 # ac_add_options --enable-application=browser
14 # 4. gmake -f client.mk
16 # Other targets (gmake -f client.mk [targets...]),
18 # clean (realclean is now the same as clean)
21 # See http://developer.mozilla.org/en/docs/Build_Documentation for
25 # MOZ_BUILD_PROJECTS - Build multiple projects in subdirectories
27 # MOZ_OBJDIR - Destination object directory
28 # MOZ_MAKE_FLAGS - Flags to pass to $(MAKE)
29 # MOZ_PREFLIGHT_ALL } - Makefiles to run before any project in
30 # MOZ_PREFLIGHT } MOZ_BUILD_PROJECTS, before each project, after
31 # MOZ_POSTFLIGHT } each project, and after all projects; these
32 # MOZ_POSTFLIGHT_ALL } variables contain space-separated lists
33 # MOZ_UNIFY_BDATE - Set to use the same bdate for each project in
36 #######################################################################
42 ifneq (1,$(words $(CWD
)))
43 $(error The mozilla directory cannot be located in a path with spaces.
)
51 ifeq (,$(wildcard client.mk
))
52 TOPSRCDIR
:= $(patsubst %/,%,$(dir $(MAKEFILE_LIST
)))
59 # try to find autoconf 2.13 - discard errors from 'which'
60 # MacOS X 10.4 sends "no autoconf*" errors to stdout, discard those via grep
61 AUTOCONF ?
= $(shell which autoconf-2.13 autoconf2.13 autoconf213
2>/dev
/null | grep
-v
'^no autoconf' | head
-1)
63 # See if the autoconf package was installed through fink
64 ifeq (,$(strip $(AUTOCONF
)))
65 AUTOCONF
= $(shell which fink
>/dev
/null
2>&1 && echo
`which fink`/..
/..
/lib
/autoconf2.13
/bin
/autoconf
)
68 ifeq (,$(strip $(AUTOCONF
)))
69 AUTOCONF
=$(error Could not find autoconf
2.13)
76 CONFIG_GUESS_SCRIPT
:= $(wildcard $(TOPSRCDIR
)/build
/autoconf
/config.guess
)
77 ifdef CONFIG_GUESS_SCRIPT
78 CONFIG_GUESS
:= $(shell $(CONFIG_GUESS_SCRIPT
))
82 ####################################
86 ifneq (,$(findstring mingw
,$(CONFIG_GUESS
)))
88 # check for CRLF line endings
89 ifneq (0,$(shell $(PERL
) -e
'binmode(STDIN); while (<STDIN>) { if (/\r/) { print "1"; exit } } print "0"' < $(TOPSRCDIR
)/client.mk
))
90 $(error This source tree appears to have Windows-style line endings. To \
91 convert it to Unix-style line endings
, check \
92 "https://developer.mozilla.org/en-US/docs/Developer_Guide/Mozilla_build_FAQ\#Win32-specific_questions" \
93 for a workaround of this issue.
)
97 ####################################
98 # Load mozconfig Options
100 # See build pages, http://www.mozilla.org/build/ for how to set up mozconfig.
102 MOZCONFIG_LOADER
:= build
/autoconf
/mozconfig2client-mk
109 # As $(shell) doesn't preserve newlines, use sed to replace them with an
110 # unlikely sequence (||), which is then replaced back to newlines by make
111 # before evaluation. $(shell) replacing newlines with spaces, || is always
112 # followed by a space (since sed doesn't remove newlines), except on the
113 # last line, so replace both '|| ' and '||'.
114 MOZCONFIG_CONTENT
:= $(subst ||
,$(CR
),$(subst ||
,$(CR
),$(shell $(TOPSRCDIR
)/$(MOZCONFIG_LOADER
) $(TOPSRCDIR
) | sed
's/$$/||/')))
115 $(eval
$(MOZCONFIG_CONTENT
))
117 export FOUND_MOZCONFIG
119 # As '||' was used as a newline separator, it means it's not occurring in
120 # lines themselves. It can thus safely be used to replaces normal spaces,
121 # to then replace newlines with normal spaces. This allows to get a list
122 # of mozconfig output lines.
123 MOZCONFIG_OUT_LINES
:= $(subst $(CR
), ,$(subst $(NULL
) $(NULL
),||
,$(MOZCONFIG_CONTENT
)))
124 # Filter-out comments from those lines.
126 MOZCONFIG_OUT_FILTERED
:= $(filter-out $(START_COMMENT
)%,$(MOZCONFIG_OUT_LINES
))
132 ifdef MOZ_PARALLEL_BUILD
133 MOZ_MAKE_FLAGS
:= $(filter-out -j
%,$(MOZ_MAKE_FLAGS
))
134 MOZ_MAKE_FLAGS
+= -j
$(MOZ_PARALLEL_BUILD
)
137 # Automatically add -jN to make flags if not defined. N defaults to number of cores.
138 ifeq (,$(findstring -j
,$(MOZ_MAKE_FLAGS
)))
139 cores
=$(shell $(PYTHON
) -c
'import multiprocessing; print(multiprocessing.cpu_count())')
140 MOZ_MAKE_FLAGS
+= -j
$(cores
)
145 MOZ_OBJDIR
= obj-
$(CONFIG_GUESS
)
147 # On Windows Pymake builds check MOZ_OBJDIR doesn't start with "/"
148 ifneq (,$(findstring mingw
,$(CONFIG_GUESS
)))
149 ifeq (1_a
,$(.PYMAKE
)_
$(firstword a
$(subst /, ,$(MOZ_OBJDIR
))))
150 $(error For Windows Pymake builds
, MOZ_OBJDIR must be a Windows
[and not MSYS
] style path.
)
155 ifdef MOZ_BUILD_PROJECTS
157 ifdef MOZ_CURRENT_PROJECT
158 OBJDIR
= $(MOZ_OBJDIR
)/$(MOZ_CURRENT_PROJECT
)
159 MOZ_MAKE
= $(MAKE
) $(MOZ_MAKE_FLAGS
) -C
$(OBJDIR
)
160 BUILD_PROJECT_ARG
= MOZ_BUILD_APP
=$(MOZ_CURRENT_PROJECT
)
162 OBJDIR
= $(error Cannot find the OBJDIR when MOZ_CURRENT_PROJECT is not set.
)
163 MOZ_MAKE
= $(error Cannot build in the OBJDIR when MOZ_CURRENT_PROJECT is not set.
)
166 else # MOZ_BUILD_PROJECTS
168 OBJDIR
= $(MOZ_OBJDIR
)
169 MOZ_MAKE
= $(MAKE
) $(MOZ_MAKE_FLAGS
) -C
$(OBJDIR
)
171 endif # MOZ_BUILD_PROJECTS
173 # 'configure' scripts generated by autoconf.
174 CONFIGURES
:= $(TOPSRCDIR
)/configure
175 CONFIGURES
+= $(TOPSRCDIR
)/js
/src
/configure
177 # Make targets that are going to be passed to the real build system
178 OBJDIR_TARGETS
= install export libs
clean realclean distclean maybe_clobber_profiledbuild upload sdk installer package fast-package package-compare stage-package source-package l10n-check
180 #######################################################################
183 # The default rule is build
185 $(MAKE
) -f
$(TOPSRCDIR
)/client.mk
$(if
$(MOZ_PGO
),profiledbuild
,realbuild
)
188 include $(TOPSRCDIR
)/config
/makefiles
/makeutils.mk
189 include $(TOPSRCDIR
)/config
/makefiles
/autotargets.mk
191 # Create a makefile containing the mk_add_options values from mozconfig,
192 # but only do so when OBJDIR is defined (see further above).
193 ifdef MOZ_BUILD_PROJECTS
194 ifdef MOZ_CURRENT_PROJECT
195 WANT_MOZCONFIG_MK
= 1
200 WANT_MOZCONFIG_MK
= 1
203 ifdef WANT_MOZCONFIG_MK
204 # For now, only output "export" lines from mozconfig2client-mk output.
205 MOZCONFIG_MK_LINES
:= $(filter export||
%,$(MOZCONFIG_OUT_LINES
))
206 $(OBJDIR
)/.mozconfig.mk
: $(FOUND_MOZCONFIG
) $(call mkdir_deps
,$(OBJDIR
))
207 $(if
$(MOZCONFIG_MK_LINES
),( $(foreach line
,$(MOZCONFIG_MK_LINES
), echo
'$(subst ||, ,$(line))';) )) > $@
209 # Include that makefile so that it is created. This should not actually change
210 # the environment since MOZCONFIG_CONTENT, which MOZCONFIG_OUT_LINES derives
211 # from, has already been eval'ed.
212 -include $(OBJDIR
)/.mozconfig.mk
215 # Print out any options loaded from mozconfig.
216 all realbuild
clean distclean export libs
install realclean::
217 ifneq (,$(strip $(MOZCONFIG_OUT_FILTERED
)))
218 $(info Adding client.mk options from
$(FOUND_MOZCONFIG
):)
219 $(foreach line
,$(MOZCONFIG_OUT_FILTERED
),$(info $(NULL
) $(NULL
) $(NULL
) $(NULL
) $(subst ||
, ,$(line
))))
222 # Windows equivalents
224 clobber clobber_all
: clean
226 # helper target for mobile
227 build_and_deploy
: build fast-package
install
229 # Do everything from scratch
230 everything
: clean build
232 ####################################
233 # Profile-Guided Optimization
234 # This is up here, outside of the MOZ_CURRENT_PROJECT logic so that this
235 # is usable in multi-pass builds, where you might not have a runnable
236 # application until all the build passes and postflight scripts have run.
238 PGO_OBJDIR
= $(MOZ_OBJDIR
)
240 PGO_OBJDIR
:= $(TOPSRCDIR
)
244 $(MAKE
) -f
$(TOPSRCDIR
)/client.mk realbuild MOZ_PROFILE_GENERATE
=1 MOZ_PGO_INSTRUMENTED
=1
245 $(MAKE
) -C
$(PGO_OBJDIR
) package MOZ_PGO_INSTRUMENTED
=1 MOZ_INTERNAL_SIGNING_FORMAT
= MOZ_EXTERNAL_SIGNING_FORMAT
=
246 rm -f
${PGO_OBJDIR}/jarlog
/en-US.log
247 MOZ_PGO_INSTRUMENTED
=1 JARLOG_FILE
=jarlog
/en-US.log EXTRA_TEST_ARGS
=10 $(MAKE
) -C
$(PGO_OBJDIR
) pgo-profile-run
248 $(MAKE
) -f
$(TOPSRCDIR
)/client.mk maybe_clobber_profiledbuild
249 $(MAKE
) -f
$(TOPSRCDIR
)/client.mk realbuild MOZ_PROFILE_USE
=1
251 #####################################################
252 # Build date unification
254 ifdef MOZ_UNIFY_BDATE
255 ifndef MOZ_BUILD_DATE
256 ifdef MOZ_BUILD_PROJECTS
257 MOZ_BUILD_DATE
= $(shell $(PYTHON
) $(TOPSRCDIR
)/toolkit
/xre
/make-platformini.py
--print-buildid
)
258 export MOZ_BUILD_DATE
263 #####################################################
264 # Preflight, before building any project
266 realbuild preflight_all
::
267 ifeq (,$(MOZ_CURRENT_PROJECT
)$(if
$(MOZ_PREFLIGHT_ALL
),,1))
268 # Don't run preflight_all for individual projects in multi-project builds
269 # (when MOZ_CURRENT_PROJECT is set.)
270 ifndef MOZ_BUILD_PROJECTS
271 # Building a single project, OBJDIR is usable.
273 for mkfile in
$(MOZ_PREFLIGHT_ALL
); do \
274 $(MAKE
) -f
$(TOPSRCDIR
)/$$mkfile preflight_all TOPSRCDIR
=$(TOPSRCDIR
) OBJDIR
=$(OBJDIR
) MOZ_OBJDIR
=$(MOZ_OBJDIR
); \
277 # OBJDIR refers to the project-specific OBJDIR, which is not available at
278 # this point when building multiple projects. Only MOZ_OBJDIR is available.
280 for mkfile in
$(MOZ_PREFLIGHT_ALL
); do \
281 $(MAKE
) -f
$(TOPSRCDIR
)/$$mkfile preflight_all TOPSRCDIR
=$(TOPSRCDIR
) MOZ_OBJDIR
=$(MOZ_OBJDIR
) MOZ_BUILD_PROJECTS
='$(MOZ_BUILD_PROJECTS)'; \
286 # If we're building multiple projects, but haven't specified which project,
289 ifeq (,$(MOZ_CURRENT_PROJECT
)$(if
$(MOZ_BUILD_PROJECTS
),,1))
290 configure realbuild preflight postflight
$(OBJDIR_TARGETS
)::
292 for app in
$(MOZ_BUILD_PROJECTS
); do \
293 $(MAKE
) -f
$(TOPSRCDIR
)/client.mk
$@ MOZ_CURRENT_PROJECT
=$$app; \
298 # MOZ_CURRENT_PROJECT: either doing a single-project build, or building an
299 # individual project in a multi-project build.
301 ####################################
304 MAKEFILE
= $(wildcard $(OBJDIR
)/Makefile
)
305 CONFIG_STATUS
= $(wildcard $(OBJDIR
)/config.status
)
306 CONFIG_CACHE
= $(wildcard $(OBJDIR
)/config.cache
)
308 EXTRA_CONFIG_DEPS
:= \
309 $(TOPSRCDIR
)/aclocal.m4 \
310 $(wildcard $(TOPSRCDIR
)/build
/autoconf
/*.m4
) \
311 $(TOPSRCDIR
)/js
/src
/aclocal.m4 \
314 $(CONFIGURES
): %: %.in
$(EXTRA_CONFIG_DEPS
)
315 @
$(PYTHON
) $(TOPSRCDIR
)/js
/src
/config
/check-sync-dirs.py
$(TOPSRCDIR
)/js
/src
/build
$(TOPSRCDIR
)/build
316 @echo Generating
$@ using autoconf
317 cd
$(@D
); $(AUTOCONF
)
319 CONFIG_STATUS_DEPS
:= \
320 $(wildcard $(TOPSRCDIR
)/*/confvars.sh
) \
322 $(TOPSRCDIR
)/CLOBBER \
323 $(TOPSRCDIR
)/nsprpub
/configure \
324 $(TOPSRCDIR
)/config
/milestone.txt \
325 $(TOPSRCDIR
)/js
/src
/config
/milestone.txt \
326 $(TOPSRCDIR
)/browser
/config
/version.txt \
327 $(TOPSRCDIR
)/build
/virtualenv_packages.txt \
328 $(TOPSRCDIR
)/python
/mozbuild
/mozbuild
/virtualenv.py \
329 $(TOPSRCDIR
)/testing
/mozbase
/packages.txt \
332 CONFIGURE_ENV_ARGS
+= \
336 # configure uses the program name to determine @srcdir@. Calling it without
337 # $(TOPSRCDIR) will set @srcdir@ to "."; otherwise, it is set to the full
338 # path of $(TOPSRCDIR).
339 ifeq ($(TOPSRCDIR
),$(OBJDIR
))
340 CONFIGURE
= .
/configure
342 CONFIGURE
= $(TOPSRCDIR
)/configure
346 $(PYTHON
) $(TOPSRCDIR
)/config
/pythonpath.py
-I
$(TOPSRCDIR
)/testing
/mozbase
/mozfile \
347 $(TOPSRCDIR
)/python
/mozbuild
/mozbuild
/controller
/clobber.py
$(TOPSRCDIR
) $(OBJDIR
)
349 configure-files
: $(CONFIGURES
)
354 $(call mkdir_deps
,$(OBJDIR
)) \
355 $(if
$(MOZ_BUILD_PROJECTS
),$(call mkdir_deps
,$(MOZ_OBJDIR
))) \
359 save-mozconfig
: $(FOUND_MOZCONFIG
)
360 -cp
$(FOUND_MOZCONFIG
) $(OBJDIR
)/.mozconfig
362 configure
:: $(configure-preqs
)
364 @echo
$(CONFIGURE
) $(CONFIGURE_ARGS
)
365 @cd
$(OBJDIR
) && $(BUILD_PROJECT_ARG
) $(CONFIGURE_ENV_ARGS
) $(CONFIGURE
) $(CONFIGURE_ARGS
) \
366 ||
( echo
'*** Fix above errors and then restart with\
367 "$(MAKE) -f client.mk build"' && exit
1 )
368 @touch
$(OBJDIR
)/Makefile
371 $(OBJDIR
)/Makefile
: $(OBJDIR
)/config.status
373 $(OBJDIR
)/config.status
: $(CONFIG_STATUS_DEPS
)
375 $(OBJDIR
)/Makefile
: $(CONFIG_STATUS_DEPS
)
377 @
$(MAKE
) -f
$(TOPSRCDIR
)/client.mk configure
379 ifneq (,$(CONFIG_STATUS
))
380 $(OBJDIR
)/config
/autoconf.mk
: $(TOPSRCDIR
)/config
/autoconf.mk.in
381 $(PYTHON
) $(OBJDIR
)/config.status
-n
--file
=$(OBJDIR
)/config
/autoconf.mk
385 ####################################
388 realbuild preflight
::
391 for mkfile in
$(MOZ_PREFLIGHT
); do \
392 $(MAKE
) -f
$(TOPSRCDIR
)/$$mkfile preflight TOPSRCDIR
=$(TOPSRCDIR
) OBJDIR
=$(OBJDIR
) MOZ_OBJDIR
=$(MOZ_OBJDIR
); \
396 ####################################
399 realbuild
:: $(OBJDIR
)/Makefile
$(OBJDIR
)/config.status check-sync-dirs-config
402 ####################################
405 # Pass these target onto the real build system
406 $(OBJDIR_TARGETS
):: $(OBJDIR
)/Makefile
$(OBJDIR
)/config.status
409 ####################################
412 realbuild postflight
::
415 for mkfile in
$(MOZ_POSTFLIGHT
); do \
416 $(MAKE
) -f
$(TOPSRCDIR
)/$$mkfile postflight TOPSRCDIR
=$(TOPSRCDIR
) OBJDIR
=$(OBJDIR
) MOZ_OBJDIR
=$(MOZ_OBJDIR
); \
420 endif # MOZ_CURRENT_PROJECT
422 ####################################
423 # Postflight, after building all projects
425 realbuild postflight_all
::
426 ifeq (,$(MOZ_CURRENT_PROJECT
)$(if
$(MOZ_POSTFLIGHT_ALL
),,1))
427 # Don't run postflight_all for individual projects in multi-project builds
428 # (when MOZ_CURRENT_PROJECT is set.)
429 ifndef MOZ_BUILD_PROJECTS
430 # Building a single project, OBJDIR is usable.
432 for mkfile in
$(MOZ_POSTFLIGHT_ALL
); do \
433 $(MAKE
) -f
$(TOPSRCDIR
)/$$mkfile postflight_all TOPSRCDIR
=$(TOPSRCDIR
) OBJDIR
=$(OBJDIR
) MOZ_OBJDIR
=$(MOZ_OBJDIR
); \
436 # OBJDIR refers to the project-specific OBJDIR, which is not available at
437 # this point when building multiple projects. Only MOZ_OBJDIR is available.
439 for mkfile in
$(MOZ_POSTFLIGHT_ALL
); do \
440 $(MAKE
) -f
$(TOPSRCDIR
)/$$mkfile postflight_all TOPSRCDIR
=$(TOPSRCDIR
) MOZ_OBJDIR
=$(MOZ_OBJDIR
) MOZ_BUILD_PROJECTS
='$(MOZ_BUILD_PROJECTS)'; \
447 if
[ -f Makefile
]; then \
448 $(MAKE
) distclean ; \
450 echo
'Removing object files from srcdir...'; \
451 rm -fr
`find . -type d \( -name .deps -print -o -name CVS \
452 -o -exec test ! -d {}/CVS \; \) -prune \
453 -o \( -name '*.[ao]' -o -name '*.so' \) -type f -print`; \
454 build
/autoconf
/clean-config.sh
; \
457 # Because SpiderMonkey can be distributed and built independently
458 # of the Mozilla source tree, it contains its own copies of many of
459 # the files used by the top-level Mozilla build process, from the
460 # 'config' and 'build' subtrees.
462 # To make it simpler to keep the copies in sync, we follow the policy
463 # that the SpiderMonkey copies must always be exact copies of those in
464 # the containing Mozilla tree. If you've made a change in one, it
465 # belongs in the other as well. If the change isn't right for both
466 # places, then that's something to bring up with the other developers.
468 # Some files are reasonable to diverge; for example,
469 # js/src/config/autoconf.mk.in doesn't need most of the stuff in
470 # config/autoconf.mk.in.
471 .PHONY
: check-sync-dirs
472 check-sync-dirs
: check-sync-dirs-build check-sync-dirs-config
474 @
$(PYTHON
) $(TOPSRCDIR
)/js
/src
/config
/check-sync-dirs.py
$(TOPSRCDIR
)/js
/src
/$* $(TOPSRCDIR
)/$*
479 # This makefile doesn't support parallel execution. It does pass
480 # MOZ_MAKE_FLAGS to sub-make processes, so they will correctly execute