安卓刷机包update-script脚本语法说明

作者: admin 分类: 学习文档 发布时间: 2011-10-31 22:20

一. 基础语法篇
1.copy_dir
语法:copy_dir <src-dir> <dst-dir> [<timestamp>]
<src-dir>表示原文件夹,<dst-dir>表示目的文件夹,[<timestamp>]表示时间戳
作用:将<src-dir>文件夹中的内容复制到<dst-dir>文件夹中。<dst-dir>文件夹中的原始内容将会保存不变,除非<src-dir>文件夹中有相同的内容,这样<dst-dir>中的内容将被覆盖
举例:copy_dir PACKAGE:system SYSTEM:(将升级包中的system文件夹复制到手机中)

2.format
语法:format <root>
<root>表示要格式化的分区
作用:格式化一个分区
举例:format SYSTEM:(将手机/system分区完全格式化)
注意:格式化之后的数据是不可以恢复的

3.delete
语法:delete <file1> [… <fileN>]
<file1> [… <fileN>]表示要格式化的文件,可以是多个文件用空格隔开
作用:删除文件1,2到n
举例:delete SYSTEM:app/Calculator.apk(删除手机systen文件夹中app中的Calculator.apk文件)

4.delete_recursive
语法:delete_recursive <file-or-dir1> [… <file-or-dirN>]
<file-or-dir1> [… <file-or-dirN>]表示要删除的文件或文件夹,可以使多个,中间用空格隔开
作用:删除文件或者目录,删除目录时会将目录中的所有内容全部删除
举例:delete_recursive DATA:dalvik-cache(删除/data/dalvik-cache文件夹下的所有内容)

5.run_program
语法:run_program <program-file> [<args> …]
<program-file>表示要运行的程序,[<args> …]表示运行程序所加的参数
作用:运行终端程序
举例:run_program PACKAGE:install_busybox.sh(执行升级包中的install_busybox.sh脚本)

6.set_perm
语法:set_perm <uid> <gid> <mode> <path> [… <pathN>]
<uid>表示用户名称,<gid>表示用户组名称,<mode>,表示权限模式,<path> [… <pathN>]表示文件路径,可以使多个,用空格隔开
作用:设置单个文件或目录的所有者和权限,像linux中的chmod、chown或chgrp命令一样,只是集中在了一个命令当中
举例:set_perm 0 2000 0550 SYSTEM:etc/init.goldfish.sh(设置手机system中的etc/init.goldfish.sh的用户为root,用户组为shell,所有者以及所属用户组成员可以进行读取和执行操作,其他用户无操作权限)

7.set_perm_recursive
语法:set_perm_recursive <uid> <gid> <dir-mode> <file-mode> <path> [… <pathN>]
<uid>表示用户,<gid>表示用户组,<dir-mode>表示文件夹的权限,<file-mode>表示文件的权限,<path> [… <pathN>]表示文件夹的路径,可以多个,用空格分开
作用:设置文件夹及文件夹中的文件的所有者和用户组
举例:set_perm_recursive 0 0 0755 0644 SYSTEM:app(设置手机system/app文件夹及其中文件的用户为root,用户组为root,app文件夹权限为所有者可以进行读、写、执行操作,其他用户可以进行读取和执行操作,其中的文件的权限为所有者可以进行读写操作,其他用户可以进行读取操作)

8.show_progress
语法:show_progress <fraction> <duration>
<表示一个小部分> <表示一个小部分的持续时间>
作用:为下面进行的程序操作显示进度条,进度条会根据<duration>进行前进,当操作时间是确定的时候会更快
举例:show_progress 0.1 0(显示进度条当操作完成后前进10%)

9.symlink
语法:symlink <link-target> <link-path>
<link-target>表示链接到的目标,<link-path>表示快捷方式的路径
作用:相当于linux中的ln命令,将<link-target>在<link-path>处创建一个软链接,<link-target>的格式应为绝对路径(或许相对路径也可以),<link-path>为“根目录:路径”的形式
举例:symlink /system/bin/su SYSTEM:xbin/su(在手机中system中的xbin中建立一个/system/bin/su的快捷方式)
10.assert
语法:assert <boolexpr>

作用:此命令用来判断表达式boolexpr的正确与否,当表达式错误时程序终止执行※此作用有待验证

11.package_extract_file/dir语法:package_extract_file(file/dir,file/dir)
作用:提取包中文件/路径
举例:package_extract_dir(“system”, “/system”);
package_extract_file(“system/bin/modelid_cfg.sh”, “/tmp/modelid_cfg.sh”);


12.write_radio_image

