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 ifeq (,$(strip $(AUTOCONF
)))
64 AUTOCONF
=$(error Could not find autoconf
2.13)
71 CONFIG_GUESS_SCRIPT
:= $(wildcard $(TOPSRCDIR
)/build
/autoconf
/config.guess
)
72 ifdef CONFIG_GUESS_SCRIPT
73 CONFIG_GUESS
= $(shell $(CONFIG_GUESS_SCRIPT
))
77 ####################################
80 ifneq (,$(findstring mingw
,$(CONFIG_GUESS
)))
81 # check for CRLF line endings
82 ifneq (0,$(shell $(PERL
) -e
'binmode(STDIN); while (<STDIN>) { if (/\r/) { print "1"; exit } } print "0"' < $(TOPSRCDIR
)/client.mk
))
83 $(error This source tree appears to have Windows-style line endings. To \
84 convert it to Unix-style line endings
, run \
85 "python mozilla/build/win32/mozilla-dos2unix.py")
89 ####################################
90 # Load mozconfig Options
92 # See build pages, http://www.mozilla.org/build/ for how to set up mozconfig.
94 MOZCONFIG_LOADER
:= build
/autoconf
/mozconfig2client-mk
95 MOZCONFIG_FINDER
:= build
/autoconf
/mozconfig-find
96 MOZCONFIG_MODULES
:= build
/unix
/uniq.pl
103 # As $(shell) doesn't preserve newlines, use sed to replace them with an
104 # unlikely sequence (||), which is then replaced back to newlines by make
106 $(eval
$(subst ||
,$(CR
),$(shell $(TOPSRCDIR
)/$(MOZCONFIG_LOADER
) $(TOPSRCDIR
) 2> $(TOPSRCDIR
)/.mozconfig.out | sed
's/$$/||/')))
109 MOZ_OBJDIR
= obj-
$(CONFIG_GUESS
)
111 # On Windows Pymake builds check MOZ_OBJDIR doesn't start with "/"
112 ifneq (,$(findstring mingw
,$(CONFIG_GUESS
)))
113 ifeq (1_a
,$(.PYMAKE
)_
$(firstword a
$(subst /, ,$(MOZ_OBJDIR
))))
114 $(error For Windows Pymake builds
, MOZ_OBJDIR must be a Windows
[and not MSYS
] style path.
)
119 ifdef MOZ_BUILD_PROJECTS
121 ifdef MOZ_CURRENT_PROJECT
122 OBJDIR
= $(MOZ_OBJDIR
)/$(MOZ_CURRENT_PROJECT
)
123 MOZ_MAKE
= $(MAKE
) $(MOZ_MAKE_FLAGS
) -C
$(OBJDIR
)
124 BUILD_PROJECT_ARG
= MOZ_BUILD_APP
=$(MOZ_CURRENT_PROJECT
)
126 OBJDIR
= $(error Cannot find the OBJDIR when MOZ_CURRENT_PROJECT is not set.
)
127 MOZ_MAKE
= $(error Cannot build in the OBJDIR when MOZ_CURRENT_PROJECT is not set.
)
130 else # MOZ_BUILD_PROJECTS
132 OBJDIR
= $(MOZ_OBJDIR
)
133 MOZ_MAKE
= $(MAKE
) $(MOZ_MAKE_FLAGS
) -C
$(OBJDIR
)
135 endif # MOZ_BUILD_PROJECTS
137 # 'configure' scripts generated by autoconf.
138 CONFIGURES
:= $(TOPSRCDIR
)/configure
139 CONFIGURES
+= $(TOPSRCDIR
)/js
/src
/configure
141 # Make targets that are going to be passed to the real build system
142 OBJDIR_TARGETS
= install export libs
clean realclean distclean alldep maybe_clobber_profiledbuild upload sdk installer package fast-package package-compare stage-package source-package l10n-check
144 #######################################################################
147 # The default rule is build
149 $(MAKE
) -f
$(TOPSRCDIR
)/client.mk
$(if
$(MOZ_PGO
),profiledbuild
,realbuild
)
152 include $(TOPSRCDIR
)/config
/makefiles
/makeutils.mk
153 include $(TOPSRCDIR
)/config
/makefiles
/autotargets.mk
155 # Print out any options loaded from mozconfig.
156 all realbuild
clean depend
distclean export libs
install realclean::
157 @if
test -f .mozconfig.out
; then \
158 cat .mozconfig.out
; \
159 rm -f .mozconfig.out
; \
163 # Windows equivalents
165 build_all_dep
: alldep
166 build_all_depend
: alldep
167 clobber clobber_all
: clean
169 # helper target for mobile
170 build_and_deploy
: build fast-package
install
172 # Do everything from scratch
173 everything
: clean build
175 ####################################
176 # Profile-Guided Optimization
177 # To use this, you should set the following variables in your mozconfig
178 # mk_add_options PROFILE_GEN_SCRIPT=/path/to/profile-script
180 # The profile script should exercise the functionality to be included
181 # in the profile feedback.
183 # This is up here, outside of the MOZ_CURRENT_PROJECT logic so that this
184 # is usable in multi-pass builds, where you might not have a runnable
185 # application until all the build passes and postflight scripts have run.
187 PGO_OBJDIR
= $(MOZ_OBJDIR
)
189 PGO_OBJDIR
:= $(TOPSRCDIR
)
193 $(MAKE
) -f
$(TOPSRCDIR
)/client.mk realbuild MOZ_PROFILE_GENERATE
=1 MOZ_PGO_INSTRUMENTED
=1
194 $(MAKE
) -C
$(PGO_OBJDIR
) stage-package MOZ_PGO_INSTRUMENTED
=1
195 MOZ_PGO_INSTRUMENTED
=1 OBJDIR
=${PGO_OBJDIR} JARLOG_DIR
=${PGO_OBJDIR}/jarlog
/en-US
$(PROFILE_GEN_SCRIPT
)
196 $(MAKE
) -f
$(TOPSRCDIR
)/client.mk maybe_clobber_profiledbuild
197 $(MAKE
) -f
$(TOPSRCDIR
)/client.mk realbuild MOZ_PROFILE_USE
=1
199 #####################################################
200 # Build date unification
202 ifdef MOZ_UNIFY_BDATE
203 ifndef MOZ_BUILD_DATE
204 ifdef MOZ_BUILD_PROJECTS
205 MOZ_BUILD_DATE
= $(shell $(PYTHON
) $(TOPSRCDIR
)/toolkit
/xre
/make-platformini.py
--print-buildid
)
206 export MOZ_BUILD_DATE
211 #####################################################
212 # Preflight, before building any project
214 realbuild alldep preflight_all
::
215 ifeq (,$(MOZ_CURRENT_PROJECT
)$(if
$(MOZ_PREFLIGHT_ALL
),,1))
216 # Don't run preflight_all for individual projects in multi-project builds
217 # (when MOZ_CURRENT_PROJECT is set.)
218 ifndef MOZ_BUILD_PROJECTS
219 # Building a single project, OBJDIR is usable.
221 for mkfile in
$(MOZ_PREFLIGHT_ALL
); do \
222 $(MAKE
) -f
$(TOPSRCDIR
)/$$mkfile preflight_all TOPSRCDIR
=$(TOPSRCDIR
) OBJDIR
=$(OBJDIR
) MOZ_OBJDIR
=$(MOZ_OBJDIR
); \
225 # OBJDIR refers to the project-specific OBJDIR, which is not available at
226 # this point when building multiple projects. Only MOZ_OBJDIR is available.
228 for mkfile in
$(MOZ_PREFLIGHT_ALL
); do \
229 $(MAKE
) -f
$(TOPSRCDIR
)/$$mkfile preflight_all TOPSRCDIR
=$(TOPSRCDIR
) MOZ_OBJDIR
=$(MOZ_OBJDIR
) MOZ_BUILD_PROJECTS
="$(MOZ_BUILD_PROJECTS)"; \
234 # If we're building multiple projects, but haven't specified which project,
237 ifeq (,$(MOZ_CURRENT_PROJECT
)$(if
$(MOZ_BUILD_PROJECTS
),,1))
238 configure depend realbuild preflight postflight
$(OBJDIR_TARGETS
)::
240 for app in
$(MOZ_BUILD_PROJECTS
); do \
241 $(MAKE
) -f
$(TOPSRCDIR
)/client.mk
$@ MOZ_CURRENT_PROJECT
=$$app; \
246 # MOZ_CURRENT_PROJECT: either doing a single-project build, or building an
247 # individual project in a multi-project build.
249 ####################################
252 MAKEFILE
= $(wildcard $(OBJDIR
)/Makefile
)
253 CONFIG_STATUS
= $(wildcard $(OBJDIR
)/config.status
)
254 CONFIG_CACHE
= $(wildcard $(OBJDIR
)/config.cache
)
256 EXTRA_CONFIG_DEPS
:= \
257 $(TOPSRCDIR
)/aclocal.m4 \
258 $(wildcard $(TOPSRCDIR
)/build
/autoconf
/*.m4
) \
259 $(TOPSRCDIR
)/js
/src
/aclocal.m4 \
262 $(CONFIGURES
): %: %.in
$(EXTRA_CONFIG_DEPS
)
263 @
$(PYTHON
) $(TOPSRCDIR
)/js
/src
/config
/check-sync-dirs.py
$(TOPSRCDIR
)/js
/src
/build
$(TOPSRCDIR
)/build
264 @echo Generating
$@ using autoconf
265 cd
$(@D
); $(AUTOCONF
)
267 CONFIG_STATUS_DEPS
:= \
270 $(TOPSRCDIR
)/allmakefiles.sh \
271 $(TOPSRCDIR
)/nsprpub
/configure \
272 $(TOPSRCDIR
)/config
/milestone.txt \
273 $(TOPSRCDIR
)/js
/src
/config
/milestone.txt \
274 $(TOPSRCDIR
)/browser
/config
/version.txt \
275 $(TOPSRCDIR
)/*/confvars.sh \
279 CONFIGURE_ENV_ARGS
+= \
283 # configure uses the program name to determine @srcdir@. Calling it without
284 # $(TOPSRCDIR) will set @srcdir@ to "."; otherwise, it is set to the full
285 # path of $(TOPSRCDIR).
286 ifeq ($(TOPSRCDIR
),$(OBJDIR
))
287 CONFIGURE
= .
/configure
289 CONFIGURE
= $(TOPSRCDIR
)/configure
292 configure-files
: $(CONFIGURES
)
296 $(call mkdir_deps
,$(OBJDIR
)) \
297 $(if
$(MOZ_BUILD_PROJECTS
),$(call mkdir_deps
,$(MOZ_OBJDIR
))) \
301 save-mozconfig
: $(FOUND_MOZCONFIG
)
302 -cp
$(FOUND_MOZCONFIG
) $(OBJDIR
)/.mozconfig
304 configure
:: $(configure-preqs
)
306 @echo
$(CONFIGURE
) $(CONFIGURE_ARGS
)
307 @cd
$(OBJDIR
) && $(BUILD_PROJECT_ARG
) $(CONFIGURE_ENV_ARGS
) $(CONFIGURE
) $(CONFIGURE_ARGS
) \
308 ||
( echo
"*** Fix above errors and then restart with\
309 \"$(MAKE) -f client.mk build\"" && exit
1 )
310 @touch
$(OBJDIR
)/Makefile
313 $(OBJDIR
)/Makefile
: $(OBJDIR
)/config.status
315 $(OBJDIR
)/config.status
: $(CONFIG_STATUS_DEPS
)
317 $(OBJDIR
)/Makefile
: $(CONFIG_STATUS_DEPS
)
319 @
$(MAKE
) -f
$(TOPSRCDIR
)/client.mk configure
321 ifneq (,$(CONFIG_STATUS
))
322 $(OBJDIR
)/config
/autoconf.mk
: $(TOPSRCDIR
)/config
/autoconf.mk.in
324 CONFIG_FILES
=config
/autoconf.mk .
/config.status
328 ####################################
331 depend
:: $(OBJDIR
)/Makefile
$(OBJDIR
)/config.status
332 $(MOZ_MAKE
) export && $(MOZ_MAKE
) depend
334 ####################################
337 realbuild alldep preflight
::
340 for mkfile in
$(MOZ_PREFLIGHT
); do \
341 $(MAKE
) -f
$(TOPSRCDIR
)/$$mkfile preflight TOPSRCDIR
=$(TOPSRCDIR
) OBJDIR
=$(OBJDIR
) MOZ_OBJDIR
=$(MOZ_OBJDIR
); \
345 ####################################
348 realbuild
:: $(OBJDIR
)/Makefile
$(OBJDIR
)/config.status check-sync-dirs-config
351 ####################################
354 # Pass these target onto the real build system
355 $(OBJDIR_TARGETS
):: $(OBJDIR
)/Makefile
$(OBJDIR
)/config.status
358 ####################################
361 realbuild alldep postflight
::
364 for mkfile in
$(MOZ_POSTFLIGHT
); do \
365 $(MAKE
) -f
$(TOPSRCDIR
)/$$mkfile postflight TOPSRCDIR
=$(TOPSRCDIR
) OBJDIR
=$(OBJDIR
) MOZ_OBJDIR
=$(MOZ_OBJDIR
); \
369 endif # MOZ_CURRENT_PROJECT
371 ####################################
372 # Postflight, after building all projects
374 realbuild alldep postflight_all
::
375 ifeq (,$(MOZ_CURRENT_PROJECT
)$(if
$(MOZ_POSTFLIGHT_ALL
),,1))
376 # Don't run postflight_all for individual projects in multi-project builds
377 # (when MOZ_CURRENT_PROJECT is set.)
378 ifndef MOZ_BUILD_PROJECTS
379 # Building a single project, OBJDIR is usable.
381 for mkfile in
$(MOZ_POSTFLIGHT_ALL
); do \
382 $(MAKE
) -f
$(TOPSRCDIR
)/$$mkfile postflight_all TOPSRCDIR
=$(TOPSRCDIR
) OBJDIR
=$(OBJDIR
) MOZ_OBJDIR
=$(MOZ_OBJDIR
); \
385 # OBJDIR refers to the project-specific OBJDIR, which is not available at
386 # this point when building multiple projects. Only MOZ_OBJDIR is available.
388 for mkfile in
$(MOZ_POSTFLIGHT_ALL
); do \
389 $(MAKE
) -f
$(TOPSRCDIR
)/$$mkfile postflight_all TOPSRCDIR
=$(TOPSRCDIR
) MOZ_OBJDIR
=$(MOZ_OBJDIR
) MOZ_BUILD_PROJECTS
="$(MOZ_BUILD_PROJECTS)"; \
396 if
[ -f Makefile
]; then \
397 $(MAKE
) distclean ; \
399 echo
"Removing object files from srcdir..."; \
400 rm -fr
`find . -type d \( -name .deps -print -o -name CVS \
401 -o -exec test ! -d {}/CVS \; \) -prune \
402 -o \( -name '*.[ao]' -o -name '*.so' \) -type f -print`; \
403 build
/autoconf
/clean-config.sh
; \
406 ## Sanity check $X and js/src/$X are in sync
407 .PHONY
: check-sync-dirs
408 check-sync-dirs
: check-sync-dirs-build check-sync-dirs-config
410 @
$(PYTHON
) $(TOPSRCDIR
)/js
/src
/config
/check-sync-dirs.py
$(TOPSRCDIR
)/js
/src
/$* $(TOPSRCDIR
)/$*
415 # This makefile doesn't support parallel execution. It does pass
416 # MOZ_MAKE_FLAGS to sub-make processes, so they will correctly execute
420 .PHONY
: checkout real_checkout depend realbuild build profiledbuild cleansrcdir pull_all build_all
clobber clobber_all pull_and_build_all everything configure preflight_all preflight postflight postflight_all
$(OBJDIR_TARGETS
)