当前位置: 首页 > 工具软件 > W-Script > 使用案例 >

Android recovery 下使用 updater-script 自制升级包

郑俊弼
2023-12-01

recovery 模式下,使用 updater-script 脚本来完成的升级。

系统自带到ota_rom_target_files.py,编译时可以生成updater-script的脚本。

有时我们需要自己定义升级的功能。下面自己写一个升级脚本。完成升级功能。

1 创建目录结构:

  data/app

 

  META-INF/com/google/Android/update-binary

  META-INF/com/google/Android/updater-script

  system/app

  system/xbin/busybox

 其中 data/app下面的apk会被复制到系统的/data/data/app目录下.

 其中 system/app下面的内容会被复制到系统的/system/app目录下

其中 system/xbin下面的内容会被复制到系统的/system/xbin目录下

如果需要放入到系统相应目录下面,你就建立;没有可以空着。

 system/xbin/busybox,是我们需要的。这个可以在busybox网站下载armv6版的。

 META-INF/com/google/Android/update-binary 这个文件从make 系统的ota升级包中复制同名文件。

META-INF/com/google/Android/updater-script 这个文本文件下面我们来写。

updater-script的内容

我们复制/data/app下面的所有apk到/data/app目录下面;我们使用busybox的目的是使用cp命令。因为Android系统的toobox 没有cp命令。

  1. show_progress(0.500000, 0); 
  2. ui_print("liuhongchao- Updater script.."); 
  3.  
  4.  
  5. ############################ 
  6. #partion information came from
  7. #  0 /tmp       ramdisk (null) (null) 0 
  8. #  1 /boot      emmc    /dev/block/mmcblk0p8 (null) 0 
  9. #  2 /cache         ext4    /dev/block/mmcblk0p15 (null) 0 
  10. #  3 /data      ext4    /dev/block/mmcblk0p13 (null) 0 
  11. #  4 /persist   ext4    /dev/block/mmcblk0p14 (null) 0 
  12. #  5 /recovery  emmc    /dev/block/mmcblk0p16 (null) 0 
  13. #  6 /recovery-bak   ext4   /dev/block/mmcblk0p17 (null) 0 
  14. #  7 /sdcard        vfat    /dev/block/mmcblk1p1 /dev/block/mmcblk1 0 
  15. #  8 /system        ext4    /dev/block/mmcblk0p12 (null) 0 
  16.  
  17.  
  18. ############################ 
  19. #mount  partion  
  20. show_progress(0.100000, 0); 
  21. ui_print("liuhongchao--mount  partion ..."); 
  22.  
  23. mount("ext4", "EMMC", "/dev/block/mmcblk0p12", "/system");  
  24. mount("ext4", "EMMC", "/dev/block/mmcblk0p13", "/data");  
  25.   
  26.  
  27. ############################ 
  28. #extract_dir 
  29. #show_progress(0.100000, 0); 
  30. #ui_print("liuhongchao-- extract_dir..."); 
  31.  
  32. package_extract_dir("system", "/system"); 
  33. #package_extract_dir("system/lib", "/system/lib"); 
  34.  
  35.  
  36.  
  37. ############################ 
  38. # set symlink file---- 
  39. #show_progress(0.100000, 0); 
  40. #ui_print("liuhongchao--symlink..."); 
  41.  
  42. # symlink("/data/app/apps.apk", "/system/app/apps.apk"); 
  43. # symlink("/data/etc/hosts", "/system/etc/hosts"); 
  44.  
  45.  
  46. ############################ 
  47. # set perm file---- 
  48. #show_progress(0.100000, 0); 
  49. #ui_print("liuhongchao--set perm file.."); 
  50.  
  51.  
  52. set_perm(0, 0, 04755, "/system/xbin/busybox"); 
  53. #set_perm_recursive(1000, 1000, 0771, 0644, "/data/app"); 
  54. #set_perm(2000, 2000, 0771, "/data/etc"); 
  55.  
  56. ############################ 
  57. # copy some_dir 
  58. #show_progress(0.100000, 0); 
  59. #ui_print("liuhongchao--copy some_dir..."); 
  60.  
  61. #package_extract_dir("../../sdcard/test", "/data/data"); 
  62. #package_extract_dir("/sdcard/test", "/data/data"); 
  63.  
  64. ############################ 
  65. # copy run_program 
  66. show_progress(0.100000, 0); 
  67. ui_print("liuhongchao--run_program..."); 
  68.  
  69. run_program("/system/bin/mkdir", "/data/data/cpdirtest"); 
  70. set_perm(1000, 1000, 0640, "/data/data/cpdirtest"); 
  71. #run_program("/system/bin/mv","/mnt/sdcard/test","/data/data/run"); 
  72. run_program("/system/xbin/busybox","cp","-r","/sdcard/test/*","/data/data/cpdirtest/"); 
  73.  
  74.  
  75. #package_extract_file("data/run.sh", "/tmp/run.sh"); 
  76. #set_perm(0, 0, 0777, "/tmp/run.sh"); 
  77. #run_program("/tmp/run.sh");  
  78.  
  79. ############################ 
  80. # delete some file---- 
  81. #show_progress(0.100000, 0); 
  82. #ui_print("liuhongchao-- delete some file..."); 
  83.  
  84. #delete_recursive("/data/data/otatest"); 
  85. #delete_recursive("/system/app/getOTA.apk"); 
  86.  
  87. #delete("/system/app/getOTA.apk"); 
  88.  
  89.  
  90.  
  91.  
  92. ############################ 
  93. # write bootimg---- 
  94. #show_progress(0.100000, 0); 
  95. #ui_print("liuhongchao--write bootimg.."); 
  96.  
  97. #  package_extract_file("boot.img","/tmp/boot.img"); 
  98. #  write_raw_image("/tmp/boot.img", "boot"); 
  99. #  delete("/tmp/boot.img"); 
  100.  
  101.  
  102. ############################ 
  103. # set unmount---- 
  104. show_progress(0.100000, 0); 
  105. ui_print("liuhongchao--unmount..."); 
  106. unmount("/data");  
  107. unmount("/system"); 
  108. 这是个我写的模板,选择需要用的命令。下面的命令是必须的。

     

    1. mount("ext4", "EMMC", "/dev/block/mmcblk0p12", "/system");  
    2. mount("ext4", "EMMC", "/dev/block/mmcblk0p13", "/data"); 
    3.  
    4. package_extract_dir("system", "/system"); 
    5. package_extract_dir("data", "/data"); 
    6.  
    7. #下面的命令可以复制任何你需要的内容;busybox
    8. set_perm(0, 0, 04755, "/system/xbin/busybox"); 
    9. run_program("/system/xbin/busybox","cp","/sdcard/app-private/hello.apk","/data/app-private/"); 
    10.  
    11.  
    12. unmount("/data");  
    13. unmount("/system");  

    下面这个是我这个的Android系统的分区表,不同的硬件平台会不同。为了mount时不出错。这个文件在src/device/qcom/msm8660_surf/recovery.fstab 

    ############################ 

    1. #partion information came from
    2. #  0 /tmp       ramdisk (null) (null) 0 
    3. #  1 /boot      emmc    /dev/block/mmcblk0p8 (null) 0 
    4. #  2 /cache         ext4    /dev/block/mmcblk0p15 (null) 0 
    5. #  3 /data      ext4    /dev/block/mmcblk0p13 (null) 0 
    6. #  4 /persist   ext4    /dev/block/mmcblk0p14 (null) 0 
    7. #  5 /recovery  emmc    /dev/block/mmcblk0p16 (null) 0 
    8. #  6 /recovery-bak   ext4   /dev/block/mmcblk0p17 (null) 0 
    9. #  7 /sdcard        vfat    /dev/block/mmcblk1p1 /dev/block/mmcblk1 0 
    10. #  8 /system        ext4    /dev/block/mmcblk0p12 (null) 0 

     

    updater-script 的局限 updater-script 的局限是,所有内容需要打包在update.zip内。如果要操作其他内容。需要busybox的cp命令。

    打包update.zip

    将上面的三个目录压缩到一个update.zip文件。然后用下面的命令

    1. java -Xmx2048m -jar  ../signapk.jar -w  ../testkey.x509.pem  ../testkey.pk8 
    2. ./update.zip  ./update-sign.zip 

     

     


    其中signapk.jar在src/out/host/linux-x86/framework/下面

    ../testkey.x509.pem 和./testkey.pk8 是你系统的签名私钥和公钥文件。系统默认使用testkey。这个文件位置在:


    /src/build/target/product/security/


    执行升级 把update-sign.zip 命名为updat.zip 放入/sdcard/ 从系统里面执行setting/security/update-fw

    升级日志


    升级的log日志文件在/cache/recovery/last_log 这个位置是在/bootable/recovery/recovery.c 写定的。


    典型的内容如下:


    1. Starting recovery on Mon Nov 21 02:44:11 2011 
    2. starting recovery main func. 
    3. framebuffer: fd 4 (1920 x 1080) 
    4. recovery filesystem table 
    5. ========================= 
    6.   0 /tmp ramdisk (null) (null) 0 
    7.   1 /boot emmc /dev/block/mmcblk0p8 (null) 0 
    8.   2 /cache ext4 /dev/block/mmcblk0p15 (null) 0 
    9.   3 /data ext4 /dev/block/mmcblk0p13 (null) 0 
    10.   4 /persist ext4 /dev/block/mmcblk0p14 (null) 0 
    11.   5 /misc emmc /dev/block/mmcblk0p17 (null) 0 
    12.   6 /recovery emmc /dev/block/mmcblk0p18 (null) 0 
    13.   7 /sdcard vfat /dev/block/mmcblk1p1 /dev/block/mmcblk1 0 
    14.   8 /system ext4 /dev/block/mmcblk0p12 (null) 0 
    15.  
    16. write_file_with_value: file_name=/sys/module/misc_gpio/parameters/uart2_rx_cfg, value=1 
    17. read_value_from_file: file_name=/sys/module/misc_gpio/parameters/tv_busy, value=0 
    18. read_value_from_file: file_name=/sys/module/misc_gpio/parameters/uart2_rx_stus, value=0 
    19. TV_BUSY and UART_RX at high state. Enter recoverying... 
    20. write_file_with_value: file_name=/sys/module/misc_gpio/parameters/uart2_tx_cfg, value=0 
    21. write_file_with_value: file_name=/sys/module/misc_gpio/parameters/qc_busy, value=1 
    22. write_file_with_value: file_name=/sys/module/misc_gpio/parameters/uart2_tx_write, value=1 
    23. I:Boot command: reset-device-info 
    24. before update_package = /sdcard/update.zip 
    25. after update_package = /sdcard/update.zip 
    26. Command: "/sbin/recovery" "--update_package=/sdcard/update.zip" 
    27.  
    28. ro.secure=0 
    29. ro.allow.mock.location=1 
    30. ro.debuggable=1 
    31. ro.build.fingerprint=qcom/msm8660_surf/msm8660_surf:3.2.1/LE111116/eng.liuhongchao.20111116.162249:eng/test-keys 
    32. ro.emmc=1 
    33. init.svc.recovery=running 
    34. init.svc.adbd=running 
    35.  
    36. Finding update package... 
    37. I:Update location: /sdcard/update.zip 
    38. Opening update package... 
    39. I:1 key(s) loaded from /res/keys 
    40. Verifying update package... 
    41. I:verify_file returned 0 
    42. Installing update... 
    43. /tmp/update_binary exist, delete it first 
    44. liuhongchao-- Verifying current system... 
    45. liuhongchao-- Removing unneeded files... 
    46. liuhongchao-- Patching system files... 
    47. minzip: Extracted file "/system/app/getOTA.apk" 
    48.  
    49. minzip: Extracted file "/system/xbin/busybox" 
    50. liuhongchao-- Unpacking new files... 
    51. liuhongchao-- umount system   
    52. script result was [/system] 
    53. after install_package func, install status = 0 . 

    前半部是分区表。中间的是build.prop文件。系统默认的需要验证ro.build.fingerprint,我们这里忽略。

    你可以看到有我们打印的日志

    常见错误

    看last_log

    mount error

    注意问题
    :updater-script 有些旧版本的命令不支持。具体的命令映射在src/bootable/recovery/roots.c

    http://www.linuxidc.com/Linux/2012-01/52661p2.htm
  109. http://topic.csdn.net/u/20110616/11/33d4e95b-17a3-497c-9e83-1b6947364562.html
