| commit | f87d49e41a5dd57733d02f3990c91dc38e557dad | [log] [tgz] |
|---|---|---|
| author | Dan Willemsen <dwillemsen@google.com> | Thu Sep 29 20:09:47 2016 -0700 |
| committer | Dan Willemsen <dwillemsen@google.com> | Thu Sep 29 22:21:10 2016 -0700 |
| tree | 9533b73a9ec811257ed79f12467e50d83df0d2fd | |
| parent | 5e45e973c38c92c42cc86aa5dafeca13e6823b5f [diff] |
Support marking variables as readonly When the magic variable .KATI_READONLY is set to a variable name, any further attempts to modify the named variable will result in an error. FOO := bar .KATI_READONLY := FOO FOO := baz # Error! This is useful to make some global configuration readonly so that another makefile cannot change it. In Android, we emulated this by backing up some global configuration before including the Android.mk files, then comparing the current values to the backed up values after they've been included. But this means we don't know the location that modified the variable, just that something did. And it's not perfect, since the backup can also be changed. Something similar to this could be implemented with `override`, but then setting the variable silently fails, and it still could be overriden with another override.
- eval.cc[diff]
- eval.h[diff]
- symtab.cc[diff]
- symtab.h[diff]
- testcase/readonly_global.sh[Added - diff]
- testcase/readonly_global_missing.sh[Added - diff]
- testcase/readonly_rule.sh[Added - diff]
- testcase/readonly_rule_missing.sh[Added - diff]
- var.cc[diff]
- var.h[diff]
10 files changed
tree: 9533b73a9ec811257ed79f12467e50d83df0d2fd
- cmd/
- make-c/
- testcase/
- .gitignore
- .travis.yml
- affinity.cc
- affinity.h
- Android.bp
- ast.go
- AUTHORS
- bootstrap.go
- buf.go
- buf_test.go
- command.cc
- command.h
- CONTRIBUTING.md
- CONTRIBUTORS
- dep.cc
- dep.go
- dep.h
- depgraph.go
- doc.go
- eval.cc
- eval.go
- eval.h
- evalcmd.go
- exec.cc
- exec.go
- exec.h
- expr.cc
- expr.go
- expr.h
- expr_test.go
- file.cc
- file.h
- file_cache.cc
- file_cache.h
- fileutil.cc
- fileutil.go
- fileutil.h
- find.cc
- find.h
- find_test.cc
- flags.cc
- flags.go
- flags.h
- func.cc
- func.go
- func.h
- func_test.go
- INTERNALS.md
- io.cc
- io.h
- LICENSE
- loc.h
- log.cc
- log.go
- log.h
- m2n
- main.cc
- make-c.sh
- Makefile
- Makefile.ckati
- Makefile.kati
- ninja.cc
- ninja.go
- ninja.h
- ninja_test.cc
- ninja_test.go
- pack.sh
- parser.cc
- parser.go
- parser.h
- pathutil.go
- pathutil_test.go
- query.go
- README.md
- regen.cc
- regen.h
- rule.cc
- rule.h
- rule_parser.go
- rule_parser_test.go
- runtest.rb
- serialize.go
- shellutil.go
- shellutil_test.go
- stats.cc
- stats.go
- stats.h
- stmt.cc
- stmt.h
- string_piece.cc
- string_piece.h
- string_piece_test.cc
- stringprintf.cc
- stringprintf.h
- strutil.cc
- strutil.go
- strutil.h
- strutil_bench.cc
- strutil_test.cc
- strutil_test.go
- symtab.cc
- symtab.go
- symtab.h
- testutil.h
- thread_local.h
- thread_pool.cc
- thread_pool.h
- timeutil.cc
- timeutil.h
- var.cc
- var.go
- var.h
- version.go
- version.h
- version_unknown.cc
- worker.go
README.md
kati
kati is an experimental GNU make clone. The main goal of this tool is to speed-up incremental build of Android.
Currently, kati does not offer a faster build by itself. It instead converts your Makefile to a ninja file.
How to use for Android
Now AOSP has kati and ninja, so all you have to do is
% export USE_NINJA=true
All Android's build commands (m, mmm, mmma, etc.) should just work.
How to use for Android (deprecated way)
Set up kati:
% cd ~/src % git clone https://github.com/google/kati % cd kati % make
Build Android:
% cd <android-directory> % source build/envsetup.sh % lunch <your-choice> % ~/src/kati/m2n --kati_stats # Use --goma if you are a Googler. % ./ninja.sh
You need ninja in your $PATH.
More usage examples (deprecated way)
"make clean"
% ./ninja.sh -t clean
Note ./ninja.sh passes all parameters to ninja.
Build a specific target
For example, the following is equivalent to "make cts":
% ./ninja.sh cts
Or, if you know the path you want, you can do:
% ./ninja.sh out/host/linux-x86/bin/adb