OTA更新包内部

系统从bootable/recovery/updater中构建updater二进制程序,并且在OTA更新包里面使用他.

更新包本身是一个.zip压缩包文件(ota_update.zip,incremental_ota_update.zip),压缩包内包含可执行二进制程序 META-INF/com.google/android/update-binary .

Updater包含几个内置函数和用于可扩展脚本语言(edify)的解释器,可扩展脚本语言支持与更新任务相关的命令.Updater从.zip中的 META-INF/com/google/android/updater-script查找脚本.

注意:使用edify脚本和内置的函数不是命令,但是如果你需要调试这个更新文件的话是非常有用的

Edify语法

一个edify脚本是一个单一的语句,在脚本中,所有的值都是字符串.空字符串在一个Boolean上下文中是false,其他所有的字符串都是true.Edify支持下面的操作(都是通常的含义)

(expr )
 expr + expr  # string concatenation, not integer addition
 expr == expr
 expr != expr
 expr && expr
 expr || expr
 ! expr
 if expr then expr endif
 if expr then expr else expr endif
 function_name(expr, expr,...)
 expr; expr

任何由a-z,A-Z,0-9,_,:,/,.这些字符组成的,凡不是保留字的,都看作是字符串.(保留字是if else then endif).字符串使用双引号因起来,下面是如何创建空格和其他不在上面集合中的自负值.\n,\t,\”,和\为转义字符.

&&和||操作符是和我们平时编程的时候一样的,下面两个是等价的:

e1 && e2
if e1 then e2 endif

;操作符号是一个序列点;他的意思是,首先分析左边的表达式,然后分析右边的表达式.他的值是右边表达式的值.分号也用于一个表达式的后面,像是C语言风格的模拟.

prepare();
do_other_thing("argument");
finish_up();

内置函数

