Android刷机脚本——updater-script

前言

    updater-script是Android手机刷入系统时的脚本文件，由它来决定Android系统需要刷入哪些内容，如何刷入。

语法

1. mount

语法： mount(fs_type, partition_type, location, mount_point)。

作用：挂载一个文件系统到指定的挂载点。

返回值：成功返回挂载点，失败返回null。

说明：

• fs_type：“yaffs2”或“ext4”
• partition_type：“MTD”或“EMMC”
• location：分区（partition）或驱动器（device）
• mount_point：挂载文件系统的目标文件夹

示例：mount("ext4", "EMMC", "/dev/block/mmcblk0p8", "/system");

2. unmount

语法：unmount(mount_point)。

作用：解除文件系统挂载。

返回值：成功返回挂载点，失败返回null。

示例：unmount("/system");

3. format

语法：format(fs_type, partition_type, location)

作用：格式化指定的文件系统

说明：

• fs_type：“yaffs2”或“ext4”
• partition_type：“MTD”或“EMMC”
• location：分区或驱动器

示例：format("ext4", "EMMC", "/cache");

4. delete

语法：delete(file1, file2, ..., fileN)

作用：删除文件。变长参数，支持删除多个文件。

示例：delete("/tmp/boot.img");

5. delete_recursive

语法：delete_recursive(<path>)

作用：递归删除目录。

示例：delete_recursive("/data/media/AppStoreWidget")

6. show_progress

语法：show_progress(fraction, duration)

作用：在recovery中为下面的程序操作显示进度条。进度条会根据duration前进fraction。

说明：

• fraction：进度完成数值
• duration：总秒数

示例：show_progress(0.950000, 50); （ps：show_progress后面的操作可能耗时50s，完成后进度条前进95%）

7. package_extract_dir

语法：package_extract_dir(package_path, destination_path);

作用：释放卡刷包中package_path的内容到destination_path。

示例：package_extract_dir("system", "/system"); （ps：释放rom包中system文件夹下所有文件和子文件夹至/system）

8. package_extract_file

语法：package_extract_file(file_path, destination_path);

作用：提取Rom包中的单个文件到指定目标目录。

示例：package_extract_file("boot.img", "/tmp/boot.img");

9. symlink

语法：symlink(target, src1, src2, ...);

作用：建立指向target的符号链接src1、src2...

说明：

• target：符号链接目标
• src1：要创建的符号链接目标点

示例：symlink("mksh", "/system/bin/sh");

10. set_perm

语法：set_perm(uid, gid, mode, file1, file2, ..., fileN);

作用：设置单个文件或者多个文件的权限。

说明：

• uid：用户ID
• gid：用户组ID
• mode：权限
• file1：需要设置的文件路径

示例：set_perm(0, 3004, 02755, "/system/bin/ping");

11. set_perm_recursive

语法：set_perm_recursive(uid, gid, dir-mode, file-mode, path);

作用：设置指定文件夹和文件夹中文件的权限。

示例：set_perm_recursive(0, 0, 0755, 0644, "/system");

12. ui_print

语法：ui_print("str");

作用：recovery中打印出str字符串内容，类似于Java中的System.out.println();

示例：ui_print("+++++++++++++++++++++++++++++++++++++++++++++");

13. run_program

语法：run_program(path, arg1, ..., argN)

作用：以指定的参数执行程序。

说明：

• path：要执行的程序路径
• arg1：运行参数信息

示例：run_program("/sbin/busybox", "mount", "/system");

14. write_raw_image

语法：write_raw_image(file_path, partition);

说明：

• file_path：要读取的img源文件
• partition：要写入img文件的目标分区

示例：write_raw_image("/tmp/boot.img", "bootimg");

15. assert

语法：assert(condition1, ..., conditionN);

作用：如果condition的计算结果为false，则终止脚本的运行。

示例：assert(package_extract_file("boot.img","/tmp/boot.img"), write_raw_image("/tmp/boot.img","bootimg"), delete("/tmp/boot.img"));