README.md

debugium

Attempt at pulling out chromium debugger to use it with Node.js.

Table of Contents generated with DocToc

• Getting Started
  • Init Repo
  • Add Paths
  • Building
• Sources
• Dependencies
  • Main Target
  • Resource/Code Generators
    • Most need
    • Targets
      • devtools resources
• License

Getting Started

Since we are not using gclient a few scripts have been included in order to properly set up the debugium repository.

Init Repo

After cloning run ./scripts/init in order to initialize the repo.

Add Paths

Run source ./scripts/exports to add necessary paths, i.e. to use custom installed clang to build debugium.

Building

Execute gyp to regenerate build files, then run ninja.

./scripts/gyp
ninja -C src/out/Debug all

Sources

./src                                 https://chromium.googlesource.com/chromium/src        (copied for now)
      /build                          https://chromium.googlesource.com/chromium/src/build
      /content/public/browser         part of /src repo
      /third_party
                  /WebKit             https://chromium.googlesource.com/chromium/blink
                  /icu                https://chromium.googlesource.com/chromium/deps/icu52 
                  /llvm-build         generated via ./tools/clang/update.sh
                  /jinja2             part of /src repo (original: https://github.com/mitsuhiko/jinja2)
                  /markupsafe         part of /src repo (original: https://github.com/mitsuhiko/markupsafe)
      /tools
            /grit                     https://chromium.googlesource.com/external/grit-i18n.git
            /gyp                      https://chromium.googlesource.com/external/gyp.git
            /clang                    https://chromium.googlesource.com/chromium/src/tools/clang
            /gritsettings             part of /src repo

Dependencies

Main Target

./src/build_debugium/debugium.gyp
  - ./src/content/browser/devtools/devtools_resources.gyp:devtools_resources
  - ./src/content/browser/devtools/devtools.gyp:devtools_protocol_handler

Resource/Code Generators

Most need

• ./src/build/grit_target.gypi

Targets

devtools resources

• devtools.gyp:devtools_resources uses part of same dependencies and adds no others

./src/content/browser/devtools/devtools_resources.gyp
  :devtools_resources
    @devtools_resources
      - ./src/third_party/WebKit/public/blink_devtools.gyp:blink_generate_devtools_grd
      - ./src/tools/grit/grit.py
    @devtools_protocol_constants
      - ./src/third_party/WebKit/Source/devtools/protocol.json
      - ./src/content/browser/devtools/browser_protocol.json
      - ./src/third_party/WebKit/public/browser/devtools_protocol_constants_generator.py

./src/third_party/WebKit/public/blink_devtools.gyp
  :blink_generate_devtools_grd
    - ./src/third_party/WebKit/Source/devtools/devtools.gyp:generate_devtools_grd
  :blink_devtools_frontend_resources
    - ./src/third_party/WebKit/Source/devtools/devtools.gyp:devtools_frontend_resources

./src/third_party/WebKit/public/blink_devtools.gyp
  :blink_generate_devtools_grd
    - ./src/third_party/WebKit/Source/devtools/devtools.gyp:generate_devtools_grd

./src/third_party/WebKit/Source/devtools/devtools.gyp
  :generate_devtools_grd
    - ./src/third_party/WebKit/Source/devtools/devtools.gypi
    :devtools_frontend_resources
    :devtools_html
    :toolbox_html
    :devtools_extension_api
    - ./src/third_party/WebKit/Source/devtools/scripts/generate_devtools_grd.py
  :devtools_frontend_resources
    :build_applications
    :devtools_html
    :toolbox_html
    :supported_css_properties
    :frontend_protocol_sources
  :build_applications
    :devtools_html
    :toolbox_html
    :supported_css_properties
    :frontend_protocol_sources
    - ./src/third_party/WebKit/Source/devtools/scripts/build_applications.py
    - ./src/third_party/WebKit/Source/devtools/scripts/modular_build.py
    - ./src/third_party/WebKit/Source/devtools/scripts/concatenate_application_code.py
  :devtools_html
    - ./src/third_party/WebKit/Source/devtools/front_end/devtools.html
    - ./src/third_party/WebKit/Source/devtools/scripts/generate_devtools_html.py
  :toolbox_html
    - ./src/third_party/WebKit/Source/devtools/front_end/toolbox.html
    - ./src/third_party/WebKit/Source/devtools/scripts/generate_devtools_html.py
  :supported_css_properties
    - ./src/third_party/WebKit/Source/devtools/scripts/generate_supported_css.py
    - ./src/third_party/WebKit/Source/core/css/CSSProperties.in
  :frontend_protocol_sources
    - ./src/third_party/WebKit/Source/devtools/scripts/CodeGeneratorFrontend.py
    - ./src/third_party/WebKit/Source/devtools/protocol.json
  :devtools_extension_api
    - ./src/third_party/WebKit/Source/devtools/scripts/generate_devtools_extension_api.py
    
./src/third_party/WebKit/Source/devtools/devtools.gypi
  - ./src/third_party/WebKit/Source/devtools/frontend/*

License

MIT