语法:write_radio_image <src-image>
作用:将基带部分的镜像写入手机,<src-image>表示镜像文件
举例:write_radio_image PACKAGE:radio.img

13.write_hboot_image

语法:write_hboot_image <src-image>
作用:将系统bootloader镜像写入手机,<src-image>表示镜像位置,此命令在直到在所有的程序安装结束之后才会起作用

举例:write_hboot_image PACKAGE:hboot.img
14.write_raw_image语法:write_raw_image <src-image> <dest-root>
作用:将boot.img写入手机,里面包含了内核和ram盘
举例:write_raw_image PACKAGE:boot.img BOOT:

二、根目录以及分区的定义(在Android源代码的root.c文件中定义)

根目录: Linux 块设备 /挂载点/ 文件系统 大小 描述
BOOT: /dev/mtdblock[?] / (RAM) Raw 内核、内存盘和引导配置。
DATA: /dev/mtdblock5 /data/ yaffs2 91904kb 用户、系统配置,软件配置以及软件(没有a2sd的话)
CACHE: /dev/mtdblock4 /cache/ yaffs2 30720kb OTA缓存,recovery/更新配置及临时文件夹
MISC: /dev/mtdblock[?] N/A Raw,[?]kb (等待添加)
PACKAGE: (相对于刷机包) N/A 刷机包的伪文件系统。
RECOVERY: /dev/mtdblock[?] / (RAM) Raw,[?]kb recovery和更新环境的内核和内存盘。类似于BOOT:。
SDCARD: /dev/mmcblk0(p1) /sdcard/ fat32 32MB-32GB TF卡。通常刷机包就放在这里。
SYSTEM: /dev/mtdblock3 /system/ yaffs2 92160kb 系统分区,静态且是只读的。
TMP: /tmp/ (RAM) 标准的Linux临时文件夹 在关机/重启时清空。

三. 实例分析进阶篇

呵呵,大家来看看这段代码是不是有种熟悉的感觉啊,这就是在SwiftDroid_v1.8_recovery_BY_mur4ik刷机包中的updater-script文件!

  1. assert(getprop(“ro.product.device”) == “swift” || getprop(“ro.build.product”) == “swift” || getprop(“ro.product.board”) == “swift”);
  2. package_extract_file(“system/bin/backuptool.sh”, “/tmp/backuptool.sh”);
  3. set_perm(0, 0, 0777, “/tmp/backuptool.sh”);
  4. run_program(“/tmp/backuptool.sh”, “backup”);
  5. show_progress(0.500000, 0);
  6. format(“yaffs2”, “MTD”, “system”);
  7. mount(“yaffs2”, “MTD”, “system”, “/system”);
  8. package_extract_dir(“recovery”, “/system”);
  9. package_extract_dir(“system”, “/system”);
  10. symlink(“busybox”, “/system/xbin/[“, “/system/xbin/[[“,
  11.         “/system/xbin/arp”, “/system/xbin/ash”, “/system/xbin/awk”,
  12.         “/system/xbin/basename”, “/system/xbin/bbconfig”, “/system/xbin/brctl”,
  13.         “/system/xbin/bunzip2”, “/system/xbin/bzcat”, “/system/xbin/bzip2”,
  14.         “/system/xbin/cal”, “/system/xbin/cat”, “/system/xbin/catv”,
  15.         “/system/xbin/chgrp”, “/system/xbin/chmod”, “/system/xbin/chown”,
  16.         “/system/xbin/chroot”, “/system/xbin/cksum”, “/system/xbin/clear”,
  17.         “/system/xbin/cmp”, “/system/xbin/cp”, “/system/xbin/cpio”,
  18.         “/system/xbin/cut”, “/system/xbin/date”, “/system/xbin/dc”,
  19.         “/system/xbin/dd”, “/system/xbin/depmod”, “/system/xbin/devmem”,
  20.         “/system/xbin/df”, “/system/xbin/diff”, “/system/xbin/dirname”,
  21.         “/system/xbin/dmesg”, “/system/xbin/dnsd”, “/system/xbin/dos2unix”,
  22.         “/system/xbin/du”, “/system/xbin/echo”, “/system/xbin/ed”,
  23.         “/system/xbin/egrep”, “/system/xbin/env”, “/system/xbin/expr”,
  24.         “/system/xbin/false”, “/system/xbin/fdisk”, “/system/xbin/fgrep”,
  25.         “/system/xbin/find”, “/system/xbin/fold”, “/system/xbin/free”,
  26.         “/system/xbin/freeramdisk”, “/system/xbin/fuser”, “/system/xbin/getopt”,
  27.         “/system/xbin/grep”, “/system/xbin/gunzip”, “/system/xbin/gzip”,
  28.         “/system/xbin/head”, “/system/xbin/hexdump”, “/system/xbin/id”,
  29.         “/system/xbin/ifconfig”, “/system/xbin/insmod”, “/system/xbin/install”,
  30.         “/system/xbin/ip”, “/system/xbin/kill”, “/system/xbin/killall”,
  31.         “/system/xbin/killall5”, “/system/xbin/length”, “/system/xbin/less”,
  32.         “/system/xbin/ln”, “/system/xbin/losetup”, “/system/xbin/ls”,
  33.         “/system/xbin/lsmod”, “/system/xbin/lspci”, “/system/xbin/lsusb”,
  34.         “/system/xbin/lzop”, “/system/xbin/lzopcat”, “/system/xbin/md5sum”,
  35.         “/system/xbin/mkdir”, “/system/xbin/mke2fs”, “/system/xbin/mkfifo”,
  36.         “/system/xbin/mkfs.ext2”, “/system/xbin/mknod”, “/system/xbin/mkswap”,
  37.         “/system/xbin/mktemp”, “/system/xbin/modprobe”, “/system/xbin/more”,
  38.         “/system/xbin/mount”, “/system/xbin/mountpoint”, “/system/xbin/mv”,
  39.         “/system/xbin/netstat”, “/system/xbin/nice”, “/system/xbin/nohup”,
  40.         “/system/xbin/nslookup”, “/system/xbin/ntpd”, “/system/xbin/od”,
  41.         “/system/xbin/patch”, “/system/xbin/pgrep”, “/system/xbin/pidof”,
  42.         “/system/xbin/ping”, “/system/xbin/pkill”, “/system/xbin/printenv”,
  43.         “/system/xbin/printf”, “/system/xbin/ps”, “/system/xbin/pwd”,
  44.         “/system/xbin/rdev”, “/system/xbin/readlink”, “/system/xbin/realpath”,
  45.         “/system/xbin/renice”, “/system/xbin/reset”, “/system/xbin/rm”,
  46.         “/system/xbin/rmdir”, “/system/xbin/rmmod”, “/system/xbin/route”,
  47.         “/system/xbin/run-parts”, “/system/xbin/sed”, “/system/xbin/seq”,
  48.         “/system/xbin/setsid”, “/system/xbin/sh”, “/system/xbin/sha1sum”,
  49.         “/system/xbin/sha256sum”, “/system/xbin/sha512sum”,
  50.         “/system/xbin/sleep”, “/system/xbin/sort”, “/system/xbin/split”,
  51.         “/system/xbin/stat”, “/system/xbin/strings”, “/system/xbin/stty”,
  52.         “/system/xbin/swapoff”, “/system/xbin/swapon”, “/system/xbin/sync”,
  53.         “/system/xbin/sysctl”, “/system/xbin/tac”, “/system/xbin/tail”,
  54.         “/system/xbin/tar”, “/system/xbin/tee”, “/system/xbin/telnet”,
  55.         “/system/xbin/test”, “/system/xbin/tftp”, “/system/xbin/time”,
  56.         “/system/xbin/top”, “/system/xbin/touch”, “/system/xbin/tr”,
  57.         “/system/xbin/traceroute”, “/system/xbin/true”, “/system/xbin/tty”,
  58.         “/system/xbin/tune2fs”, “/system/xbin/umount”, “/system/xbin/uname”,
  59.         “/system/xbin/uniq”, “/system/xbin/unix2dos”, “/system/xbin/unlzop”,
  60.         “/system/xbin/unzip”, “/system/xbin/uptime”, “/system/xbin/usleep”,
  61.         “/system/xbin/uudecode”, “/system/xbin/uuencode”, “/system/xbin/vi”,
  62.         “/system/xbin/watch”, “/system/xbin/wc”, “/system/xbin/wget”,
  63.         “/system/xbin/which”, “/system/xbin/whoami”, “/system/xbin/xargs”,
  64.         “/system/xbin/yes”,
  65.         “/system/xbin/zcat”);
  66. symlink(“iwmulticall”, “/system/xbin/iwconfig”, “/system/xbin/iwgetid”,
  67.         “/system/xbin/iwlist”, “/system/xbin/iwpriv”,
  68.         “/system/xbin/iwspy”);
  69. symlink(“toolbox”, “/system/bin/cat”, “/system/bin/cmp”,
  70.         “/system/bin/date”, “/system/bin/dd”, “/system/bin/dmesg”,
  71.         “/system/bin/getevent”, “/system/bin/getprop”, “/system/bin/hd”,
  72.         “/system/bin/id”, “/system/bin/ifconfig”, “/system/bin/iftop”,
  73.         “/system/bin/insmod”, “/system/bin/ioctl”, “/system/bin/ionice”,
  74.         “/system/bin/kill”, “/system/bin/log”, “/system/bin/lsmod”,
  75.         “/system/bin/mkdir”, “/system/bin/nandread”, “/system/bin/netstat”,
  76.         “/system/bin/newfs_msdos”, “/system/bin/notify”, “/system/bin/printenv”,
  77.         “/system/bin/ps”, “/system/bin/reboot”, “/system/bin/renice”,
  78.         “/system/bin/rmdir”, “/system/bin/rmmod”, “/system/bin/route”,
  79.         “/system/bin/schedtop”, “/system/bin/sendevent”,
  80.         “/system/bin/setconsole”, “/system/bin/setprop”, “/system/bin/sleep”,
  81.         “/system/bin/smd”, “/system/bin/start”, “/system/bin/stop”,
  82.         “/system/bin/sync”, “/system/bin/top”, “/system/bin/uptime”,
  83.         “/system/bin/vmstat”, “/system/bin/watchprops”,
  84.         “/system/bin/wipe”);
  85. set_perm_recursive(0, 0, 0755, 0644, “/system”);
  86. set_perm_recursive(0, 2000, 0755, 0755, “/system/bin”);
  87. set_perm(0, 3003, 02750, “/system/bin/netcfg”);
  88. set_perm(0, 3004, 02755, “/system/bin/ping”);
  89. set_perm(0, 2000, 06750, “/system/bin/run-as”);
  90. set_perm_recursive(1002, 1002, 0755, 0440, “/system/etc/bluetooth”);
  91. set_perm(0, 0, 0755, “/system/etc/bluetooth”);
  92. set_perm(1000, 1000, 0640, “/system/etc/bluetooth/auto_pairing.conf”);
  93. set_perm(3002, 3002, 0444, “/system/etc/bluetooth/blacklist.conf”);
  94. set_perm(1002, 1002, 0440, “/system/etc/dbus.conf”);
  95. set_perm(1014, 2000, 0550, “/system/etc/dhcpcd/dhcpcd-run-hooks”);
  96. set_perm_recursive(0, 2000, 0755, 0750, “/system/etc/init.d”);
  97. set_perm(0, 0, 0755, “/system/etc/init.d”);
  98. set_perm(0, 2000, 0550, “/system/etc/init.goldfish.sh”);
  99. set_perm(0, 0, 0544, “/system/etc/install-recovery.sh”);
  100. set_perm_recursive(0, 0, 0755, 0555, “/system/etc/ppp”);
  101. set_perm_recursive(0, 2000, 0755, 0755, “/system/xbin”);
  102. set_perm(0, 0, 06755, “/system/xbin/hcitool”);
  103. set_perm(0, 0, 06755, “/system/xbin/librank”);
  104. set_perm(0, 0, 06755, “/system/xbin/procmem”);
  105. set_perm(0, 0, 06755, “/system/xbin/procrank”);
  106. set_perm(0, 0, 06755, “/system/xbin/su”);
  107. set_perm(0, 0, 06755, “/system/xbin/tcpdump”);
  108. show_progress(0.200000, 0);
  109. show_progress(0.200000, 10);
  110. package_extract_file(“system/bin/backuptool.sh”, “/tmp/backuptool.sh”);
  111. set_perm(0, 0, 0777, “/tmp/backuptool.sh”);
  112. run_program(“/tmp/backuptool.sh”, “restore”);
  113. package_extract_file(“system/bin/modelid_cfg.sh”, “/tmp/modelid_cfg.sh”);
  114. set_perm(0, 0, 0777, “/tmp/modelid_cfg.sh”);
  115. run_program(“/tmp/modelid_cfg.sh”);
  116. package_extract_file(“system/bin/verify_cache_partition_size.sh”, “/tmp/verify_cache_partition_size.sh”);
  117. set_perm(0, 0, 0777, “/tmp/verify_cache_partition_size.sh”);
  118. run_program(“/tmp/verify_cache_partition_size.sh”);
  119. show_progress(0.200000, 10);
  120. assert(package_extract_file(“boot.img”, “/tmp/boot.img”),
  121.        write_raw_image(“/tmp/boot.img”, “boot”),
  122.        delete(“/tmp/boot.img”));
  123. show_progress(0.100000, 0);
  124. unmount(“/system”);

复制代码

如果觉得我的文章对您有用,请随意赞赏。您的支持将鼓励我继续创作!

发表回复

您的电子邮箱地址不会被公开。 必填项已用 * 标注

Protected by WP Anti Spam