http://www.freeyourandroid.com/guide/introdution_to_edify An introduction to the Edify (Updater-Script) language
最近在学习ROM定制,在Updater-Script语法上花了很多时间,找了不少资料,都不是很完整。
后来无意中找到一篇英文文档,就整理了一下,必进行了翻译。
原地址:http://www.freeyourandroid.com/guide/introdution_to_edify
水平有限,难免有误,请高手们见笑。
详细内容如下:

Edify语法简介(Updater-Script) 翻译:Kawvin

这是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代表用户为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脚本文件


函数名称: ifelse

函数语法: ifelse(condition, truecondition, falsecondition)

参数详解: condition----------------要运算的表达式

Truecondition-----------当值为True时执行的 Edify脚本块

Falsecodnition-----------当值为False时执行的 Edify脚本块

作用解释: 这是If-then结构的 Edify脚本语言。在真条件或非条件下语句可以是单条Edify命令或者脚本块。脚本块可以用圆括号来界定,用分号来隔开。

函数示例:


函数名称: abort

函数语法: abort()

参数详解: 没有参数

作用解释: 中止脚本执行

函数示例:


函数名称: assert

函数语法: assert(condition)

参数详解: condition---------------boolean

作用解释: 如果condition参数的计算结果为False,则停止脚本执行,否则继续执行脚本

函数示例: assert(package_extract_file("boot.img","/tmp/boot.img"),write_raw_image("/tmp/boot.img","boot"),delete("/tmp/boot.img"))

执行package_extract_file,如果不返回错误则执行write_raw_image,如果write_raw_image不出错则执行delete




上传之后,格式有点乱,请下载原始的Word文件:
http://bbs.fengbao.com/forum.php?mod=attachment&aid=OTUzOTUwfDViZDMzZTM4OWNmNDgxNzgzZDkxODIzNGE1ZDhjZTExfDEzMjg2ODU5OTY%3D&request=yes&_f=.rar
http://products.mobileuncle.com/thread-69501-1-1.html
 类似资料: