chrome/tools/build/mac/dump_product_syms

#!/bin/bash

# Copyright (c) 2012 The Chromium Authors. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.

# This script expects the following environment variables to be set.  Xcode
# normally sets them:
#
# CONFIGURATION - Release or Debug; this script only operates when Release.
# SRCROOT - /path/to/chrome/src/chrome
# BUILT_PRODUTS_DIR - /path/to/chrome/src/xcodebuild/Release
#
# The script also takes a single argument defining the branding type.
#
# To test this script without running an entire build:
#
# cd /path/to/chrome/src/chrome
# CONFIGURATION=Release \
#     SRCROOT=$(pwd) \
#     BUILT_PRODUCTS_DIR=$(pwd)/../xcodebuild/Release \
#     tools/build/mac/dump_app_syms Chromium

# Make sure we got the header to write into passed to us
if [ $# -ne 1 ]; then
  echo "error: missing branding as an argument" >&2
  exit 1
fi

set -ex

# Skip out if we're aren't in Release mode, no need for dump_syms on debug runs.
if [ "${CONFIGURATION}" != "Release" ] ; then
  exit 0
fi

TOP="${SRCROOT}/.."
BUILD_BRANDING=$1

BRAND_SCRIPT="${TOP}/build/branding_value.sh"
SRC_APP_NAME=$("${BRAND_SCRIPT}" "${BUILD_BRANDING}" PRODUCT_FULLNAME)
. "${TOP}/chrome/VERSION"

BREAKPAD_DUMP_SYMS="${BUILT_PRODUCTS_DIR}/dump_syms"
FULL_VERSION="${MAJOR}.${MINOR}.${BUILD}.${PATCH}"

DSYM_TAR_PATH="${BUILT_PRODUCTS_DIR}/${SRC_APP_NAME}.dSYM.tar.bz2"

# Starting with an already-dumped symbol file at ${original_sym_path},
# transforms the MODULE line (which must be the first line) from referring to
# ${original_stem} to refer to ${variant_stem}. The transformed symbol file
# is written to a symbol file at the same location that a symbol file would
# be written to if ${variant_name} were in the SRC_NAMES array below.
#
# If the transformed symbol file already appears more recent than
# ${original_sym_path}, it is left alone.
redump_syms_variant() {
  local original_sym_path="${1}"
  local original_stem="${2}"
  local variant_stem="${3}"
  local variant_name="${4}"
  local arch="${5}"

  local variant_sym_name="${variant_name}-${FULL_VERSION}-${arch}.breakpad"
  local variant_sym_path="${BUILT_PRODUCTS_DIR}/${variant_sym_name}"

  if [[ "${original_sym_path}" -nt "${variant_sym_path}" ]]; then
    local pattern="\
1s/^(MODULE [^ ]+ [^ ]+ [0-9a-fA-F]{33}) ${original_stem}\$/\1 ${variant_stem}/"
    sed -E -e "${pattern}" < "${original_sym_path}" > "${variant_sym_path}"
  fi
}

declare -a DSYMS

# Everything in SRC_NAMES is required. It's an error for any of these files
# to be missing.
SRC_NAMES=(
    "${SRC_APP_NAME}.app"
    "${SRC_APP_NAME} Framework.framework"
    "${SRC_APP_NAME} Helper.app"
    "crashpad_handler"
)

# PDF.plugin is optional. Only include it if present.
if [[ -e "${BUILT_PRODUCTS_DIR}/PDF.plugin" ]]; then
  SRC_NAMES[${#SRC_NAMES[@]}]="PDF.plugin"
fi

for SRC_NAME in "${SRC_NAMES[@]}"; do
  # SRC_STEM is the name of the file within the DWARF directory of the .dSYM
  # bundle, which comes from the on-disk name of an executable or dylib within
  # its enclosing .app, .framework or .plugin bundle.  This is the bundle name
  # without .app, .framework or .plugin appended.  For non-bundled types, the
  # stem is just the name of the singular file on disk.
  SRC_STEM=$(echo "${SRC_NAME}" | sed -Ee 's/\.(app|framework|plugin)$//')
  DSYM_NAME="${SRC_NAME}.dSYM"
  DSYM_PATH="${BUILT_PRODUCTS_DIR}/${DSYM_NAME}"
  DWARF_PATH="${DSYM_PATH}/Contents/Resources/DWARF/${SRC_STEM}"

  # SRC_PATH is the path to the Mach-O file to which the DSYM_PATH corresponds.
  # If this is a directory, it is a bundle, and the path to the actual image
  # needs to be computed for dump_syms.
  SRC_PREFIX="${BUILT_PRODUCTS_DIR}/${SRC_NAME}"
  SRC_PATH=""
  if [[ -d "${SRC_PREFIX}" ]]; then
    BUNDLED_OPTIONS=(
        # Executables and plugins:
        "${SRC_PREFIX}/Contents/MacOS/${SRC_STEM}"
        # Frameworks:
        "${SRC_PREFIX}/Versions/Current/${SRC_STEM}"
    )
    for BUNDLED_OPTION in "${BUNDLED_OPTIONS[@]}"; do
      if [[ -fx "${BUNDLED_OPTION}" ]]; then
        SRC_PATH="${BUNDLED_OPTION}"
        break
      fi
    done

    if [[ -z "${SRC_PATH}" ]]; then
      echo "${0}: Could not find bundled Mach-O file for ${SRC_NAME}"
      exit 1
    fi
  else
    # The Mach-O file is not a bundle.
    SRC_PATH="${SRC_PREFIX}"
  fi

  ARCHS=$(file "${DWARF_PATH}" | sed -Ene 's/^.*(i386|x86_64)$/\1/p')
  if [[ -z "${ARCHS}" ]]; then
    echo "${0}: expected something dumpable in ${DWARF_PATH}" >& 2
    exit 1
  fi

  for ARCH in ${ARCHS}; do
    BPAD_SYM_NAME="${SRC_NAME}-${FULL_VERSION}-${ARCH}.breakpad"
    BPAD_SYM_PATH="${BUILT_PRODUCTS_DIR}/${BPAD_SYM_NAME}"

    # Only run dump_syms if the file has changed since the last dump. Use -g
    # to dump data from the dSYM and CFI data from the Mach-O library or
    # executable.
    if [ "${DWARF_PATH}" -nt "${BPAD_SYM_PATH}" -o \
         "${SRC_PATH}" -nt "${BPAD_SYM_PATH}" ] ; then
      "${BREAKPAD_DUMP_SYMS}" -a "${ARCH}" -g "${DWARF_PATH}" "${SRC_PATH}" > \
          "${BPAD_SYM_PATH}"
    fi

    # Some executables will show up with variant names. The Breakpad symbol
    # server looks up modules based on a combination of the module name and
    # identifier (UUID). Produce symbol files for these variant names so that
    # the Breakpad symbol server will have something to return for stacks that
    # travel through these modules.
    case "${SRC_NAME}" in
      "${SRC_APP_NAME}.app")
        # Google Chrome Canary is produced during packaging.
        redump_syms_variant "${BPAD_SYM_PATH}" "${SRC_STEM}" \
                            "${SRC_STEM} Canary" "${SRC_STEM} Canary.app" \
                            "${ARCH}"
        ;;
    esac
  done

  # Remove the .dSYM archive if the file has changed since the archive was
  # last generated.  This will cause a new .dSYM archive to be created.
  if [ "${DWARF_PATH}" -nt "${DSYM_TAR_PATH}" ] ; then
    rm -f "${DSYM_TAR_PATH}"
  fi

  # Push the .dSYM bundle onto the DSYMS array so that it will be included in
  # the .dSYM archive if a new one is needed
  DSYMS[${#DSYMS[@]}]="${DSYM_NAME}"
done

# Create the archive of .dSYM bundles.
if [ ! -e "${DSYM_TAR_PATH}" ] ; then
  # Change directory so that absolute paths aren't included in the archive.
  (cd "${BUILT_PRODUCTS_DIR}" &&
   tar -jcf "${DSYM_TAR_PATH}" "${DSYMS[@]}")
fi