Android OTA 升级之二：脚本 ota_from_target_files

 它调用 main 函数：

 844 def main(argv):845 846 def option_handler(o, a):847 if o in ("-b", "--board_config"):848 pass # deprecated849 elif o in ("-k", "--package_key"):850 OPTIONS.package_key = a851 elif o in ("-i", "--incremental_from"):852 OPTIONS.incremental_source = a853 elif o in ("-w", "--wipe_user_data"):854 OPTIONS.wipe_user_data = True855 elif o in ("-n", "--no_prereq"):856 OPTIONS.omit_prereq = True857 elif o in ("-e", "--extra_script"):858 OPTIONS.extra_script = a859 elif o in ("-m", "--script_mode"):860 OPTIONS.script_mode = a861 elif o in ("--worker_threads"):862 OPTIONS.worker_threads = int(a)863 else:864 return False865 return True866 867 args = common.ParseOptions(argv, __doc__,868 extra_opts="b:k:i:d:wne:m:",869 extra_long_opts=["board_config=",870 "package_key=",871 "incremental_from=",872 "wipe_user_data",873 "no_prereq",874 "extra_script=",875 "script_mode=",876 "worker_threads="],877 extra_option_handler=option_handler)878 879 if len(args) != 2:880 common.Usage(__doc__)881 sys.exit(1)  

将用户设定的 Option 存入 OPTIONS 变量中。它是一个Python Class, 我们将其理解为一个C Struct 即可。

 Script_mode 只能是amend/edify/auto之一， auto 目前是选择两者都支持。

可以理解是为了向前兼容,(早期 Android 使用 amend)

 读入 额外脚本的内容。（如果有）

 解开输入包。

892   if OPTIONS.device_specific is None:893     # look for the device-specific tools extension location in the input894     try:895       f = open(os.path.join(OPTIONS.input_tmp, "META", "tool-extensions.txt"))896       ds = f.read().strip()897       f.close()898       if ds:899         ds = os.path.normpath(ds)900         print "using device-specific extensions in", ds901         OPTIONS.device_specific = ds902     except IOError, e:903       if e.errno == errno.ENOENT:904         # nothing specified in the file905         pass906       else:907         raise  

处理 device-specific extensions， 没用到。

 读入设定image大小的参数，没用到。

 设定输出文件，如果要签名（our case）,则还需要一个临时输出文件。

 根据参数，调用增量和非增量创建 ZIP 创建函数，我们采用非增量模式。

 签名（如果需要的话），处理完毕。

下面我们看主要功能函数：WriteFullOTAPackage。

主功能：WriteFullOTAPackage

 首先，我们获得脚本生成器，他们的实现见脚本：edify_generator.py 等。

 获得一些环境变量，来自android 环境变量。 Google 一下即知其义。

 设备相关参数，不深究。

 如果需要，在脚本中增加一个Assert语句，要求update zip包只能用于升级老的系统。

 如果需要，在脚本中增加一个Assert语句，要求update zip包只能用于同一设备，即目标设备的 ro.product.device 必须跟update.zip中的相同。

 Callback, 用于调用设备相关代码。调用时机为即将开始升级。类似还有：

FullOTA_InstallEnd IncrementalOTA_Assertions IncrementalOTA_VerifyEnd。 不深究。

 在升级脚本中加入显示进度的语句， 参数一表示底下的操作（到下一条同类语句或者到末尾）将暂用的时间在总体时间的比例。参数二用于控制显示的速度。比如，50 则表示底下的操作估计50秒内完成，要求进度条显示线程用50秒显示这一部分的进度。0 表示不自动更新，手动控制（使用SetProgress)

 如果需要，在脚本中增加语句，擦除 userdata 分区。

 在脚本中增加语句，擦除 system分区。

 在脚本中增加语句，安装 system分区到 /system 目录。

在脚本中增加语句，将recovery以及system中的内容拷贝到 /system目录。其中recovery 目录包含一个patch 以及应用该patch 的脚本。

 386 行从输入 ZIP 包 /system 拷贝文件到输出 ZIP 包 /system。由于这个过程不支持链接文件，所以它将这些文件返回。 于 387 行做继续处理。该行建立这些link 文件。所有的link文件都指向 toolbox

 这个复杂，MakeRecoveryPatch 做了两件事:

1.在输出 ZIP包中生成一个patch: recovery/recovery-from-boot.p(boot.img和 recovery.img的patch), 它最后会位于：system/recovery-from-boot.p

2.在输出 ZIP包中生成一个脚本：recovery/etc/install-recovery.sh , 它最后会位于system/etc/install-recovery.sh.

该脚本的内容为：

#!/system/bin/sh

