android updater-script解析

从网上查到了一个英文文档：

http://www.freeyourandroid.com/guide/introdution_to_edify

结合自己的测试，在此记录下脚本执行函数的大概使用方法。

1 ，我自己的updater-script脚本，格式化kernel fs userdata分区

format("yaffs2","MTD", "kernel");
package_extract_file("uImage", "/tmp/uImage");
write_raw_image("/tmp/uImage", "kernel");
show_progress(0.05,5);
format("yaffs2","MTD", "fs");
mount("yaffs2","MTD", "fs", "/wuxyfs");
show_progress(0.8,20);
package_extract_dir("fs", "/wuxyfs");
unmount(/wuxyfs);
show_progress(1.0,8);
format("yaffs2","MTD", "userdata");
mount("yaffs2","MTD", "userdata", "/wuxydata");
package_extract_dir("data", "/wuxydata");
ui_print("update system...");
ui_print("update test just mount........ok.");

2 下面介绍下基本函数的使用方法

函数名称: mount

函数语法: mount(fs_type, partition_type, location, mount_point)

参数详解: fs_type-----------------"yaffs2" 或 "ext4"

partition_type----------"MTD" 或 "EMMC"

location-----------------分区(partition) 或 驱动器(device)

mount_poin------------挂载文件系统的目标文件夹(target folder to mount FS)

作用解释: 挂载一个文件系统到指定的挂载点，挂载点不存在会自动创建。

返回值: 挂载成功则返回挂载点，失败返回null

函数示例: mount("MTD", "system", "/system");挂载system分区，设置返回指针"/system”

mount("vfat", "/dev/block/mmcblk1p2", "/system"); 挂载/dev/block/mmcblk1p2，返回指针"/system”

函数名称: is_mounted

函数语法: is_mounted(mount_point)

参数详解: mount_point-----------字符串，检查是否已经挂载的挂载点

作用解释: 检查文件系统是否挂载

返回值: 挂载成功则返回挂载点，失败返回null

函数示例:

函数名称: unmount

函数语法: unmount(mount_point)

参数详解: mount_point-----------字符串，要解除挂载的挂载点

作用解释: 解除文件系统挂载

返回值: 解除挂载成功则返回挂载点，失败返回null

函数示例: unmount("/system"); 卸载/system分区

函数名称: format

函数语法: format(fs_type, partition_type, location)

参数详解: fs_type-----------------字符串，数据为"yaffs2" 或 "ext4"

partition_type----------字符串, "MTD" 或 "EMMC"

location-----------------字符串, 分区(partition) 或 驱动器(device)

作用解释: 格式化为指定的文件系统

函数示例: format("MTD", "system");格式化system分区

函数名称: delete

函数语法: delete(file1, file2, ..., fileN)

参数详解: 字符串，要删除的文件

作用解释: 删除一个文件。最少指定一个文件；多个文件可以做为多个参数指定

函数示例: delete("/data/zipalign.log");删除文件/data/zipalign.log

函数名称: delete_recursive

函数语法: delete_recursive(dir1, dir2,...,dirN)

参数详解: 字符串，要递归删除的目录

作用解释: 删除文件夹及其包含的所有内容。最少指定1个目录；多个目录可以做为多个参数指定

函数示例: delete_recursive("/data/dalvik-cache");删除文件夹/data/dalvik-cache

函数名称: show_progress

函数语法: show_progress(frac, sec)

参数详解: frac----------------------进度完成数值

Sec----------------------总秒数

作用解释: 显示在Recovery系统中进度

函数示例: show_progress(0.1, 10);show_progress下面的操作可能进行10s，完成后进度条前进0.1(也就是10%)

函数名称: set_progress

函数语法: set_prograss(frac)

参数详解: frac---------------------进度数值

函数示例:

函数名称: package_extract_dir

函数语法: package_extract_dir(package_path, destination_path)

参数详解: package_path----------字符串，升级包内要提取的目录

destination_path--------字符串，提取文件的目标目录

作用解释: 提取升级包内目录中的所有文件到指定的目标目录

函数示例: package_extract_dir("system", "/system");释放ROM包里system文件夹下所有文件和子文件夹至/system

函数名称: package_extract_file

函数语法: package_extract_file(package_path) 或 package_extract_file(package_path, destination_path)

参数详解: package_path----------字符串，升级包内要提取的文件

destination_path-------字符串，提取文件的目标目录

作用解释: 提取升级包内的单个文件到指定的目标目录

函数示例: package_extract_file("my.zip", "/system");解压ROM包里的my.zip文件至/system

函数名称: file_getprop

函数语法: file_getprop(file, key)

参数详解: file----------------------字符串，要检查的文件名

Key----------------------字符串，返回数据中的文件的键名字

作用解释: 在格式"key"="value"的文件中取得文件属性值

函数示例:

函数名称: symlink

函数语法: symlink(target, src1, src2, ..., srcN)

参数详解: target-------------------字符串，符号链接的目标

srcX       ---------------------字符串，要创建的符号链接的目标点

作用解释: 在创建新的符号链接之前，要断开已经存在的符号链接

函数示例: symlink("toolbox", "/system/bin/ps");建立指向toolbox的符号链接/system/bin/ps

函数名称: set_perm

函数语法: set_perm(uid, gid, mode, file1, file2, ..., fileN)

参数详解: uid----------------------用户ID(user id)

Gid----------------------用户组ID(group id)

Mode--------------------权限模式(permission mode)

fileX---------------------要设置许可的文件(file to set permission on)

作用解释: 设置单个文件或一系列文件的权限，最少指定1个文件，前4个参数是必须的

函数示例: set_perm(0,2000,0550, "system/etc/init.goldfish.sh")；设置手机system中的etc/init.goldfish.sh的用户为root，用户组为shell，所有者以及所属用户组成员可以进行读取和执行操作，其他用户无操作权限）

