(Updater-Script)刷机脚本说明。
如果觉得这样看起来吃力,下面可以下载一个文档附件,拿回家慢慢研究。
这是Android系统来运行updater-scripts的Edify语言的基本介绍。
大部分的Edify命名都是函数,当调用这些函数结束的时候,会返回数据给脚本。
当然,你也可以使用这些函数的返回值来确认成功与否,例如:ifelse(mount("yaffs2", "MTD", "system", "/system") == "system",ui_print("Successfully Mounted!"), ui_print("Mount Failed!");这个命令会尝试去挂载命名为“system”的“MTD”分区到“/system”。
如果挂载成功,脚本会显示“Successfully Mounted!”,否则会显示“Mount Failed!”。
现面是用在Edify的Updater-script中的函数例子:函数名称: 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代表用户为root2000代表用户组为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---------------------字符串,想要系统返回的属性作用解释: 这个函数是用来返指定的属性的值。