third_party/android_platform/README.chromium

   1 Name: Android Platform engineering tools
   2 Short Name: android platform development
   3 URL: https://android.googlesource.com/platform/development
   4 Version: 0
   5 Date: 2014/05/02
   6 Revision: 1b10ec4
   7 License: Apache 2.0
   8 License File: NOT_SHIPPED
   9 Security Critical: no
  10
  11 Description:
  12 Android Platform engineering tools, specifically stack symbolization scripts
  13 and a jar containing the AOSP framework to compile the Android WebView
  14 glue layer against. The AOSP framework is built from the Android release tag
  15 after which it is named, and the jar can be built by invoking make on the
  16 android_system_stubs target.
  17
  18 Also includes a ported copy of the Android relocation packing tool source,
  19 along with the files required to build it in the chromium tree.
  20
  21 Local Modifications:
  22 Only picked the few scripts needed by chrome.
  23
  24 The scripts have been modified to better suit Chromium development. Changes
  25 include, but are not limited to, the following:
  26 Added memoization of addr2line and objdump.
  27 Added option to change the amount of symbolization done.
  28 Updated output directories to use environment variable.
  29 When calling addr2line, check the symbol is a file that looks like it contains
  30     symbols.
  31 Added support for parsing LOG(FATAL) and DCHECK errors and their
  32     stack traces, as emitted by src/base/debug/stack_trace_android.cc
  33 Added support for finding symbols when library is loaded directly from the APK.
  34 Changed the toolchain to remove references to 4.6 toolchains.
  35 Added support for arch=x64 as an alias to arch=x86_64
  36 Added debug logging and --verbose parameter.
  37
  38 Android relocation packing tool details:
  39     Copy sources from AOSP bionic/tools/relocation_packer
  40     Remove scripts that regenerate golden test data (not relevant here)
  41     Create a nativehelper/ScopedFd.h to satisfy inclusion from main.cc
  42     Create gyp build
  43     Create gn build (currently packer only; no unit tests)
  44     List of bionic changes currently included:
  45       Refresh: https://android-review.googlesource.com/#/c/143878/
  46       Refresh: https://android-review.googlesource.com/#/c/147620/
  47                https://android-review.googlesource.com/#/c/147745/
  48                https://android-review.googlesource.com/#/c/148073/
  49       Refresh: https://android-review.googlesource.com/#/c/151901/
  50                https://android-review.googlesource.com/#/c/149300/
  51                https://android-review.googlesource.com/#/c/148822/
  52                https://android-review.googlesource.com/#/c/148492/
  53                https://android-review.googlesource.com/#/c/148175/