update-script脚本语法说明

mzecn

转自网络。。。出处不明！大家罗来主义吧！

update-script脚本语法说明(根据android源代码中的recovery.c进行的定义):

1.copy_dir
语法：copy_dir <src-dir> <dst-dir> [<times**p>]
<src-dir>表示原文件夹，<dst-dir>表示目的文件夹，[<times**p>]表示时间戳
作用：将<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的快捷方式）


android文件系统和分区的定义方式（根据android的源代码的root.c获得）：
根目录
Linux块设备
挂载点
文件系统
大小
描述

BOOT:
/dev/mtdblock[?]
/
RAM
RAW
内核，内存，系统启动引导信息

DATA:
/dev/mtdblock5
/data
yaffs2
91904kb
用户，系统设置，程序设置和应用程序，不包括app2sd

CACHE：
/dev/mtdblock4
/cache
yaffs2
30720kb
OTA方式下载的缓存，恢复和升级时的设置以及临时文件

MISC：
/dev/mtdblock[?]
无
未知
RAW
暂时未知

PACKAGE：
相对于升级包而存在
无
相对于升级包存在的文件系统
不确定
升级包

RECOVERY：
/dev/mtdblock[?]
/
RAM
RAW
恢复模式和系统升级所需要的内核和内存部分，与BOOT分区类似

SDCARD：
/dev/mmcblk0(p1)
/sdcard
fat32
32MB-32GB
内存卡，update.zip升级包通常放在这里

SYSTEM：
/dev/mtdblock3
/system
yaffs2
92160kb
系统分区，静态并且只读的

TMP：
无
/tmp
RAM
　
标准的Linux缓存文件系统


更新部分update-script命令：

1.assert <boolexpr>
作用：此命令用来判断表达式boolexpr的正确与否，当表达式错误时程序终止执行
※此作用有待验证


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


3.write_hboot_image <src-image>
作用：将系统bootloader镜像写入手机，<src-image>表示镜像位置，此命令在直到在所有的程序安装结束之后才会起作用
举例：write_hboot_image PACKAGE:hboot.img


4.write_raw_image <src-image> <dest-root>
作用：将boot.img写入手机，里面包含了内核和ram盘
举例：write_raw_image PACKAGE:boot.img BOOT:



更新手机常识理解：
system:系统分区.我们刷机器一般就是刷的这个分区.
userdata:数据分区.
cache:缓存分区
recovery:Recovery分区，相当于建立在hboot与android系统间的一个中间层，如名字一般，主要用于系统调试和恢复。.
boot:存放内核和ramdisk的分区.
hboot:这个是SPL所在的分区，即 bootloader
splash1:这个就是开机第一屏幕了.
radio:这个是无线所在的分区.
misc:其他分区