s5pv210開發板上android編譯指令碼分析–[基於x210開發板]

mk指令碼分析
源碼及注釋如下：

#!/bin/sh
#
# Description : Build Android Script.
# Authors : jianjun jiang - jerryjianjun@gmail.com
# Version : 0.01
# Notes : None
#

export ANDROID_JAVA_HOME=/usr/lib/jvm/java-6-sun/
#java編譯環境聲明，如果按照前面的步驟手動安裝了jdk1.6並聲明了環境變數，則該句可省略
SOURCE_DIR=$(cd `dirname $0` ; pwd) #通過指令碼指令尋找目前的目錄，事實上使用./mk執行指令碼，會有警告提示，直接用SOURCE_DIR=$(pwd)即可

TOOLS_DIR=${SOURCE_DIR}/tools/ ＃tools目錄
RELEASE_DIR=${SOURCE_DIR}/out/release/ #最終產生的映像檔案的釋放目錄
TARGET_DIR=${SOURCE_DIR}/out/target/product/smdkv210/
#映像檔案的目標目錄
BOOTLOADER_UBOOT_CONFIG=smdkv210single_config
#uboot配置指令碼
BOOTLOADER_XBOOT_CONFIG=arm-mpad #xboot配置指令碼
ANDROID_KERNEL_CONFIG=s5pv210_android_defconfig
#android核心配置指令碼
INITRD_KERNEL_CONFIG=s5pv210_initrd_defconfig
#linux核心配置指令碼
FILESYSTEM_CONFIG=PRODUCT-full_smdkv210-eng
#指定目標工程名稱

setup_environment() #設定環境變數函數，在android源碼目錄建立映像釋放目錄和映像的目標目錄
{
cd ${SOURCE_DIR};
mkdir -p ${RELEASE_DIR} || return 1;
mkdir -p ${TARGET_DIR} || return 1;
}

build_bootloader_uboot() #編譯uboot，我們使用xboot，不使用uboot
{
cd ${SOURCE_DIR}/uboot || return 1
make distclean || return 1;
make ${BOOTLOADER_UBOOT_CONFIG} || return 1;
make

./mkmovi
./mkheader bootstrap.bin
./mkheader u-boot.bin
cp -v ${SOURCE_DIR}/uboot/bootstrap.bin ${RELEASE_DIR} 
cp -v ${SOURCE_DIR}/uboot/u-boot.bin ${RELEASE_DIR}

echo "" >&2
echo "^_^ uboot path: ${RELEASE_DIR}/bootstrap.bin" >&2
echo "^_^ uboot path: ${RELEASE_DIR}/u-boot.bin" >&2
return 0
}

build_bootloader_xboot() ＃編譯xboot
{
if [ ! -f ${RELEASE_DIR}/zImage-initrd ]; then
#xboot將linux核心打包了，故必須存在linux核心檔案
echo "not found kernel zImage-initrd, please build kernel first" >&2
return 1
fi

if [ ! -f ${RELEASE_DIR}/zImage-android ]; then
#xboot將android核心打包了，故必須存在android核心檔案
echo "not found kernel zImage-android, please build kernel first" >&2
return 1
fi

# copy zImage-initrd and zImage-android to xboot's romdisk directory
cp -v ${RELEASE_DIR}/zImage-initrd ${SOURCE_DIR}/xboot/src/arch/arm/mach-mpad/romdisk/boot || return 1;
cp -v ${RELEASE_DIR}/zImage-android ${SOURCE_DIR}/xboot/src/arch/arm/mach-mpad/romdisk/boot || return 1;

# compiler xboot
cd ${SOURCE_DIR}/xboot || return 1
make TARGET=${BOOTLOADER_XBOOT_CONFIG} CROSS=/usr/local/arm/arm-none-eabi-2010-09-51/bin/arm-none-eabi- clean || return 1;
make TARGET=${BOOTLOADER_XBOOT_CONFIG} CROSS=/usr/local/arm/arm-none-eabi-2010-09-51/bin/arm-none-eabi- || return 1;

# rm zImage-initrd and zImage-android
rm -fr ${SOURCE_DIR}/xboot/src/arch/arm/mach-mpad/romdisk/boot/zImage-initrd
rm -fr ${SOURCE_DIR}/xboot/src/arch/arm/mach-mpad/romdisk/boot/zImage-android

# copy xboot.bin to release directory
cp -v ${SOURCE_DIR}/xboot/output/xboot.bin ${RELEASE_DIR}

echo "" >&2
echo "^_^ xboot path: ${RELEASE_DIR}/xboot.bin" >&2
return 0
}

build_kernel() ＃編譯核心
{
cd ${SOURCE_DIR}/kernel || return 1

make ${INITRD_KERNEL_CONFIG} || return 1
＃編譯linux核心
make -j${threads} || return 1
#編譯完後將映像zImage重新命名為zImage-initrd
dd if=${SOURCE_DIR}/kernel/arch/arm/boot/zImage of=${RELEASE_DIR}/zImage-initrd bs=2048 count=8192 conv=sync;

make ${ANDROID_KERNEL_CONFIG} || return 1
#編譯android核心
make -j${threads} || return 1
#編譯完後將映像zImage重新命名為zImage-android
dd if=${SOURCE_DIR}/kernel/arch/arm/boot/zImage of=${RELEASE_DIR}/zImage-android bs=2048 count=8192 conv=sync;

echo "" >&2
echo "^_^ initrd kernel path: ${RELEASE_DIR}/zImage-initrd" >&2
echo "^_^ android kernel path: ${RELEASE_DIR}/zImage-android" >&2

return 0
}

build_system() #編譯android檔案系統
{
cd ${SOURCE_DIR} || return 1
make -j${threads} ${FILESYSTEM_CONFIG} || return 1

# create android.img.cpio
rm -fr ${TARGET_DIR}/cpio_list ${TARGET_DIR}/android.img.cpio || { return 1; }
$TOOLS_DIR/gen_initramfs_list.sh ${TARGET_DIR}/root > ${TARGET_DIR}/cpio_list || { return 1; }
$TOOLS_DIR/gen_init_cpio ${TARGET_DIR}/cpio_list > ${TARGET_DIR}/android.img.cpio || { return 1; }

# create data.tar
cd ${TARGET_DIR}/data || { echo "Error: Could not enter the ${TARGET_DIR}/data directory."; return 1; }
rm -fr ${TARGET_DIR}/data.tar || { return 1; }
tar cvf ${TARGET_DIR}/data.tar ./* || { return 1; }
#將data目錄下產生的所有檔案打包 ***/

# create system.tar
cd ${TARGET_DIR}/system || { echo "Error: Could not enter the ${TARGET_DIR}/system directory."; return 1; }
rm -fr ${TARGET_DIR}/system.tar || { return 1; }
tar cvf ${TARGET_DIR}/system.tar ./* || { return 1; }
#將system目錄下產生的所有檔案打包 ***/

cp -av ${TARGET_DIR}/installed-files.txt ${RELEASE_DIR}/ || return 1;
cp -av ${TARGET_DIR}/installed-files.txt ${RELEASE_DIR}/ || return 1;
cp -av ${TARGET_DIR}/android.img.cpio ${RELEASE_DIR}/ || return 1;
cp -av ${TARGET_DIR}/system.img ${RELEASE_DIR}/ || return 1;
cp -av ${TARGET_DIR}/system.tar ${RELEASE_DIR}/ || return 1;
cp -av ${TARGET_DIR}/userdata.img ${RELEASE_DIR}/ || return 1;
cp -av ${TARGET_DIR}/data.tar ${RELEASE_DIR}/ || return 1;

echo "" >&2
echo "^_^ system path: ${RELEASE_DIR}/system.tar" >&2
return 0
}

