client.mk

   1 # ***** BEGIN LICENSE BLOCK *****
   2 # Version: MPL 1.1/GPL 2.0/LGPL 2.1
   3 #
   4 # The contents of this file are subject to the Mozilla Public License Version
   5 # 1.1 (the "License"); you may not use this file except in compliance with
   6 # the License. You may obtain a copy of the License at
   7 # http://www.mozilla.org/MPL/
   8 #
   9 # Software distributed under the License is distributed on an "AS IS" basis,
  10 # WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
  11 # for the specific language governing rights and limitations under the
  12 # License.
  13 #
  14 # The Original Code is mozilla.org code.
  15 #
  16 # The Initial Developer of the Original Code is
  17 # Netscape Communications Corporation.
  18 # Portions created by the Initial Developer are Copyright (C) 1998
  19 # the Initial Developer. All Rights Reserved.
  20 #
  21 # Contributor(s):
  22 #   Stephen Lamm
  23 #   Benjamin Smedberg <bsmedberg@covad.net>
  24 #   Chase Phillips <chase@mozilla.org>
  25 #   Mark Mentovai <mark@moxienet.com>
  26 #
  27 # Alternatively, the contents of this file may be used under the terms of
  28 # either the GNU General Public License Version 2 or later (the "GPL"), or
  29 # the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
  30 # in which case the provisions of the GPL or the LGPL are applicable instead
  31 # of those above. If you wish to allow use of your version of this file only
  32 # under the terms of either the GPL or the LGPL, and not to allow others to
  33 # use your version of this file under the terms of the MPL, indicate your
  34 # decision by deleting the provisions above and replace them with the notice
  35 # and other provisions required by the GPL or the LGPL. If you do not delete
  36 # the provisions above, a recipient may use your version of this file under
  37 # the terms of any one of the MPL, the GPL or the LGPL.
  38 #
  39 # ***** END LICENSE BLOCK *****
  40
  41 # Build a mozilla application.
  42 #
  43 # To build a tree,
  44 #    1. hg clone ssh://hg.mozilla.org/mozilla-central mozilla
  45 #    2. cd mozilla
  46 #    3. create your .mozconfig file with
  47 #       ac_add_options --enable-application=browser
  48 #    4. gmake -f client.mk
  49 #
  50 # Other targets (gmake -f client.mk [targets...]),
  51 #    build
  52 #    clean (realclean is now the same as clean)
  53 #    distclean
  54 #
  55 # See http://developer.mozilla.org/en/docs/Build_Documentation for
  56 # more information.
  57 #
  58 # Options:
  59 #   MOZ_BUILD_PROJECTS   - Build multiple projects in subdirectories
  60 #                          of MOZ_OBJDIR
  61 #   MOZ_OBJDIR           - Destination object directory
  62 #   MOZ_MAKE_FLAGS       - Flags to pass to $(MAKE)
  63 #   MOZ_PREFLIGHT_ALL  } - Makefiles to run before any project in
  64 #   MOZ_PREFLIGHT      }   MOZ_BUILD_PROJECTS, before each project, after
  65 #   MOZ_POSTFLIGHT     }   each project, and after all projects; these
  66 #   MOZ_POSTFLIGHT_ALL }   variables contain space-separated lists
  67 #   MOZ_UNIFY_BDATE      - Set to use the same bdate for each project in
  68 #                          MOZ_BUILD_PROJECTS
  69 #
  70 #######################################################################
  71 # Defines
  72
  73 comma := ,
  74
  75 CWD := $(CURDIR)
  76 ifneq (1,$(words $(CWD)))
  77 $(error The mozilla directory cannot be located in a path with spaces.)
  78 endif
  79
  80 ifeq "$(CWD)" "/"
  81 CWD   := /.
  82 endif
  83
  84 ifndef TOPSRCDIR
  85 ifeq (,$(wildcard client.mk))
  86 TOPSRCDIR := $(patsubst %/,%,$(dir $(MAKEFILE_LIST)))
  87 MOZ_OBJDIR = .
  88 else
  89 TOPSRCDIR := $(CWD)
  90 endif
  91 endif
  92
  93 # try to find autoconf 2.13 - discard errors from 'which'
  94 # MacOS X 10.4 sends "no autoconf*" errors to stdout, discard those via grep
  95 AUTOCONF ?= $(shell which autoconf-2.13 autoconf2.13 autoconf213 2>/dev/null | grep -v '^no autoconf' | head -1)
  96
  97 ifeq (,$(strip $(AUTOCONF)))
  98 AUTOCONF=$(error Couldn't find autoconf 2.13)
  99 endif
 100
 101 MKDIR := mkdir
 102 SH := /bin/sh
 103 ifndef MAKE
 104 MAKE := gmake
 105 endif
 106 PERL ?= perl
 107 PYTHON ?= python
 108
 109 CONFIG_GUESS_SCRIPT := $(wildcard $(TOPSRCDIR)/build/autoconf/config.guess)
 110 ifdef CONFIG_GUESS_SCRIPT
 111   CONFIG_GUESS = $(shell $(CONFIG_GUESS_SCRIPT))
 112 endif
 113
 114
 115 ####################################
 116 # Sanity checks
 117
 118 ifneq (,$(filter MINGW%,$(shell uname -s)))
 119 # check for CRLF line endings
 120 ifneq (0,$(shell $(PERL) -e 'binmode(STDIN); while (<STDIN>) { if (/\r/) { print "1"; exit } } print "0"' < $(TOPSRCDIR)/client.mk))
 121 $(error This source tree appears to have Windows-style line endings. To \
 122 convert it to Unix-style line endings, run \
 123 "python mozilla/build/win32/mozilla-dos2unix.py")
 124 endif
 125 endif
 126
 127 ####################################
 128 # Load mozconfig Options
 129
 130 # See build pages, http://www.mozilla.org/build/ for how to set up mozconfig.
 131
 132 MOZCONFIG_LOADER := build/autoconf/mozconfig2client-mk
 133 MOZCONFIG_FINDER := build/autoconf/mozconfig-find
 134 MOZCONFIG_MODULES := build/unix/uniq.pl
 135
 136
 137
 138 run_for_side_effects := \
 139   $(shell $(TOPSRCDIR)/$(MOZCONFIG_LOADER) $(TOPSRCDIR) $(TOPSRCDIR)/.mozconfig.mk > $(TOPSRCDIR)/.mozconfig.out)
 140
 141 include $(TOPSRCDIR)/.mozconfig.mk
 142
 143 ifndef MOZ_OBJDIR
 144   MOZ_OBJDIR = obj-$(CONFIG_GUESS)
 145 endif
 146
 147 ifdef MOZ_BUILD_PROJECTS
 148
 149 ifdef MOZ_CURRENT_PROJECT
 150   OBJDIR = $(MOZ_OBJDIR)/$(MOZ_CURRENT_PROJECT)
 151   MOZ_MAKE = $(MAKE) $(MOZ_MAKE_FLAGS) -C $(OBJDIR)
 152   BUILD_PROJECT_ARG = MOZ_BUILD_APP=$(MOZ_CURRENT_PROJECT)
 153 else
 154   OBJDIR = $(error Cannot find the OBJDIR when MOZ_CURRENT_PROJECT is not set.)
 155   MOZ_MAKE = $(error Cannot build in the OBJDIR when MOZ_CURRENT_PROJECT is not set.)
 156 endif
 157
 158 else # MOZ_BUILD_PROJECTS
 159
 160 OBJDIR = $(MOZ_OBJDIR)
 161 MOZ_MAKE = $(MAKE) $(MOZ_MAKE_FLAGS) -C $(OBJDIR)
 162
 163 endif # MOZ_BUILD_PROJECTS
 164
 165 # 'configure' scripts generated by autoconf.
 166 CONFIGURES := $(TOPSRCDIR)/configure
 167 CONFIGURES += $(TOPSRCDIR)/js/src/configure
 168
 169 #######################################################################
 170 # Rules
 171
 172 # The default rule is build
 173 build::
 174
 175 # Print out any options loaded from mozconfig.
 176 all build clean depend distclean export libs install realclean::
 177         @if test -f .mozconfig.out; then \
 178           cat .mozconfig.out; \
 179           rm -f .mozconfig.out; \
 180         else true; \
 181         fi
 182
 183 # Windows equivalents
 184 build_all: build
 185 build_all_dep: alldep
 186 build_all_depend: alldep
 187 clobber clobber_all: clean
 188
 189 # Do everything from scratch
 190 everything: clean build
 191
 192 ####################################
 193 # Profile-Guided Optimization
 194 #  To use this, you should set the following variables in your mozconfig
 195 #    mk_add_options PROFILE_GEN_SCRIPT=/path/to/profile-script
 196 #
 197 #  The profile script should exercise the functionality to be included
 198 #  in the profile feedback.
 199 #
 200 #  This is up here, outside of the MOZ_CURRENT_PROJECT logic so that this
 201 #  is usable in multi-pass builds, where you might not have a runnable
 202 #  application until all the build passes and postflight scripts have run.
 203 ifdef MOZ_OBJDIR
 204   PGO_OBJDIR = $(MOZ_OBJDIR)
 205 else
 206   PGO_OBJDIR := $(TOPSRCDIR)
 207 endif
 208
 209 profiledbuild::
 210         $(MAKE) -f $(TOPSRCDIR)/client.mk build MOZ_PROFILE_GENERATE=1
 211         $(MAKE) -C $(PGO_OBJDIR) package
 212         OBJDIR=${PGO_OBJDIR} $(PROFILE_GEN_SCRIPT)
 213         $(MAKE) -f $(TOPSRCDIR)/client.mk maybe_clobber_profiledbuild
 214         $(MAKE) -f $(TOPSRCDIR)/client.mk build MOZ_PROFILE_USE=1
 215
 216 #####################################################
 217 # Build date unification
 218
 219 ifdef MOZ_UNIFY_BDATE
 220 ifndef MOZ_BUILD_DATE
 221 ifdef MOZ_BUILD_PROJECTS
 222 MOZ_BUILD_DATE = $(shell $(PYTHON) $(TOPSRCDIR)/toolkit/xre/make-platformini.py --print-buildid)
 223 export MOZ_BUILD_DATE
 224 endif
 225 endif
 226 endif
 227
 228 #####################################################
 229 # Preflight, before building any project
 230
 231 build alldep preflight_all::
 232 ifeq (,$(MOZ_CURRENT_PROJECT)$(if $(MOZ_PREFLIGHT_ALL),,1))
 233 # Don't run preflight_all for individual projects in multi-project builds
 234 # (when MOZ_CURRENT_PROJECT is set.)
 235 ifndef MOZ_BUILD_PROJECTS
 236 # Building a single project, OBJDIR is usable.
 237         set -e; \
 238         for mkfile in $(MOZ_PREFLIGHT_ALL); do \
 239           $(MAKE) -f $(TOPSRCDIR)/$$mkfile preflight_all TOPSRCDIR=$(TOPSRCDIR) OBJDIR=$(OBJDIR) MOZ_OBJDIR=$(MOZ_OBJDIR); \
 240         done
 241 else
 242 # OBJDIR refers to the project-specific OBJDIR, which is not available at
 243 # this point when building multiple projects.  Only MOZ_OBJDIR is available.
 244         set -e; \
 245         for mkfile in $(MOZ_PREFLIGHT_ALL); do \
 246           $(MAKE) -f $(TOPSRCDIR)/$$mkfile preflight_all TOPSRCDIR=$(TOPSRCDIR) MOZ_OBJDIR=$(MOZ_OBJDIR) MOZ_BUILD_PROJECTS="$(MOZ_BUILD_PROJECTS)"; \
 247         done
 248 endif
 249 endif
 250
 251 # If we're building multiple projects, but haven't specified which project,
 252 # loop through them.
 253
 254 ifeq (,$(MOZ_CURRENT_PROJECT)$(if $(MOZ_BUILD_PROJECTS),,1))
 255 configure depend build install export libs clean realclean distclean alldep preflight postflight maybe_clobber_profiledbuild upload sdk::
 256         set -e; \
 257         for app in $(MOZ_BUILD_PROJECTS); do \
 258           $(MAKE) -f $(TOPSRCDIR)/client.mk $@ MOZ_CURRENT_PROJECT=$$app; \
 259         done
 260
 261 else
 262
 263 # MOZ_CURRENT_PROJECT: either doing a single-project build, or building an
 264 # individual project in a multi-project build.
 265
 266 ####################################
 267 # Configure
 268
 269 CONFIG_STATUS = $(wildcard $(OBJDIR)/config.status)
 270 CONFIG_CACHE  = $(wildcard $(OBJDIR)/config.cache)
 271
 272 EXTRA_CONFIG_DEPS := \
 273         $(TOPSRCDIR)/aclocal.m4 \
 274         $(wildcard $(TOPSRCDIR)/build/autoconf/*.m4) \
 275         $(TOPSRCDIR)/js/src/aclocal.m4 \
 276         $(NULL)
 277
 278 $(CONFIGURES): %: %.in $(EXTRA_CONFIG_DEPS)
 279         @echo Generating $@ using autoconf
 280         cd $(@D); $(AUTOCONF)
 281
 282 CONFIG_STATUS_DEPS := \
 283         $(wildcard $(CONFIGURES)) \
 284         $(TOPSRCDIR)/allmakefiles.sh \
 285         $(TOPSRCDIR)/.mozconfig.mk \
 286         $(wildcard $(TOPSRCDIR)/nsprpub/configure) \
 287         $(wildcard $(TOPSRCDIR)/config/milestone.txt) \
 288         $(wildcard $(addsuffix confvars.sh,$(wildcard $(TOPSRCDIR)/*/))) \
 289         $(NULL)
 290
 291 # configure uses the program name to determine @srcdir@. Calling it without
 292 #   $(TOPSRCDIR) will set @srcdir@ to "."; otherwise, it is set to the full
 293 #   path of $(TOPSRCDIR).
 294 ifeq ($(TOPSRCDIR),$(OBJDIR))
 295   CONFIGURE = ./configure
 296 else
 297   CONFIGURE = $(TOPSRCDIR)/configure
 298 endif
 299
 300 configure-files: $(CONFIGURES)
 301
 302 configure:: configure-files
 303 ifdef MOZ_BUILD_PROJECTS
 304         @if test ! -d $(MOZ_OBJDIR); then $(MKDIR) $(MOZ_OBJDIR); else true; fi
 305 endif
 306         @if test ! -d $(OBJDIR); then $(MKDIR) $(OBJDIR); else true; fi
 307         @echo cd $(OBJDIR);
 308         @echo $(CONFIGURE) $(CONFIGURE_ARGS)
 309         @cd $(OBJDIR) && $(BUILD_PROJECT_ARG) $(CONFIGURE_ENV_ARGS) $(CONFIGURE) $(CONFIGURE_ARGS) \
 310           || ( echo "*** Fix above errors and then restart with\
 311                \"$(MAKE) -f client.mk build\"" && exit 1 )
 312         @touch $(OBJDIR)/Makefile
 313
 314 $(OBJDIR)/Makefile $(OBJDIR)/config.status: $(CONFIG_STATUS_DEPS)
 315         @$(MAKE) -f $(TOPSRCDIR)/client.mk configure
 316
 317 ifneq (,$(CONFIG_STATUS))
 318 $(OBJDIR)/config/autoconf.mk: $(TOPSRCDIR)/config/autoconf.mk.in
 319         cd $(OBJDIR); \
 320           CONFIG_FILES=config/autoconf.mk ./config.status
 321 endif
 322
 323
 324 ####################################
 325 # Depend
 326
 327 depend:: $(OBJDIR)/Makefile $(OBJDIR)/config.status
 328         $(MOZ_MAKE) export && $(MOZ_MAKE) depend
 329
 330 ####################################
 331 # Preflight
 332
 333 build alldep preflight::
 334 ifdef MOZ_PREFLIGHT
 335         set -e; \
 336         for mkfile in $(MOZ_PREFLIGHT); do \
 337           $(MAKE) -f $(TOPSRCDIR)/$$mkfile preflight TOPSRCDIR=$(TOPSRCDIR) OBJDIR=$(OBJDIR) MOZ_OBJDIR=$(MOZ_OBJDIR); \
 338         done
 339 endif
 340
 341 ####################################
 342 # Build it
 343
 344 build::  $(OBJDIR)/Makefile $(OBJDIR)/config.status
 345         $(MOZ_MAKE)
 346
 347 ####################################
 348 # Other targets
 349
 350 # Pass these target onto the real build system
 351 install export libs clean realclean distclean alldep maybe_clobber_profiledbuild upload sdk:: $(OBJDIR)/Makefile $(OBJDIR)/config.status
 352         $(MOZ_MAKE) $@
 353
 354 ####################################
 355 # Postflight
 356
 357 build alldep postflight::
 358 ifdef MOZ_POSTFLIGHT
 359         set -e; \
 360         for mkfile in $(MOZ_POSTFLIGHT); do \
 361           $(MAKE) -f $(TOPSRCDIR)/$$mkfile postflight TOPSRCDIR=$(TOPSRCDIR) OBJDIR=$(OBJDIR) MOZ_OBJDIR=$(MOZ_OBJDIR); \
 362         done
 363 endif
 364
 365 endif # MOZ_CURRENT_PROJECT
 366
 367 ####################################
 368 # Postflight, after building all projects
 369
 370 build alldep postflight_all::
 371 ifeq (,$(MOZ_CURRENT_PROJECT)$(if $(MOZ_POSTFLIGHT_ALL),,1))
 372 # Don't run postflight_all for individual projects in multi-project builds
 373 # (when MOZ_CURRENT_PROJECT is set.)
 374 ifndef MOZ_BUILD_PROJECTS
 375 # Building a single project, OBJDIR is usable.
 376         set -e; \
 377         for mkfile in $(MOZ_POSTFLIGHT_ALL); do \
 378           $(MAKE) -f $(TOPSRCDIR)/$$mkfile postflight_all TOPSRCDIR=$(TOPSRCDIR) OBJDIR=$(OBJDIR) MOZ_OBJDIR=$(MOZ_OBJDIR); \
 379         done
 380 else
 381 # OBJDIR refers to the project-specific OBJDIR, which is not available at
 382 # this point when building multiple projects.  Only MOZ_OBJDIR is available.
 383         set -e; \
 384         for mkfile in $(MOZ_POSTFLIGHT_ALL); do \
 385           $(MAKE) -f $(TOPSRCDIR)/$$mkfile postflight_all TOPSRCDIR=$(TOPSRCDIR) MOZ_OBJDIR=$(MOZ_OBJDIR) MOZ_BUILD_PROJECTS="$(MOZ_BUILD_PROJECTS)"; \
 386         done
 387 endif
 388 endif
 389
 390 cleansrcdir:
 391         @cd $(TOPSRCDIR); \
 392         if [ -f Makefile ]; then \
 393           $(MAKE) distclean ; \
 394         else \
 395           echo "Removing object files from srcdir..."; \
 396           rm -fr `find . -type d \( -name .deps -print -o -name CVS \
 397                   -o -exec test ! -d {}/CVS \; \) -prune \
 398                   -o \( -name '*.[ao]' -o -name '*.so' \) -type f -print`; \
 399            build/autoconf/clean-config.sh; \
 400         fi;
 401
 402 echo-variable-%:
 403         @echo $($*)
 404
 405 # This makefile doesn't support parallel execution. It does pass
 406 # MOZ_MAKE_FLAGS to sub-make processes, so they will correctly execute
 407 # in parallel.
 408 .NOTPARALLEL:
 409
 410 .PHONY: checkout real_checkout depend build profiledbuild maybe_clobber_profiledbuild export libs alldep install clean realclean distclean cleansrcdir pull_all build_all clobber clobber_all pull_and_build_all everything configure preflight_all preflight postflight postflight_all upload sdk