Google Git
Sign in
android / platform / development / 881e6d026491377b883286cd1b75a268f1a017d1 / . / tools / winscope
tree: 884d02b3a7200179e658c07fad9c0cbc9589f630 [path history] [tgz]
  1. adb_proxy/
  2. env/
  3. libs/
  4. loaders/
  5. spec/
  6. src/
  7. static/
  8. tests/
  9. .babelrc
  10. .eslintrc.json
  11. .gitignore
  12. package.json
  13. README.md
  14. trace.sh
  15. tsconfig.json
  16. vue.config.js
  17. webpack.config.common.js
  18. webpack.config.dev.js
  19. webpack.config.js
  20. webpack.config.prod.js
  21. webpack.spec.config.js
  22. yarn.lock
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

Building & testing changes

  • Navigate to development/tools/winscope
  • Run yarn run dev

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