这里 0 代表用户为 root
2000 代表用户组为 shell
我们来说明 0550 这组数据，这组数据的最后三位 550 ，分别代表“所有者 \ 组用户 \ 其他用户”的权限，也就是我们在 RE 管理中“用户 \ 群组 \ 其他”三行。   我们以 XXX 来表示这三组权限，其中：
× =4  读的权限
× =2  写的权限
× =1  执行的权限
我们必须首先了解用数字表示的属性的含义： 0 表示没有权限， 1 表示可执行权限， 2 表示可写权限， 4 表示可读权限，然后将其相加。所以数字属性的格式应为 3 个从 0 到 7 的八进制数。
例如，如果想让某个文件的属主有 " 读 / 写 " 二种权限，需要把 4( 可读 )+2( 可写 ) ＝ 6( 读 / 写 ) 。若要 rwx 属性则 4+2+1=7 ；若要 rw- 属性则 4+2=6 ；若要 r-x 属性则 4+1=5 。
常用修改权限的命令：
Set_perm 0 0 0600  ×××  ( 只有所有者有读和写的权限 )
Set_perm 0 0 0644  ×××  ( 所有者有读和写的权限，组用户只有读的权限 )
Set_perm 0 0 0700  ×××  ( 只有所有者有读和写以及执行的权限 )
Set_perm 0 0 0666  ×××  ( 每个人都有读和写的权限 )
Set_perm 0 0 0777  ×××  ( 每个人都有读和写以及执行的权限 )

函数名称: set_perm_recursive

函数语法: set_perm_recursive(uid, gid, dirmode, filemode, dir1, dir2, ...dirN)

参数详解: uid----------------------用户ID(user id)

Gid----------------------用户组ID(group id)

Dirmode----------------指定目录内的目录的权限

Filemode---------------指定目录内的文件的权限

dirX---------------------要设置权限的目标

作用解释: 设置单个目录或一系列目录的里面的所有文件的权限，最少指定1个目录，5个参数都是必须的

函数示例: set_perm_recursive 0 0 0755 0644 SYSTEM:app；设置手机system/app文件夹及其中文件的用户为root，用户组为root，app文件夹权限为所有者可以进行读、写、执行操作，其他用户可以进行读取和执行操作，其中的文件的权限为所有者可以进行读写操作，其他用户可以进行读取操作

函数名称: getprop

函数语法: getprop(key)

参数详解: key---------------------字符串，想要系统返回的属性

作用解释: 这个函数是用来返指定的属性的值。它是用来从build.props文件中查询手机的信息的。

函数示例:

函数名称: write_raw_image

函数语法: write_raw_image(file, partition)

参数详解: file----------------------字符串，要读取的Img源文件

Partition-----------------字符串，要写入Img文件的目标分区

作用解释: 这个函数是用来写Img文件到分区

函数示例: write_raw_image("/tmp/boot.img", "boot")将yaffs2格式的boot包直接写入boot分区

函数名称: apply_patch

函数语法: apply_patch(srcfile, tgtfile, tgtsha1, tgtsize, sha1_1, patch_1, ..., sha1_x, patch1_x)

参数详解: srcfile-------------------字符串，要打补丁的源文件(要读入的文件)

Tgtfile-------------------字符串，补丁文件要写入的目标文件

tgtsha1-----------------字符串，写入补丁文件的目标文件的sha1哈希值

sha1_x------------------字符串，要写入目标文件的补丁数据的sha1哈希值

patch1_x----------------字符串，实际上应用到目标文件的补丁

作用解释: 这个函数是用来打补丁到文件。

函数示例:

函数名称: apply_patch_check

函数语法: apply_patch_check(file, sha1_1, ..., sha1_x)

参数详解: file----------------------字符串，要检查的文件

sha1_x------------------要检查的哈希值

作用解释: 检查文件是否已经被打补丁，或者能不能被打补丁。需要检查“applypatch_check ”函数调用的源代码。

函数示例:

函数名称: apply_patch_space

函数语法: apply_patch_space(bytes)

参数详解: bytes-------------------检查的字节的数字

作用解释: 检查缓存来确定是否有足够的空间来写入补丁文件并返回一些数据。

函数示例:

函数名称: read_file

函数语法: read_file(filename)

参数详解: filename----------------字符串，要读取内容的文件名

作用解释: 这个函数返回文件的内容

函数示例:

函数名称: sha1_check

函数语法: sha1_check(data) 或 sha1_check(data, sha1_hex, ..., sha1_hexN)

参数详解: data---------------------要计算sha1哈希值的文件的内容-必须是只读文件格式

sha1_hexN--------------文件数据要匹配的特定的十六进制sha1_hex哈希值字符串

作用解释: 如果只指定data参数，这个函数返回data参数的十六进制sha1_hex哈希值字符串。其他参数用来确认你检查的文件是不是列表中的哈希值的一个。 它返回匹配的哈希值，或者在没有匹配任何哈希值时返回空。

函数示例:

函数名称: ui_print

函数语法: ui_print(msg1, ..., msgN)

参数详解: msg----------------------字符串，要处理过程中输出给用户的信息

作用解释: 在脚本运行的时候，在控制台显示的信息。最少要指定1个参数，你可以指定额外的msg参数，并且它们会连接起来输了

函数示例: ui_print("It's ready!");屏幕打印It's ready!

函数名称: run_program

函数语法: run_program(prog, arg1, .., argN)

参数详解: prog--------------------字符串，要执行的程序

argN--------------------字符串，要执行的程序的运行参数

作用解释: 以指定的参执行程序

函数示例: run_program("/system/xbin/installbusybox.sh");运行installbusybox.sh脚本文件