大多数更新功能都被包含在可用的函数中被脚本执行.(在Lisp意义上,严格的说这些是宏而不是函数,他们需要分析所有的参数).除非另有说明,函数返回true表示执行成功,返回false表示执行出错.如果你想在出错的时候停止脚本的执行,使用abort()或者是asset()函数.在updater中可用的函数集合也可以被扩展提供设备特定功能(后面会讲到).

  • abort([msg])
    立即结束脚本的执行,带有可选信息.如果用户已经切换到文本显示,msg会出现在recovery log中和屏幕上.

  • assert(expr[, expr, ...])
    依次分析每一个expr.如果任何一个是false,立即终止脚本的执行,并且显示信息”assert failed”和错误语句的源文本.

    -apply_patch(src_file, tgt_file, tgt_sha1, tgt_size, patch1_sha1, patch1_blob, [...])
    将一个二进制补丁应用到src_file中来生成tgt_file.如果期望的目标和源码是一样的,向tgt_file传递”-“.tgt_sha1和tgt_size是期望的最终的SHA1哈希和目标文件的大小.剩下的参数必须是成对出现的:一个SHA1哈希(40位字符的16进制字符串)和一个块.当源码当前的内容已经有了SHA1,块就是要被应用的补丁.

    打补丁以一个安全的方式完成了,这保证了目标文件拥有期望的SHA1哈希和大小,或者是他是不变的.如果打包过程被中断,目标文件可能会在一个中间状态;位于cache分区的一个复制品,所以重启更新就能成功更新那个文件.

    把存储技术设备(MTD)分区当作文件的特殊语法也是支持的,允许对raw分区的打包,例如boot.为了读取一个MTD分区,既然该分区没有文件末尾的概念,你一定要知道你想要读取多少数据.你一定要使用字符串”MTD:partition:size_1:sha1_1:size_2: sha1_2”作为文件名称来读取给定的分区.你至少指定一个(size,sha-1)对;如果有多个可能性,但是对你想要读取的内容至少指定一个.

  • apply_patch_check(filename, sha1[, sha1, ...])
    如果文件名称或者是在cache分区中的临时复制品有一个和给定的sha1值相同的SHA1的话,就会返回true.sha1值被指定为40位的16进制数字.这个函数和sha1_check(read_file(filename), sha1 [, …]) 不同的是,他知道去检查cache分区中的copy,所以,apply_patch_check()将会成功即使文件被一个中断的apply_patch() 更新损坏了.

  • apply_patch_space(bytes)
    如果至少暂存空间对应用的二进制补丁可用的话返回true

  • concat(expr[, expr, ...])
    分析每一个语句并且连接他们.+操作在两个参数的特殊情况下是这个函数的语法糖(但是该函数能够接受任意数量的语句).语句必须是字符串,他不能连接块.

  • delete([filename, ...])
    删除列出文件名的所有.返回成功删除的文件的数量.

  • delete_recursive([dirname, ...])
    递归删除dirnames和其所有的内容.返回成功删除的目录的个数.

  • file_getprop(filename, key)
    读取给定的文件名的文件,作为属性文件解释(例如,/system/build.prop),返回给定的key的值,或者是如果key不存在,返回空字符串.

  • format(fs_type, partition_type, location, fs_size, mount_point)
    重新格式化给定的分区.支持的分区类型:

    • fs_type = “yaffs2”并且partition_type=”MTD”.位置必须是MTD分区的名称;一个空的yaffs2文件系统在那里被构建.其他的参数就不用了.

    • fs_type=”ext4”并且partition_type=”EMMC”.位置一定是分区的设备文件.一个空的ext4文件系统在那里被构建.如果fs_size为0,文件系统采用整个分区.如果fs_size为一个正数,文件系统采用分区的fs_size大小位.如果fs_size是一个负数,文件系统采用除了|fs_size|大小的区域.

    • fs_type=”f2fs”并且partition_type=”EMMC”.位置一定要是分区设备文件.fs_size必须是非负数.如果fs_size为0,文件系统采用整个分区.如果fs_size为正数,文件系统采用这些大小位的分区.
      mount_point(挂载点)一定要是后来文件系统挂载的点.

  • getprop(key)
    返回系统属性key的值(如果没有定义,返回空字符串).被recovery分区定义的系统属性值不必和主系统定义的一样.这个函数在recovery模式中返回值.

  • greater_than_int(a, b)
    如果a比b大的话,返回true

  • ifelse(cond, e1[, e2])
    分析条件,如果条件为真,返回e1的值,如果条件为假,返回e2的值(如果存在的话).”if…else..then..endif”是该函数的一个语法糖.

  • is_mounted(mount_point)
    如果文件系统在挂载点被挂载了返回true

  • is_substring(needle, haystack)
    如果needle是haystack的子串的话返回true

  • less_than_int(a, b)
    如果a小于b的话返回true

  • mount(fs_type, partition_type, name, mount_point)
    挂载fs_type在mount_point的文件系统.partition_type一定是下面的一个:

    • MTD:名称是MTD分区的名称(例如,system,userdata;查看设备上的/proc/mtd获取完整的列表).

    • EMMC:Recovery默认情况下不会挂载任何文件系统(如果用户从SD卡中手动安装更新的话,SD开需要挂载);你的脚本必须挂载你需要修改的分区.

  • package_extract_dir(package_dir, dest_dir)
    从package_dir下提取所有的文件,并且将他们写到相应的dest_dir下面.任何存在的文件都要被重写.

  • package_extract_file(package_file[, dest_file])
    从更新包中提取一个单一的package_file,并且将他们写入到dest_file中,如果必要的话,重写存在的文件.如果没有dest_dir参数的话,将包文件的内容作为二进制块返回.

  • read_file(filename)
    读取文件并且返回他的内容作为一个二进制块.

  • rename(src_filename, tgt_filename)
    重命名src_filename为tgt_filename.他自动为tgt_filename创建一个必要的目录.例如:
    rename("system/app/Hangouts/Hangouts.apk", "system/priv-app/Hangouts/Hangouts.apk").

  • run_program(path[, arg, ...])
    在path中,通过传递args执行二进制程序.返回程序的退出状态.

  • set_metadata(filename, key1, value1[, key2 , value2, ...])
    给给定的文件名称的键赋值.举个例子:

    set_metadata("/system/bin/netcfg", "uid", 0, "gid", 3003, "mode", 02750, "selabel", "u:object_r:system_file:s0", "capabilities", 0x0).

  • set_metadata_recursive(dirname, key1, value1[, key2, value2, ...])
    递归设置给定目录和他的子文件的键和值.举个例子:

    set_metadata_recursive("/system", "uid", 0, "gid", 0, "fmode", 0644, "dmode", 0755, "selabel", "u:object_r:system_file:s0", "capabilities", 0x0)

  • set_progress(frac)
    在由show_progress()调用创建的块中设置进度条的位置.frac必须在[0.0,1.0]区间内.进度条不会后退.尝试这样的做法被忽略了.

  • sha1_check(blob[, sha1])
    blob参数是有read_file()返回的类型的块或者是package_extract_file()的一个参数形式.如果没有sha1参数,该函数返回块的SHA1哈希.如果存在一个或多个sha1参数,如果SHA1和一个参数相等的话,返回SHA1哈希,如果没有相等的,则返回空字符串.

  • show_progress(frac, secs)
    推进进度条在sec秒中到达frac长度.secs可能为0,在这种情况下,进度条不会被自动推进.

  • sleep(secs)
    睡眠secs秒(必须是整数)

  • stdout(expr[, expr, ...])
    分析每一个表达式并且将他的值转储到stdout.在调试的时候有用.

  • symlink(target[, source, ...])
    创建所有源码为链接到目标中.

  • tune2fs(device[, arg, …])
    在设备上调整可调参数args

  • ui_print([text, ...])
    连接所有的文本参数并且将结果打印到UI中(如果用户转换到文本显示的话结果就是可视的)

  • unmount(mount_point)
    卸载在挂载点挂载的文件系统

  • wipe_block_device(block_dev, len)
    清楚给定块设备block_dev的len位的数据.

  • wipe_cache()
    在成功安装之后,清空cache分区

  • write_raw_image(filename_or_blob, partition)
    在filename_or_blob中把镜像写入到MTD分区中. filename_or_blob可以是一个字符串名称是本地文件或者是一个包含数据的块值参数.为了能够从OTA包中复制一个文件到分区中,使用:

    write_raw_image(package_extract_file("zip_filename"), "partition_name")

    注意:之前Android 4.1,仅仅接收文件名称,所以,为了能够完成这个工作,数据需要首先去解压缩到一个临时本地文件中.

你可能感兴趣的:(内置函数,updater,OTA)