#!/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 !"