#!/bin/sh # # Copyright (C) 2011 The Android Open Source Project # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. # # gen-platforms.sh # # This tool is used when packaging a new release, or when developing # the NDK itself. It will populate DST ($NDK/platforms by default) # with the content of SRC ($NDK/../development/ndk/platforms/ by default). # # The idea is that the content of $SRC/android-N/ only contains stuff # that is relevant to API level N, and not contain anything that is already # provided by API level N-1, N-2, etc.. # # More precisely, for each architecture A: # $SRC/android-N/include --> $DST/android-N/arch-A/usr/include # $SRC/android-N/arch-A/include --> $DST/android-N/arch-A/usr/include # $SRC/android-N/arch-A/lib --> $DST/android-N/arch-A/usr/lib # # Also, we generate on-the-fly shell dynamic libraries from list of symbols: # # $SRC/android-N/arch-A/symbols --> $DST/android-N/arch-A/usr/lib # # Repeat after that for N+1, N+2, etc.. # PROGDIR=$(dirname "$0") . "$PROGDIR/prebuilt-common.sh" # Return the list of platform supported from $1/platforms # as a single space-separated list of levels. (e.g. "3 4 5 8 9") # $1: source directory extract_platforms_from () { if [ -d "$1" ] ; then (cd "$1/platforms" && ls -d android-*) | sed -e "s!android-!!" | sort -g | tr '\n' ' ' else echo "" fi } SRCDIR="../development/ndk" DSTDIR="$ANDROID_NDK_ROOT" ARCHS="$DEFAULT_ARCHS" PLATFORMS=`extract_platforms_from "$SRCDIR"` NDK_DIR=$ANDROID_NDK_ROOT OPTION_HELP=no OPTION_PLATFORMS= OPTION_SRCDIR= OPTION_DSTDIR= OPTION_SAMPLES= OPTION_FAST_COPY= OPTION_MINIMAL= OPTION_ARCH= OPTION_ABI= PACKAGE_DIR= VERBOSE=no VERBOSE2=no for opt do optarg=`expr "x$opt" : 'x[^=]*=\(.*\)'` case "$opt" in --help|-h|-\?) OPTION_HELP=yes ;; --verbose) if [ "$VERBOSE" = "yes" ] ; then VERBOSE2=yes else VERBOSE=yes fi ;; --src-dir=*) OPTION_SRCDIR="$optarg" ;; --dst-dir=*) OPTION_DSTDIR="$optarg" ;; --ndk-dir=*) NDK_DIR=$optarg ;; --platform=*) OPTION_PLATFORM=$optarg ;; --arch=*) OPTION_ARCH=$optarg ;; --abi=*) # We still support this for backwards-compatibility OPTION_ABI=$optarg ;; --samples) OPTION_SAMPLES=yes ;; --fast-copy) OPTION_FAST_COPY=yes ;; --minimal) OPTION_MINIMAL=yes ;; --package-dir=*) PACKAGE_DIR=$optarg ;; *) echo "unknown option '$opt', use --help" exit 1 esac done if [ $OPTION_HELP = "yes" ] ; then echo "Collect files from an Android NDK development tree and assemble" echo "the platform files appropriately into a final release structure." echo "" echo "options:" echo "" echo " --help Print this message" echo " --verbose Enable verbose messages" echo " --src-dir=<path> Source directory for development platform files [$SRCDIR]" echo " --dst-dir=<path> Destination directory [$DSTDIR]" echo " --ndk-dir=<path> Use toolchains from this NDK directory [$NDK_DIR]" echo " --platform=<list> List of API levels [$PLATFORMS]" echo " --arch=<list> List of CPU architectures [$ARCHS]" echo " --minimal Ignore samples, symlinks and generated shared libs." echo " --fast-copy Don't create symlinks, copy files instead" echo " --samples Also generate samples directories." echo " --package-dir=<path> Package platforms archive in specific path." echo "" echo "Use the --minimal flag if you want to generate minimal sysroot directories" echo "that will be used to generate prebuilt toolchains. Otherwise, the script" echo "will require these toolchains to be pre-installed and will use them to" echo "generate shell system shared libraries from the symbol list files." exit 0 fi if [ -n "$OPTION_SRCDIR" ] ; then SRCDIR="$OPTION_SRCDIR"; if [ ! -d "$SRCDIR" ] ; then echo "ERROR: Source directory $SRCDIR does not exist !" exit 1 fi if [ ! -d "$SRCDIR/platforms/android-3" ] ; then echo "ERROR: Invalid source directory: $SRCDIR" echo "Please make sure it contains platforms/android-3 etc..." exit 1 fi else SRCDIR=`dirname $ANDROID_NDK_ROOT`/development/ndk log "Using source directory: $SRCDIR" fi if [ -n "$OPTION_PLATFORM" ] ; then PLATFORMS=$(commas_to_spaces $OPTION_PLATFORM) else # Build the list from the content of SRCDIR PLATFORMS=`extract_platforms_from "$SRCDIR"` log "Using platforms: $PLATFORMS" fi # Remove the android- prefix of any platform name PLATFORMS=$(echo $PLATFORMS | tr ' ' '\n' | sed -e 's!^android-!!g' | tr '\n' ' ') if [ -n "$OPTION_DSTDIR" ] ; then DSTDIR="$OPTION_DSTDIR" else log "Using destination directory: $DSTDIR" fi # Handle architecture list # # We support both --arch and --abi for backwards compatibility reasons # --arch is the new hotness, --abi is deprecated. # if [ -n "$OPTION_ARCH" ]; then OPTION_ARCH=$(commas_to_spaces $OPTION_ARCH) fi if [ -n "$OPTION_ABI" ] ; then echo "WARNING: --abi=<names> is deprecated. Use --arch=<names> instead!" OPTION_ABI=$(commas_to_spaces $OPTION_ABI) if [ -n "$OPTION_ARCH" -a "$OPTION_ARCH" != "$OPTION_ABI" ]; then echo "ERROR: You can't use both --abi and --arch with different values!" exit 1 fi OPTION_ARCH=$OPTION_ABI fi if [ -n "$OPTION_ARCH" ] ; then ARCHS="$OPTION_ARCH" fi log "Using architectures: $(commas_to_spaces $ARCHS)" log "Checking source platforms." for PLATFORM in $PLATFORMS; do DIR="$SRCDIR/platforms/android-$PLATFORM" if [ ! -d $DIR ] ; then echo "ERROR: Directory missing: $DIR" echo "Please check your --platform=<list> option and try again." exit 2 else log " $DIR" fi done log "Checking source platform architectures." BAD_ARCHS= for ARCH in $ARCHS; do eval CHECK_$ARCH=no done for PLATFORM in $PLATFORMS; do for ARCH in $ARCHS; do DIR="$SRCDIR/platforms/android-$PLATFORM/arch-$ARCH" if [ -d $DIR ] ; then log " $DIR" eval CHECK_$ARCH=yes fi done done if [ "$OPTION_MINIMAL" ]; then OPTION_SAMPLES= OPTION_FAST_COPY=yes fi BAD_ARCHS= for ARCH in $ARCHS; do CHECK=`var_value CHECK_$ARCH` log " $ARCH check: $CHECK" if [ "$CHECK" = no ] ; then if [ -z "$BAD_ARCHS" ] ; then BAD_ARCHS=$ARCH else BAD_ARCHS="$BAD_ARCHS $ARCH" fi fi done if [ -n "$BAD_ARCHS" ] ; then echo "ERROR: Source directory doesn't support these ARCHs: $BAD_ARCHS" exit 3 fi # $1: source directory (relative to $SRCDIR) # $2: destination directory (relative to $DSTDIR) # $3: description of directory contents (e.g. "sysroot" or "samples") copy_src_directory () { local SDIR="$SRCDIR/$1" local DDIR="$DSTDIR/$2" if [ -d "$SDIR" ] ; then log "Copying $3 from \$SRC/$1 to \$DST/$2." mkdir -p "$DDIR" && (cd "$SDIR" && 2>/dev/null tar chf - *) | (tar xf - -C "$DDIR") if [ $? != 0 ] ; then echo "ERROR: Could not copy $3 directory $SDIR into $DDIR !" exit 5 fi fi } # $1: source dir # $2: destination dir # $3: reverse path # symlink_src_directory_inner () { local files file subdir rev mkdir -p "$DSTDIR/$2" rev=$3 files=$(cd $DSTDIR/$1 && ls -1p) for file in $files; do if [ "$file" = "${file%%/}" ]; then log "Link \$DST/$2/$file --> $rev/$1/$file" ln -s $rev/$1/$file $DSTDIR/$2/$file else file=${file%%/} symlink_src_directory_inner "$1/$file" "$2/$file" "$rev/.." fi done } # Create a symlink-copy of directory $1 into $2 # This function is recursive. # # $1: source directory (relative to $SRCDIR) # $2: destination directory (relative to $DSTDIR) symlink_src_directory () { symlink_src_directory_inner "$1" "$2" "$(reverse_path $1)" } # $1: Architecture name # $2+: List of symbols # out: Input list, without any libgcc symbol remove_libgcc_symbols () { local ARCH=$1 shift echo "$@" | tr ' ' '\n' | grep -v -F -f $PROGDIR/toolchain-symbols/$ARCH/libgcc.a.functions.txt } # $1: library name # $2: functions list # $3: variables list # $4: destination file # $5: toolchain binprefix gen_shell_lib () { # Now generate a small C source file that contains similarly-named stubs echo "/* Auto-generated file, do not edit */" > $TMPC local func var for func in $2; do echo "void $func(void) {}" >> $TMPC done for var in $3; do echo "int $var = 0;" >> $TMPC done # Build it with our cross-compiler. It will complain about conflicting # types for built-in functions, so just shut it up. $5-gcc -Wl,-shared,-Bsymbolic -nostdlib -o $TMPO $TMPC 1>/dev/null 2>&1 if [ $? != 0 ] ; then dump "ERROR: Can't generate shell library for: $1" dump "See the content of $TMPC for details." exit 1 fi # Copy to our destination now local libdir=$(dirname "$4") mkdir -p "$libdir" && cp -f $TMPO "$4" if [ $? != 0 ] ; then dump "ERROR: Can't copy shell library for: $1" dump "target location is: $4" exit 1 fi } # $1: Architecture # $2: symbol source directory (relative to $SRCDIR) # $3: destination directory for generated libs (relative to $DSTDIR) gen_shell_libraries () { local ARCH=$1 local SYMDIR="$SRCDIR/$2" local DSTDIR="$DSTDIR/$3" local TOOLCHAIN_PREFIX funcs vars numfuncs numvars # Let's locate the toolchain we're going to use local TOOLCHAIN_PREFIX="$NDK_DIR/$(get_default_toolchain_binprefix_for_arch $1)" TOOLCHAIN_PREFIX=${TOOLCHAIN_PREFIX%-} if [ ! -f "$TOOLCHAIN_PREFIX-readelf" ]; then dump "ERROR: $ARCH toolchain not installed: $TOOLCHAIN_PREFIX-gcc" dump "Important: Use the --minimal flag to use this script without generated system shared libraries." dump "This is generally useful when you want to generate the host cross-toolchain programs." exit 1 fi # In certain cases, the symbols directory doesn't exist, # e.g. on x86 for PLATFORM < 9 if [ ! -d "$SYMDIR" ]; then return fi # Let's list the libraries we're going to generate LIBS=$( (cd $SYMDIR && 2>/dev/null ls *.functions.txt) | sort -u | sed -e 's!\.functions\.txt$!!g') for LIB in $LIBS; do funcs=$(cat "$SYMDIR/$LIB.functions.txt") vars= if [ -f "$SYMDIR/$LIB.variables.txt" ]; then vars=$(cat "$SYMDIR/$LIB.variables.txt") fi funcs=$(remove_libgcc_symbols $ARCH $funcs) numfuncs=$(echo $funcs | wc -w) numvars=$(echo $vars | wc -w) log "Generating shell library for $LIB ($numfuncs functions + $numvars variables)" gen_shell_lib $LIB "$funcs" "$vars" "$DSTDIR/$LIB" "$TOOLCHAIN_PREFIX" done } # $1: platform number # $2: architecture # $3: target NDK directory generate_api_level () { local API=$1 local ARCH=$2 local HEADER="platforms/android-$API/arch-$ARCH/usr/include/android/api-level.h" log dump "Generating: $HEADER" cat > "$3/$HEADER" <<EOF /* * Copyright (C) 2008 The Android Open Source Project * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in * the documentation and/or other materials provided with the * distribution. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF * SUCH DAMAGE. */ #ifndef ANDROID_API_LEVEL_H #define ANDROID_API_LEVEL_H #define __ANDROID_API__ $API #endif /* ANDROID_API_LEVEL_H */ EOF } # Copy platform sysroot and samples into your destination # # $SRC/android-$PLATFORM/include --> $DST/platforms/android-$PLATFORM/arch-$ARCH/usr/include # $SRC/android-$PLATFORM/arch-$ARCH/include --> $DST/platforms/android-$PLATFORM/arch-$ARCH/usr/include # for compatibility: # $SRC/android-$PLATFORM/arch-$ARCH/usr/include --> $DST/platforms/android-$PLATFORM/arch-$ARCH/usr/include # $SRC/android-$PLATFORM/arch-$ARCH/usr --> $DST/platforms/android-$PLATFORM/arch-$ARCH/usr # $SRC/android-$PLATFORM/samples --> $DST/samples # rm -rf $DSTDIR/platforms && mkdir -p $DSTDIR/platforms PREV_PLATFORM_DST= for PLATFORM in $PLATFORMS; do NEW_PLATFORM=platforms/android-$PLATFORM PLATFORM_SRC=$NEW_PLATFORM PLATFORM_DST=$NEW_PLATFORM dump "Copying android-$PLATFORM platform files" if [ -n "$PREV_PLATFORM_DST" ] ; then if [ "$OPTION_FAST_COPY" ] ; then log "Copying \$DST/$PREV_PLATFORM_DST to \$DST/$PLATFORM_DST" #cp -r $DSTDIR/$PREV_PLATFORM_DST $DSTDIR/$PLATFORM_DST copy_directory "$DSTDIR/$PREV_PLATFORM_DST" "$DSTDIR/$PLATFORM_DST" else log "Symlink-copying \$DST/$PREV_PLATFORM_DST to \$DST/$PLATFORM_DST" symlink_src_directory $PREV_PLATFORM_DST $PLATFORM_DST fi if [ $? != 0 ] ; then echo "ERROR: Could not copy previous sysroot to $DSTDIR/$NEW_PLATFORM" exit 4 fi fi for ARCH in $ARCHS; do SYSROOT=arch-$ARCH/usr log "Copy $ARCH sysroot files from \$SRC/android-$PLATFORM over \$DST/android-$PLATFORM/arch-$ARCH" copy_src_directory $PLATFORM_SRC/include $PLATFORM_DST/$SYSROOT/include "sysroot headers" copy_src_directory $PLATFORM_SRC/arch-$ARCH/include $PLATFORM_DST/$SYSROOT/include "sysroot headers" copy_src_directory $PLATFORM_SRC/arch-$ARCH/lib $PLATFORM_DST/$SYSROOT/lib "sysroot libs" copy_src_directory $PLATFORM_SRC/$SYSROOT $PLATFORM_DST/$SYSROOT "sysroot" generate_api_level "$PLATFORM" "$ARCH" "$DSTDIR" if [ -z "$OPTION_MINIMAL" ]; then # Generate shell libraries from symbol files gen_shell_libraries $ARCH $PLATFORM_SRC/arch-$ARCH/symbols $PLATFORM_DST/$SYSROOT/lib fi done PREV_PLATFORM_DST=$PLATFORM_DST done if [ "$OPTION_SAMPLES" ] ; then # Copy platform samples and generic samples into your destination # # $SRC/samples/ --> $DST/samples/ # $SRC/android-$PLATFORM/samples/ --> $DST/samples # dump "Copying generic samples" rm -rf $DSTDIR/samples && mkdir -p $DSTDIR/samples copy_src_directory samples samples samples for PLATFORM in $PLATFORMS; do dump "Copy android-$PLATFORM samples" # $SRC/platform-$PLATFORM/samples --> $DST/samples copy_src_directory platforms/android-$PLATFORM/samples samples samples done # Cleanup generated files in samples rm -rf "$DSTDIR/samples/*/obj" rm -rf "$DSTDIR/samples/*/libs" fi if [ "$PACKAGE_DIR" ]; then mkdir -p "$PACKAGE_DIR" fail_panic "Could not create package directory: $PACKAGE_DIR" ARCHIVE=platforms.tar.bz2 dump "Packaging $ARCHIVE" pack_archive "$PACKAGE_DIR/$ARCHIVE" "$DSTDIR" "platforms" fail_panic "Could not package platforms" if [ "$OPTION_SAMPLES" ]; then ARCHIVE=samples.tar.bz2 dump "Packaging $ARCHIVE" pack_archive "$PACKAGE_DIR/$ARCHIVE" "$DSTDIR" "samples" fail_panic "Could not package samples" fi fi log "Done !"