Google Git
Sign in
android / platform / development.git / 224f46945a868dfb39c1862a72c92a3a09a22832 / . / tools / winscope
tree: 68ae237d4798bd21dadb716ca52f0889462dddb7 [path history] [tgz]
  1. hooks/
  2. loaders/
  3. src/
  4. .eslintrc.js
  5. .gitignore
  6. all
  7. google.tslint.json
  8. karma.conf.js
  9. OWNERS
  10. package-lock.json
  11. package.json
  12. prettier.config.js
  13. protractor.config.js
  14. README.md
  15. tsconfig.json
  16. webpack.config.common.js
  17. webpack.config.dev.js
  18. webpack.config.prod.js
  19. webpack.config.unit_test.js
tools/winscope/README.md

Tool for visualizing window manager traces

Developing WinScope

When the trace is enabled, Window Manager and Surface Flinger capture and save current state to a file at each point of interest. frameworks/base/core/proto/android/server/windowmanagertrace.proto and frameworks/native/services/surfaceflinger/layerproto/layerstrace.proto contain the proto definitions for their internal states.

Checking out code and setting up environment

Build & test & deploy changes

  • Navigate to development/tools/winscope
  • Run npm run to get the list of available commands

Update IntDefMapping

  • Build framework-minus-apex-intdefs module and a preprocessor will generate the latest IntDefMapping. From the ANDROID_ROOT run:
. build/envsetup.sh
m framework-minus-apex-intdefs
  • Copy the generated intDefMapping.json files to the prebuilts repo.
python3 -c 'import sys,json,collections; print(json.dumps(collections.OrderedDict(sorted(collections.ChainMap(*map(lambda x:json.load(open(x)), sys.argv[1:])).items())), indent=2))' $(find out/soong/.intermediates/frameworks/base -iname intDefMapping.json) > ./prebuilts/misc/common/winscope/intDefMapping.json
  • Upload the changes.
cd ./prebuilts/misc/common/winscope
repo start intdef-update
git commit -am "Update intdef mapping" "Test: N/A"
repo upload --cbr .

Building with internal extensions

Internal paths in vendor/ which are not available in AOSP must be replaced by stub files. See getWaylandSafePath for an example