gen_update_bin() #使用genromfs工具將產生的映像檔案打包成update.bin
{
# check image files
if [ ! -f ${RELEASE_DIR}/xboot.bin ]; then
#update.bin包含xboot.bin
echo "not found bootloader xboot.bin, please build bootloader" >&2
return 1
fi

if [ ! -f ${RELEASE_DIR}/zImage-initrd ]; then
#update.bin包含zImage-initrd
echo "not found kernel zImage-initrd, please build kernel first" >&2
return 1
fi

if [ ! -f ${RELEASE_DIR}/zImage-android ]; then
#update.bin包含zImage-android
echo "not found kernel zImage-android, please build kernel first" >&2
return 1
fi

if [ ! -f ${RELEASE_DIR}/system.tar ]; then
#update.bin包含system.tar
echo "not found system.tar, please build system" >&2
return 1
fi

if [ ! -f ${RELEASE_DIR}/data.tar ]; then
#update.bin包含data.tar
echo "not found data.tar, please build system" >&2
return 1
fi

rm -fr ${RELEASE_DIR}/tmp || return 1;
rm -fr ${RELEASE_DIR}/update.bin || return 1;
mkdir -p ${RELEASE_DIR}/tmp || return 1;

# copy image files
cp ${RELEASE_DIR}/xboot.bin ${RELEASE_DIR}/tmp/;
cp ${RELEASE_DIR}/zImage-initrd ${RELEASE_DIR}/tmp/;
cp ${RELEASE_DIR}/zImage-android ${RELEASE_DIR}/tmp/;
cp ${RELEASE_DIR}/system.tar ${RELEASE_DIR}/tmp/;
cp ${RELEASE_DIR}/data.tar ${RELEASE_DIR}/tmp/;

# create md5sum.txt
cd ${RELEASE_DIR}/tmp/;
find . -type f -print | while read line; do
if [ $line != 0 ]; then
md5sum ${line} >> md5sum.txt
fi
done

# genromfs
#使用genromfs工具打包
genromfs -v -d ${RELEASE_DIR}/tmp/ -f ${RELEASE_DIR}/update.bin || return 1;

cd ${SOURCE_DIR} || return 1 
rm -fr ${RELEASE_DIR}/tmp || return 1;
return 0;
}

threads=4; #預設使用4核編譯，如果需要使用單核編譯，執行指令碼時添加-j1
uboot=no; #預設都不編譯
xboot=no;
kernel=no;
system=no;
update=no;

if [ -z $1 ]; then #如果執行指令碼時不帶參數，則全部編譯
uboot=yes
xboot=yes
kernel=yes
system=yes
update=yes
fi

while [ "$1" ]; do #通過while迴圈檢測要編譯的映像檔案
    case "$1" in
-j=*) #使用幾核編譯
x=$1
threads=${x#-j=}
;;
-u|--uboot)
#編譯uboot
uboot=yes
   ;;
-x|--xboot)
#編譯xboot
xboot=yes
   ;;
-k|--kernel)
#編譯kernel
   kernel=yes
   ;;
-s|--system)
#編譯android system
system=yes
   ;;
-U|--update)
#打包所有映像
update=yes
   ;;
-a|--all)
#編譯所有檔案
uboot=yes
xboot=yes
kernel=yes
system=yes
update=yes
   ;;
-h|--help)
#協助資訊
   cat >&2 <<EOF
Usage: ./mk [OPTION]
Build script for compile the source of telechips project.

  -j=n                 using n threads when building source project (example: -j=16)
  -u, --uboot          build bootloader uboot from source file
  -x, --xboot          build bootloader xboot from source file
  -k, --kernel         build kernel from source file and using default config file
  -s, --system         build file system from source file
  -U, --update         gen update package update.bin
  -a, --all            build all, include anything
  -h, --help           display this help and exit
EOF
   exit 0
   ;;
*)
   echo "build.sh: Unrecognised option $1" >&2
   exit 1
   ;;
    esac #case語句結束標誌，注意正好是case反過來
    shift #通過shift來平移執行指令碼時輸入的參數
done

setup_environment || exit 1 #指令碼的第一條執行指令，設定編譯環境變數

if [ "${kernel}" = yes ]; then #編譯核心
build_kernel || exit 1
fi

if [ "${system}" = yes ]; then #編譯android系統
build_system || exit 1
fi

if [ "${uboot}" = yes ]; then #編譯uboot
build_bootloader_uboot || exit 1
fi

if [ "${xboot}" = yes ]; then #編譯xboot
build_bootloader_xboot || exit 1
fi

if [ "${update}" = yes ]; then ＃打包映像檔案
gen_update_bin || exit 1
fi

exit 0 #退出指令檔