if ! applypatch -c MTD:recovery:2048:6a167ffb86a4a16cb993473ce0726a3067163fc1; then

  log -t recovery "Installing new recovery image"

  applypatch MTD:boot:2324480:9a72a20a9c2f958ba586a840ed773cf8f5244183 MTD:recovery f6c2a70c5f2b02b6a49c9f5c5507a45a42e2d389 2564096 9a72a20a9c2f958ba586a840ed773cf8f5244183:/system/recovery-from-boot.p

else

  log -t recovery "Recovery image already installed"

fi

 从 META/filesystem_config.txt 中获得 system 目录下的各文件权限信息。 

 在脚本中增加语句，设置 system 目录下文件的权限及属主等。

 检查 boot.img 文件大小是否超标.

 将boot.img 放到输出 ZIP 包中。

 更行进度条。

 在脚本中增加语句，将 boot.img 写到 boot 分区。

 更行进度条。

 Callback, 同前。

 如果有额外脚本，加入。

 在脚本中增加语句，umount 所有分区。

 1）将前面生成的脚本输出到：META-INF/com/google/android/updater-script （对于edify）

 assert(getprop("ro.product.device") == "thedevicename" ||       getprop("ro.build.product") == "theproductname");show_progress(0.500000, 0);format("MTD", "system");mount("MTD", "system", "/system");package_extract_dir("recovery", "/system");package_extract_dir("system", "/system");symlink("dumpstate", "/system/bin/dumpcrash");symlink("toolbox", "/system/bin/cat", "/system/bin/chmod",        "/system/bin/chown", "/system/bin/cmp", "/system/bin/date",        "/system/bin/dd", "/system/bin/df", "/system/bin/dmesg",        "/system/bin/fb2bmp", "/system/bin/getevent", "/system/bin/getprop",        "/system/bin/hd", "/system/bin/id", "/system/bin/ifconfig",        "/system/bin/iftop", "/system/bin/insmod", "/system/bin/ioctl",        "/system/bin/kill", "/system/bin/ln", "/system/bin/log",        "/system/bin/ls", "/system/bin/lsmod", "/system/bin/mkdir",        "/system/bin/mount", "/system/bin/mv", "/system/bin/netstat",        "/system/bin/newfs_msdos", "/system/bin/notify", "/system/bin/printenv",        "/system/bin/ps", "/system/bin/reboot", "/system/bin/renice",        "/system/bin/rm", "/system/bin/rmdir", "/system/bin/rmmod",        "/system/bin/route", "/system/bin/schedtop", "/system/bin/sendevent",        "/system/bin/setconsole", "/system/bin/setprop", "/system/bin/sleep",        "/system/bin/smd", "/system/bin/start", "/system/bin/stop",        "/system/bin/sync", "/system/bin/top", "/system/bin/umount",        "/system/bin/vmstat", "/system/bin/watchprops",        "/system/bin/wipe");set_perm_recursive(0, 0, 0755, 0644, "/system");set_perm_recursive(0, 2000, 0755, 0755, "/system/bin");set_perm(0, 3003, 02755, "/system/bin/netcfg");set_perm(0, 3004, 02755, "/system/bin/ping");set_perm_recursive(1002, 1002, 0755, 0440, "/system/etc/bluez");set_perm(0, 0, 0755, "/system/etc/bluez");set_perm(1002, 1002, 0440, "/system/etc/dbus.conf");set_perm(1014, 2000, 0550, "/system/etc/dhcpcd/dhcpcd-run-hooks");set_perm(0, 2000, 0550, "/system/etc/init.goldfish.sh");set_perm(0, 0, 0544, "/system/etc/install-recovery.sh");set_perm_recursive(0, 0, 0755, 0555, "/system/etc/ppp");set_perm_recursive(0, 2000, 0755, 0755, "/system/xbin");show_progress(0.200000, 0);show_progress(0.200000, 10);assert(package_extract_file("boot.img", "/tmp/boot.img"),       write_raw_image("/tmp/boot.img", "boot"),       delete("/tmp/boot.img"));show_progress(0.100000, 0);unmount("/system");  

2）将升级程序：OTA/bin/updater 从输入ZIP包中拷贝到输出ZIP包中的：META-INF/com/google/android/update-binary

将前面获取的metadata 写入输出包的文件中： META-INF/com/android/metadata

至此，我们就得到了一个update.zip包。可以开始升级了。

思考

1） 虽然提供了更新recovery分区的机制，但是没有看到触发该更新的语句。所以，缺省的情况是不会更新recovery分区的。大概是为了安全的原因吧。 但是，有时确实需要更新recovery 分区（比如，设备的硬件配置、分区表等发生改变），这该如何操作呢？