Android OTA升级详细流程分析(non-AB)

一、.ota_from_target_files.py分析

 


https://xueqiu.com/7883036826/168223386
https://xueqiu.com/7883036826/168223386?55333
https://xueqiu.com/7883036826/168223386?dtfnf
https://xueqiu.com/7883036826/168223386?NznFD
https://xueqiu.com/7532435821/168223387
https://xueqiu.com/7532435821/168223387?99717
https://xueqiu.com/7532435821/168223387?rjfhn
https://xueqiu.com/7532435821/168223387?p1nz7
https://xueqiu.com/7883036826/168223388
https://xueqiu.com/7883036826/168223388?73371
https://xueqiu.com/7883036826/168223388?xzjdp
https://xueqiu.com/7883036826/168223388?vF1N9
https://xueqiu.com/7532435821/168223389
https://xueqiu.com/7532435821/168223389?26040
https://xueqiu.com/7532435821/168223389?qcogq
https://xueqiu.com/7532435821/168223389?2cGY6
https://xueqiu.com/7883036826/168223395
https://xueqiu.com/7883036826/168223395?24248
https://xueqiu.com/7883036826/168223395?siicy
https://xueqiu.com/7883036826/168223395?km202
https://xueqiu.com/7532435821/168223396
https://xueqiu.com/7532435821/168223396?95135
https://xueqiu.com/7532435821/168223396?hlxlv
https://xueqiu.com/7532435821/168223396?jJ7D5
https://xueqiu.com/7883036826/168223400
https://xueqiu.com/7883036826/168223400?75791
https://xueqiu.com/7883036826/168223400?tbxxh
https://xueqiu.com/7883036826/168223400?nVP1l
https://xueqiu.com/7532435821/168223401
https://xueqiu.com/7532435821/168223401?17135
https://xueqiu.com/7532435821/168223401?lvlbl
https://xueqiu.com/7532435821/168223401?91H7l
https://xueqiu.com/7883036826/168223404
https://xueqiu.com/7883036826/168223404?19931
https://xueqiu.com/7883036826/168223404?vjbtl
https://xueqiu.com/7883036826/168223404?5vVt1
https://xueqiu.com/7532435821/168223405
https://xueqiu.com/7532435821/168223405?24282
https://xueqiu.com/7532435821/168223405?cscek
https://xueqiu.com/7532435821/168223405?WG26m
https://xueqiu.com/7883036826/168223408
https://xueqiu.com/7883036826/168223408?06028
https://xueqiu.com/7883036826/168223408?cusea
https://xueqiu.com/7883036826/168223408?Qm4K0
https://xueqiu.com/7532435821/168223410
https://xueqiu.com/7532435821/168223410?93973
https://xueqiu.com/7532435821/168223410?nhffr
https://xueqiu.com/7532435821/168223410?vj15b
https://xueqiu.com/7883036826/168223412
https://xueqiu.com/7883036826/168223412?59533
https://xueqiu.com/7883036826/168223412?lxrjr
https://xueqiu.com/7883036826/168223412?FP1J1
https://xueqiu.com/7532435821/168223414
https://xueqiu.com/7532435821/168223414?40044
https://xueqiu.com/7532435821/168223414?wmios
https://xueqiu.com/7532435821/168223414?qgOK2
https://xueqiu.com/7883036826/168223415
https://xueqiu.com/7883036826/168223415?66244
https://xueqiu.com/7883036826/168223415?wokgg
https://xueqiu.com/7883036826/168223415?yI60Q
https://xueqiu.com/7532435821/168223417
https://xueqiu.com/7532435821/168223417?17773
https://xueqiu.com/7532435821/168223417?xjzzr
https://xueqiu.com/7532435821/168223417?R5RvT
1.  if __name__ == '__main__':
    
2.    try:
    
3.      # common.CloseInheritedPipes()是用于在macOS环境下关闭文件描述符,
    
4.      # 通过platform.system() != "Darwin"判断是否是MacOS
    
5.      common.CloseInheritedPipes()
    
6.      main(sys.argv[1:])
    
7.    except common.ExternalError:
    
8.      logger.exception("n   ERROR:n")
    
9.      sys.exit(1)
    
10.    finally:
    
11.      common.Cleanup()
    

common.CloseInheritedPipes()是用于在macOS环境下关闭文件描述符,之后执行ota_from_target_files的主体部分代码,最后common.Cleanup()清理垃圾文件。

以下先说明common.CloseInheritedPipes()和common.Cleanup()的代码,因为它们非常简单。



1.  def main(argv):
    

3.    # 此处代码在common.ParseOptions传入
    
4.    def option_handler(o, a):
    
5.      if o in ("-k", "--package_key"):
    
6.        OPTIONS.package_key = a
    
7.      # 制作差量包
    
8.      elif o in ("-i", "--incremental_from"):
    
9.        OPTIONS.incremental_source = a
    
10.      elif o == "--full_radio":
    
11.        OPTIONS.full_radio = True
    
12.      elif o == "--full_bootloader":
    
13.        OPTIONS.full_bootloader = True
    
14.      # 清除用户数据
    
15.      elif o == "--wipe_user_data":
    
16.        OPTIONS.wipe_user_data = True
    
17.      elif o in ("-n", "--no_prereq"):
    
18.        OPTIONS.omit_prereq = True
    
19.      elif o == "--downgrade":
    
20.        OPTIONS.downgrade = True
    
21.        OPTIONS.wipe_user_data = True
    
22.      elif o == "--override_timestamp":
    
23.        OPTIONS.downgrade = True
    
24.      elif o in ("-o", "--oem_settings"):
    
25.        OPTIONS.oem_source = a.split(',')
    
26.      elif o == "--oem_no_mount":
    
27.        OPTIONS.oem_no_mount = True
    
28.      elif o in ("-e", "--extra_script"):
    
29.        OPTIONS.extra_script = a
    
30.      elif o in ("-t", "--worker_threads"):
    
31.        if a.isdigit():
    
32.          OPTIONS.worker_threads = int(a)
    
33.        else:
    
34.          raise ValueError("Cannot parse value %r for option %r - only "
    
35.                           "integers are allowed." % (a, o))
    
36.      elif o in ("-2", "--two_step"):
    
37.        OPTIONS.two_step = True
    
38.      elif o == "--include_secondary":
    
39.        OPTIONS.include_secondary = True
    
40.      elif o == "--no_signing":
    
41.        OPTIONS.no_signing = True
    
42.      elif o == "--verify":
    
43.        OPTIONS.verify = True
    
44.      elif o == "--block":
    
45.        OPTIONS.block_based = True
    
46.      elif o in ("-b", "--binary"):
    
47.        OPTIONS.updater_binary = a
    
48.      elif o == "--stash_threshold":
    
49.        try:
    
50.          OPTIONS.stash_threshold = float(a)
    
51.        except ValueError:
    
52.          raise ValueError("Cannot parse value %r for option %r - expecting "
    
53.                           "a float" % (a, o))
    
54.      elif o == "--log_diff":
    
55.        OPTIONS.log_diff = a
    
56.      elif o == "--payload_signer":
    
57.        OPTIONS.payload_signer = a
    
58.      elif o == "--payload_signer_args":
    
59.        OPTIONS.payload_signer_args = shlex.split(a)
    
60.      elif o == "--payload_signer_key_size":
    
61.        OPTIONS.payload_signer_key_size = a
    
62.      elif o == "--extracted_input_target_files":
    
63.        OPTIONS.extracted_input = a
    
64.      elif o == "--skip_postinstall":
    
65.        OPTIONS.skip_postinstall = True
    
66.      elif o == "--retrofit_dynamic_partitions":
    
67.        OPTIONS.retrofit_dynamic_partitions = True
    
68.      elif o == "--skip_compatibility_check":
    
69.        OPTIONS.skip_compatibility_check = True
    
70.      elif o == "--output_metadata_path":
    
71.        OPTIONS.output_metadata_path = a
    
72.      else:
    
73.        return False
    
74.      return True
    

76.    # 解析argv(传入的)参数,并返回所有不是标记的参数。__doc__指需要调用的模块,extra_opts和extra_long_opts都是标记,由传入者定义,它们将会交给option_handler进行处理。
    
77.    # 这一步完成之后,生成OTA脚本的所有配置应当都准备就绪了,存储在common.OPTIONS中,当前脚本有一个指向common.OPTIONS的引用,名为common.OPTIONS
    
78.    args = common.ParseOptions(argv, __doc__,
    
79.                               extra_opts="b:k:i:d:ne:t:a:2o:",
    
80.                               extra_long_opts=[
    
81.  .....
    

83.    # 如果之前处理后获得的参数不是两个,输出本脚本使用说明并退出程序
    
84.    if len(args) != 2:
    
85.      common.Usage(__doc__)
    
86.      sys.exit(1)
    

88.    # 初始化日志模块
    
89.    common.InitLogging()
    

分析如下:

主函数main是python的入口函数,我们从main函数开始看,大概看一下main函数(脚本最后)里的流程就能知道脚本的执行过程了。

    ① 在main函数的开头,首先将用户设定的option选项存入OPTIONS变量中,它是一个python中的类。紧接着判断有没有额外的脚本,如果有就读入到OPTIONS变量中。
    ② 解压缩输入的zip包,即我们在上文生成的原始zip包。然后判断是否用到device-specific extensions(设备扩展)如果用到,随即读入到OPTIONS变量中。
    ③ 判断是否签名,然后判断是否有新内容的增量源,有的话就解压该增量源包放入一个临时变量中(source_zip)。自此,所有的准备工作已完毕,随即会调用该 脚本中最主要的函数WriteFullOTAPackage(input_zip,output_zip)
    ④ WriteFullOTAPackage函数的处理过程是先获得脚本的生成器。默认格式是edify。然后获得metadata元数据,此数据来至于Android的一些环境变量。然后获得设备配置参数比如api函数的版本。然后判断是否忽略时间戳。
    ⑤ WriteFullOTAPackage函数做完准备工作后就开始生成升级用的脚本文件(updater-script)了。生成脚本文件后将上一步获得的metadata元数据写入到输出包out_zip。
    ⑥至此一个完整的update.zip升级包就生成了。生成位置在:out/target/product/tcc8800/trinket.zip。将升级包拷贝到SD卡中就可以用来升级了。
四、 Android OTA增量包update.zip的生成

1.2代码中的方法分析
显示进度条 (写入update_script) script.ShowProgress(增加百分比,持续时间)edify_generator.py

显示文字之类的 script.Print -> ui_print

显示进度条 script.ShowProgress -> show_progress

解压(写入)到指定区域 script.WriteRawImage -> package_extract_file

卸载所有分区 script.UnmountAll -> unmount

将另一个脚本的内容附加到当前脚本 script.AppendScript

二、update.zip升级包的制作

2.1 update.zip包的目录结构
          |----boot.img
          |----system/
          |----recovery/
                `|----recovery-from-boot.p
                `|----etc/
                        `|----install-recovery.sh
          |---META-INF/
              `|CERT.RSA
              `|CERT.SF
              `|MANIFEST.MF
              `|----com/
                     `|----google/
                             `|----android/
                                    `|----update-binary
                                    `|----updater-script
                             `|----android/
                                    `|----metadata
2.2 update.zip包目录结构详解
    以上是我们用命令make otapackage 制作的update.zip包的标准目录结构。
        2.2.1、boot.img是更新boot分区所需要的文件。这个boot.img主要包括kernel+ramdisk。

         2.2.2、system/目录的内容在升级后会放在系统的system分区。主要用来更新系统的一些应用或则应用会用到的一些库等等。可以将Android源码编译out/target/product/trinket/system/中的所有文件拷贝到这个目录来代替。

         2.2.3、recovery/目录中的recovery-from-boot.p是boot.img和recovery.img的补丁(patch),主要用来更新recovery分区,其中etc/目录下的install-recovery.sh是更新脚本。
         2.2.4、update-binary是一个二进制文件,相当于一个脚本解释器,能够识别updater-script中描述的操作。该文件在Android源码编译后out/target/product/trinket/system bin/updater生成,可将updater重命名为update-binary得到。
               该文件在具体的更新包中的名字由源码中bootable/recovery/install.c中的宏ASSUMED_UPDATE_BINARY_NAME的值而定。
         2.2.5、updater-script:此文件是一个脚本文件,具体描述了更新过程。我们可以根据具体情况编写该脚本来适应我们的具体需求。该文件的命名由源码中bootable/recovery/updater/updater.c文件中的宏SCRIPT_NAME的值而定。
         2.2.6、 metadata文件是描述设备信息及环境变量的元数据。主要包括一些编译选项,签名公钥,时间戳以及设备型号等。
         2.2.7、我们还可以在包中添加userdata目录,来更新系统中的用户数据部分。这部分内容在更新后会存放在系统的/data目录下。

         2.2.8、update.zip包的签名:update.zip更新包在制作完成后需要对其签名,否则在升级时会出现认证失败的错误提示。而且签名要使用和目标板一致的加密公钥。加密公钥及加密需要的三个文件在Android源码编译后生成的具体路径为:

               out/host/linux-x86/framework/signapk.jar 

               build/target/product/security/releasekey.x509.pem         

               build/target/product/security/releasekey.pk8 。

              我们用命令make otapackage制作生成的update.zip包是已签过名的,如果自己做update.zip包时必须手动对其签名。

              具体的加密方法:$ java -Xmx2048m -Djava.library.path="out/host/linux-x86/lib64" -jar out/host/linux-x86/framework/signapk.jar –w build/target/product/security/releasekey.x509.pem  build/target/product/security/releasekey.pk8 update.zip update_signed.zip
              以上命令在update.zip包所在的路径下执行,其中signapk.jar releasekey.x509.pem以及releasekey.pk8文件的引用使用绝对路径。update.zip 是我们已经打好的包,update_signed.zip包是命令执行完生成的已经签过名的包。
         2.2.9、MANIFEST.MF:这个manifest文件定义了与包的组成结构相关的数据。类似Android应用的mainfest.xml文件。
        2.2.10、CERT.RSA:与签名文件相关联的签名程序块文件,它存储了用于签名JAR文件的公共签名。
        2.2.11、CERT.SF:这是JAR文件的签名文件,其中前缀CERT代表签名者。
        另外,在具体升级时,对update.zip包检查时大致会分三步:①检验SF文件与RSA文件是否匹配。②检验MANIFEST.MF与签名文件中的digest是否一致。③检验包中的文件与MANIFEST中所描述的是否一致
2.3 Android升级包的生成过程分析

在源码根目录下执行make otapackage命令生成update.zip包主要分为两步,第一步是根据Makefile执行编译生成一个update原包(zip格式)。第二步是运行一个python脚本,并以上一步准备的zip包作为输入,最终生成我们需要的升级包。下面进一步分析这两个过程。

            第一步:编译Makefile。对应的Makefile文件所在位置:build/core/Makefile。开始会生成一个zip包,这个包最后会用来制作OTA package 或者filesystem image。先将这部分的对应的Makefile贴出来如下:
 

1.  # ----------------------------------------------------------------- 
    
2.  # A zip of the directories that map to the target filesystem. 
    
3.  # This zip can be used to create an OTA package or filesystem image 
    
4.  # as a post-build step. 
    
5.  # 
    
6.  name := $(TARGET_PRODUCT)  
    
7.  ifeq ($(TARGET_BUILD_TYPE),debug)  
    
8.    name := $(name)_debug  
    
9.  endif  
    
10.  name := $(name)-target_files-$(FILE_NAME_TAG)  
    

12.  intermediates := $(call intermediates-dir-for,PACKAGING,target_files)  
    
13.  BUILT_TARGET_FILES_PACKAGE := $(intermediates)/$(name).zip  
    
14.  $(BUILT_TARGET_FILES_PACKAGE): intermediates := $(intermediates)  
    
15.  $(BUILT_TARGET_FILES_PACKAGE):   
    
16.          zip_root := $(intermediates)/$(name)  
    

18.  # $(1): Directory to copy 
    
19.  # $(2): Location to copy it to 
    
20.  # The "ls -A" is to prevent "acp s/* d" from failing if s is empty. 
    
21.  define package_files-copy-root  
    
22.    if [ -d "$(strip $(1))" -a "$$(ls -A $(1))" ]; then   
    
23.      mkdir -p $(2) &&   
    
24.      $(ACP) -rd $(strip $(1))/* $(2);   
    
25.    fi  
    
26.  endef  
    

28.  built_ota_tools :=   
    
29.      $(call intermediates-dir-for,EXECUTABLES,applypatch)/applypatch   
    
30.      $(call intermediates-dir-for,EXECUTABLES,applypatch_static)/applypatch_static   
    
31.      $(call intermediates-dir-for,EXECUTABLES,check_prereq)/check_prereq   
    
32.      $(call intermediates-dir-for,EXECUTABLES,updater)/updater  
    
33.  $(BUILT_TARGET_FILES_PACKAGE): PRIVATE_OTA_TOOLS := $(built_ota_tools)  
    

35.  $(BUILT_TARGET_FILES_PACKAGE): PRIVATE_RECOVERY_API_VERSION := $(RECOVERY_API_VERSION)  
    

37.  ifeq ($(TARGET_RELEASETOOLS_EXTENSIONS),)  
    
38.  # default to common dir for device vendor 
    
39.  $(BUILT_TARGET_FILES_PACKAGE): tool_extensions := $(TARGET_DEVICE_DIR)/../common  
    
40.  else  
    
41.  $(BUILT_TARGET_FILES_PACKAGE): tool_extensions := $(TARGET_RELEASETOOLS_EXTENSIONS)  
    
42.  endif  
    

44.  # Depending on the various images guarantees that the underlying 
    
45.  # directories are up-to-date. 
    
46.  $(BUILT_TARGET_FILES_PACKAGE):   
    
47.          $(INSTALLED_BOOTIMAGE_TARGET)   
    
48.          $(INSTALLED_RADIOIMAGE_TARGET)   
    
49.          $(INSTALLED_RECOVERYIMAGE_TARGET)   
    
50.          $(INSTALLED_SYSTEMIMAGE)   
    
51.          $(INSTALLED_USERDATAIMAGE_TARGET)   
    
52.          $(INSTALLED_ANDROID_INFO_TXT_TARGET)   
    
53.          $(built_ota_tools)   
    
54.          $(APKCERTS_FILE)   
    
55.          $(HOST_OUT_EXECUTABLES)/fs_config   
    
56.          | $(ACP)  
    
57.      @echo "Package target files: $@"  
    
58.      $(hide) rm -rf $@ $(zip_root)  
    
59.      $(hide) mkdir -p $(dir $@) $(zip_root)  
    
60.      @# Components of the recovery image 
    
61.      $(hide) mkdir -p $(zip_root)/RECOVERY  
    
62.      $(hide) $(call package_files-copy-root,  
    
63.          $(TARGET_RECOVERY_ROOT_OUT),$(zip_root)/RECOVERY/RAMDISK)  
    
64.  ifdef INSTALLED_KERNEL_TARGET  
    
65.      $(hide) $(ACP) $(INSTALLED_KERNEL_TARGET) $(zip_root)/RECOVERY/kernel  
    
66.  endif  
    
67.  ifdef INSTALLED_2NDBOOTLOADER_TARGET  
    
68.      $(hide) $(ACP)   
    
69.          $(INSTALLED_2NDBOOTLOADER_TARGET) $(zip_root)/RECOVERY/second  
    
70.  endif  
    
71.  ifdef BOARD_KERNEL_CMDLINE  
    
72.      $(hide) echo "$(BOARD_KERNEL_CMDLINE)" > $(zip_root)/RECOVERY/cmdline  
    
73.  endif  
    
74.  ifdef BOARD_KERNEL_BASE  
    
75.      $(hide) echo "$(BOARD_KERNEL_BASE)" > $(zip_root)/RECOVERY/base  
    
76.  endif  
    
77.  ifdef BOARD_KERNEL_PAGESIZE  
    
78.      $(hide) echo "$(BOARD_KERNEL_PAGESIZE)" > $(zip_root)/RECOVERY/pagesize  
    
79.  endif  
    
80.      @# Components of the boot image 
    
81.      $(hide) mkdir -p $(zip_root)/BOOT  
    
82.      $(hide) $(call package_files-copy-root,  
    
83.          $(TARGET_ROOT_OUT),$(zip_root)/BOOT/RAMDISK)  
    
84.  ifdef INSTALLED_KERNEL_TARGET  
    
85.      $(hide) $(ACP) $(INSTALLED_KERNEL_TARGET) $(zip_root)/BOOT/kernel  
    
86.  endif  
    
87.  ifdef INSTALLED_2NDBOOTLOADER_TARGET  
    
88.      $(hide) $(ACP)   
    
89.          $(INSTALLED_2NDBOOTLOADER_TARGET) $(zip_root)/BOOT/second  
    
90.  endif  
    
91.  ifdef BOARD_KERNEL_CMDLINE  
    
92.      $(hide) echo "$(BOARD_KERNEL_CMDLINE)" > $(zip_root)/BOOT/cmdline  
    
93.  endif  
    
94.  ifdef BOARD_KERNEL_BASE  
    
95.      $(hide) echo "$(BOARD_KERNEL_BASE)" > $(zip_root)/BOOT/base  
    
96.  endif  
    
97.  ifdef BOARD_KERNEL_PAGESIZE  
    
98.      $(hide) echo "$(BOARD_KERNEL_PAGESIZE)" > $(zip_root)/BOOT/pagesize  
    
99.  endif  
    
100.      $(hide) $(foreach t,$(INSTALLED_RADIOIMAGE_TARGET), 
    
101.   mkdir -p $(zip_root)/RADIO;  
    
102.   $(ACP) $(t) $(zip_root)/RADIO/$(notdir $(t));)  
    
103.      @# Contents of the system image 
    
104.      $(hide) $(call package_files-copy-root,  
    
105.          $(SYSTEMIMAGE_SOURCE_DIR),$(zip_root)/SYSTEM)  
    
106.      @# Contents of the data image 
    
107.      $(hide) $(call package_files-copy-root,  
    
108.          $(TARGET_OUT_DATA),$(zip_root)/DATA)  
    
109.      @# Extra contents of the OTA package 
    
110.      $(hide) mkdir -p $(zip_root)/OTA/bin  
    
111.      $(hide) $(ACP) $(INSTALLED_ANDROID_INFO_TXT_TARGET) $(zip_root)/OTA/  
    
112.      $(hide) $(ACP) $(PRIVATE_OTA_TOOLS) $(zip_root)/OTA/bin/  
    
113.      @# Files that do not end up in any images, but are necessary to 
    
114.      @# build them. 
    
115.      $(hide) mkdir -p $(zip_root)/META  
    
116.      $(hide) $(ACP) $(APKCERTS_FILE) $(zip_root)/META/apkcerts.txt  
    
117.      $(hide) echo "$(PRODUCT_OTA_PUBLIC_KEYS)" > $(zip_root)/META/otakeys.txt  
    
118.      $(hide) echo "recovery_api_version=$(PRIVATE_RECOVERY_API_VERSION)" > $(zip_root)/META/misc_info.txt  
    
119.  ifdef BOARD_FLASH_BLOCK_SIZE  
    
120.      $(hide) echo "blocksize=$(BOARD_FLASH_BLOCK_SIZE)" >> $(zip_root)/META/misc_info.txt  
    
121.  endif  
    
122.  ifdef BOARD_BOOTIMAGE_PARTITION_SIZE  
    
123.      $(hide) echo "boot_size=$(BOARD_BOOTIMAGE_PARTITION_SIZE)" >> $(zip_root)/META/misc_info.txt  
    
124.  endif  
    
125.  ifdef BOARD_RECOVERYIMAGE_PARTITION_SIZE  
    
126.      $(hide) echo "recovery_size=$(BOARD_RECOVERYIMAGE_PARTITION_SIZE)" >> $(zip_root)/META/misc_info.txt  
    
127.  endif  
    
128.  ifdef BOARD_SYSTEMIMAGE_PARTITION_SIZE  
    
129.      $(hide) echo "system_size=$(BOARD_SYSTEMIMAGE_PARTITION_SIZE)" >> $(zip_root)/META/misc_info.txt  
    
130.  endif  
    
131.  ifdef BOARD_USERDATAIMAGE_PARTITION_SIZE  
    
132.      $(hide) echo "userdata_size=$(BOARD_USERDATAIMAGE_PARTITION_SIZE)" >> $(zip_root)/META/misc_info.txt  
    
133.  endif  
    
134.      $(hide) echo "tool_extensions=$(tool_extensions)" >> $(zip_root)/META/misc_info.txt  
    
135.  ifdef mkyaffs2_extra_flags  
    
136.      $(hide) echo "mkyaffs2_extra_flags=$(mkyaffs2_extra_flags)" >> $(zip_root)/META/misc_info.txt  
    
137.  endif  
    
138.      @# Zip everything up, preserving symlinks 
    
139.      $(hide) (cd $(zip_root) && zip -qry ../$(notdir $@) .)  
    
140.      @# Run fs_config on all the system files in the zip, and save the output 
    
141.      $(hide) zipinfo -1 $@ | awk -F/ 'BEGIN { OFS="/" } /^SYSTEM// {$$1 = "system"; print}' | $(HOST_OUT_EXECUTABLES)/fs_config > $(zip_root)/META/filesystem_config.txt  
    
142.      $(hide) (cd $(zip_root) && zip -q ../$(notdir $@) META/filesystem_config.txt)  
    

145.  target-files-package: $(BUILT_TARGET_FILES_PACKAGE) 
    

148.  ifneq ($(TARGET_SIMULATOR),true)  
    
149.  ifneq ($(TARGET_PRODUCT),sdk)  
    
150.  ifneq ($(TARGET_DEVICE),generic)  
    
151.  ifneq ($(TARGET_NO_KERNEL),true)  
    
152.  ifneq ($(recovery_fstab),) 
第一步:创建一个root_zip根目录,并依次在此目录下创建所需要的如下其他目录

       ①创建RECOVERY目录,并填充该目录的内容,包括kernel的镜像和recovery根文件系统的镜像。此目录最终用于生成recovery.img。

        ②创建并填充BOOT目录。包含kernel和cmdline以及pagesize大小等,该目录最终用来生成boot.img。
        ③向SYSTEM目录填充system image。
        ④向DATA填充data image。
        ⑤用于生成OTA package包所需要的额外的内容。主要包括一些bin命令。
        ⑥创建META目录并向该目录下添加一些文本文件,如apkcerts.txt(描述apk文件用到的认证证书),misc_info.txt(描述Flash内存的块大小以及boot、recovery、system、userdata等分区的大小信息)。
        ⑦使用保留连接选项压缩我们在上面获得的root_zip目录。
        ⑧使用fs_config(build/tools/fs_config)配置上面的zip包内所有的系统文件(system/下各目录、文件)的权限属主等信息。fs_config包含了一个头文件#include“private/android_filesystem_config.h”。在这个头文件中以硬编码的方式设定了system目录下各文件的权限、属主。执行完配置后会将配置后的信息以文本方式输出 到META/filesystem_config.txt中。并再一次zip压缩成我们最终需要的原始包。

第二步:上面的zip包只是一个编译过程中生成的原始包。

        这个原始zip包在实际的编译过程中有两个作用,一是用来生成OTA update升级包,二是用来生成系统镜像。在编译过程中若生成OTA update升级包时会调用一个名为ota_from_target_files的python脚本,位置在/build/tools/releasetools/ota_from_target_files。这个脚本的作用是以第一步生成的zip原始包作为输入,最终生成可用的OTA升级zip包。

㈠ 首先看一下这个脚本开始部分的帮助文档。

Usage: ota_from_target_files [flags] input_target_files output_ota_package
    -b 过时的。
    -k 签名所使用的密钥
    -i 生成增量OTA包时使用此选项。后面我们会用到这个选项来生成OTA增量包。
    -w 是否清除userdata分区
    -n 在升级时是否不检查时间戳,缺省要检查,即缺省情况下只能基于旧版本升级。
    -e 是否有额外运行的脚本
    -m 执行过程中生成脚本(updater-script)所需要的格式,目前有两种即amend和edify。对应上两种版本升级时会采用不同的解释器。缺省会同时生成两种格式的脚 本。
    -p 定义脚本用到的一些可执行文件的路径。
    -s 定义额外运行脚本的路径。
    -x 定义额外运行的脚本可能用的键值对。
    -v 执行过程中打印出执行的命令。
    -h 命令帮助

三、Recovery服务的核心方法 install_package

      和Recovery服务中的wipe_data、wipe_cache不同,install_package()是升级update.zip特有的一部分,也是最核心的部分。在这一步才真正开始对我们的update.zip包进行处理。下面就开始分析这一部分。

Android系统进行升级的时候,有两种途径:

一种是通过接口传递升级包路径自动升级(Android系统SD卡升级),升级完之后系统自动重启。

另一种是手动进入recovery模式下,选择升级包进行升级,升级完成之后停留在recovery界面,需要手动选择重启。

前者多用于手机厂商的客户端在线升级,后者多用于开发和测试人员。但不管哪种,原理都是一样的,都要在recovery模式下进行升级。

下面介绍的是升级包保存在cache目录下,且升级包路径保存在/cache/recovery/command中的方式(升级包的存放路径,从BCB或者/cache/recovery/command里面解析得到的)。
 

重启进入升级主要流程:

  1. 系统重启进入Recovery模式。读取BCB的command,读取到”boot-recovery”后,加载recovery.img,启动recovery。
  2. _在install.cpp_进行升级操作
  3. try_update_binary执行升级脚本
  4. 调用finish_recovery方法,清除BCB信息,重启

1、系统重启进入Recovery模式

    系统重启时会判断/cache/recovery目录下是否有command文件,如果存在就进入recovery模式,否则就正常启动。

    进入到Recovery模式下,将执行recovery.cpp的main函数,下面贴出关键代码片段:

1.  static Device::BuiltinAction prompt_and_wait(Device* device, int status) {
    
2.    ...
    
3.      ui->SetProgressType(RecoveryUI::EMPTY);
    

5.      size_t chosen_item = ui->ShowMenu(
    
6.  ...
    
7.      // handled in the switch statement below.
    
8.      Device::BuiltinAction chosen_action =
    
9.          (chosen_item == static_cast(RecoveryUI::KeyError::TIMED_OUT))
    
10.              ? Device::REBOOT
    
11.              : device->InvokeMenuItem(chosen_item);
    

13.      switch (chosen_action) {
    
14.        case Device::NO_ACTION:
    
15.          break;
    
16.  .....
    

18.        case Device::APPLY_ADB_SIDELOAD:
    
19.        case Device::APPLY_SDCARD:
    
20.        case Device::ENTER_RESCUE: {
    
21.          save_current_log = true;
    

23.          bool adb = true;
    
24.          Device::BuiltinAction reboot_action;
    
25.          if (chosen_action == Device::ENTER_RESCUE) {
    
26.            // Switch to graphics screen.
    
27.            ui->ShowText(false);
    
28.            status = ApplyFromAdb(device, true /* rescue_mode */, &reboot_action);
    
29.          } else if (chosen_action == Device::APPLY_ADB_SIDELOAD) {
    
30.            status = ApplyFromAdb(device, false /* rescue_mode */, &reboot_action);
    
31.          } else {
    
32.            adb = false;
    
33.            int required_battery_level;
    
34.            if(is_battery_ok(&required_battery_level)){
    
35.                status = ApplyFromSdcard(device, ui);
    
36.  ....
    
37.  ...
    
38.  } 

对上述函数的流程分析
1.bootable/recovery/recovery.cpp ShowMenu显示recovery各种菜单显示
InvokeMenuItem 表示选中的具体哪个item
2.bootable/recovery/recoveryui/device.cpp 
   

 1.   Device::BuiltinAction Device::InvokeMenuItem(size_t menu_position) {
    
2.        return g_menu_actions[menu_position].second;
    
3.      }
    
4.      static std::vector> g_menu_actions{
    
5.        { "Reboot system now", Device::REBOOT },
    
6.        { "Reboot to bootloader", Device::REBOOT_BOOTLOADER },
    
7.        { "Enter fastboot", Device::ENTER_FASTBOOT },
    
8.        { "Apply update from ADB", Device::APPLY_ADB_SIDELOAD },
    
9.        { "Apply update from SD card", Device::APPLY_SDCARD },
    
10.        { "Wipe data/factory reset", Device::WIPE_DATA },
    
11.        { "Wipe cache partition", Device::WIPE_CACHE },
    
12.        { "Mount /system", Device::MOUNT_SYSTEM },
    
13.        { "View recovery logs", Device::VIEW_RECOVERY_LOGS },
    
14.        { "Run graphics test", Device::RUN_GRAPHICS_TEST },
    
15.        { "Run locale test", Device::RUN_LOCALE_TEST },
    
16.        { "Enter rescue", Device::ENTER_RESCUE },
    
17.        { "Power off", Device::SHUTDOWN },
    
18.      };

  我们一般选择从sdcard选择升级,故选择Apply update from SD card 对应的device type是APPLY_SDCARD
   走到ApplyFromSdcard方法,其中ApplyFromSdcard是在bootable/recovery/install/fuse_sdcard_install.cpp中定义的  代码如下:
int ApplyFromSdcard(Device device, RecoveryUI ui) {
  .........    result = install_package(FUSE_SIDELOAD_HOST_PATHNAME, false, false, 0 /retry_count/, ui);
    break;
  }
 其中最为关键的方法就是install_package(bootable/recovery/install/install.cpp) 最终执行的是
really_install_package
 

 1.   static int really_install_package(const std::string& path, bool* wipe_cache, bool ...
    

3.    if (needs_mount) {
    
4.      if (path[0] == '@') {
    
5.        ensure_path_mounted(path.substr(1));
    
6.      } else {
    
7.        ensure_path_mounted(path);
    
8.      }
    
9.    }
    

11.    // Verify package.验证签名
    
12.    if (!verify_package(package.get(), ui)) {
    
13.      ...
    
14.    }
    

16.    // Try to open the package.打开升级包 
    
17.    ZipArchiveHandle zip = package->GetZipArchiveHandle();
    
18.      ....
    

20.    // Additionally verify the compatibility of the package if it's a fresh install.
    
21.    if (retry_count == 0 && !verify_package_compatibility(zip)) {
    
22.     .....
    
23.  . // 执行升级脚本文件,开始升级
    
24.    int result =
    
25.        try_update_binary(path, zip, wipe_cache, log_buffer, retry_count, max_temperature, .
    
26.  }

try_update_binary执行升级脚本



1.  // If the package contains an update binary, extract it and run it.
    
2.  static int try_update_binary(const std::string& package, ZipArchiveHandle zip, bool* wipe_cache,
    
3.                               std::vector* log_buffer, int retry_count,
    
4.                               int* max_temperature, RecoveryUI* ui) {
    
5.    std::map metadata;
    
6.    if (!ReadMetadataFromPackage(zip, &metadata)) {
    
7.      LOG(ERROR) << "Failed to parse metadata in the zip file";
    
8.      return INSTALL_CORRUPT;
    
9.    }
    

11.    bool is_ab = android::base::GetBoolProperty("ro.build.ab_update", false);
    
12.    // Verifies against the metadata in the package first.
    
13.    if (int check_status = is_ab ? CheckPackageMetadata(metadata, OtaType::AB) : 0;
    
14.        check_status != 0) {
    
15.      log_buffer->push_back(android::base::StringPrintf("error: %d", kUpdateBinaryCommandFailure));
    
16.      return check_status;
    
17.    }
    
18.  .......
    

20.    std::vector args;
    
21.    if (int update_status =
    
22.            is_ab ? SetUpAbUpdateCommands(package, zip, pipe_write.get(), &args)
    
23.                  : SetUpNonAbUpdateCommands(package, zip, retry_count, pipe_write.get(), &args);
    

25.  ......
    

27.    return INSTALL_SUCCESS;
    
28.  }
    

通过获取设备ro.build.ab_update信息获得  是否为AB动态分区   如果是AB分区升级(update_engine)进入CheckPackageMetadata 判断当前版本信息(版本号 系列号 fingerprint等)与目标版本信息是否匹配  否则fail
最终AB分区调用SetUpAbUpdateCommands  非AB分区升级调用SetUpNonAbUpdateCommands
 其中SetUpAbUpdateCommands  其实就是调用update_engine完成升级
*cmd = {
    "/system/bin/update_engine_sideload",
    "--payload=file://" + package,
    android::base::StringPrintf("--offset=%ld", payload_offset),
    "--headers=" + std::string(payload_properties.begin(), payload_properties.end()),
    android::base::StringPrintf("--status_fd=%d", status_fd),
  };
 

OTA升级成功,清空misc分区(BCB置零),并将保存到内存系统的升级日志/tmp/recovery.log保存到/cache/recovery/last_log。重启设备进入Main System,升级完成。

四 recovery升级过程中log调试方法

 

有客户反馈不知道如何调试recovery,在这里介绍下recovery的调试方法。

  1. 如何在recovery模式使用adb

在recovery模式下,init程序加载的rc文件是bootable/recovery/etc/init.rc。



1.  service adbd /sbin/adbd recovery
    
2.      disabled
    

4.  # Always start adbd on userdebug and eng builds
    
5.  on property:ro.debuggable=1
    
6.      write /sys/class/android_usb/android0/enable 1
    
7.      start adbd
    

这里可以看到如果是在userdebug或者eng编译模式,adbd服务是启动的。执行adb shell时提示不存在system/bin/sh,因为这个时候recovery/root/system为空,并没有sh程序可执行。

虽然adb shell不能执行,但adb的其他很多命令都是能够使用的。

adb devices

adb push/pull

  1. 如何增加log

在recovery的代码中能看到有两种方式添加的打印信息:printf和UI->Print。

printf输出到stdout好理解,UI->Print调用screen_ui的print函数,将信息显示在屏幕上。



1.  void ScreenRecoveryUI::Print(const char *fmt, ...)
    
2.  {
    
3.      char buf[256];
    
4.      va_list ap;
    
5.      va_start(ap, fmt);
    
6.      vsnprintf(buf, 256, fmt, ap);
    
7.      va_end(ap);
    

9.      fputs(buf, stdout);
    

除了显示在屏幕上,也将信息输出到了stdout标准输出。

  1. 标准输出信息在哪


1.  int
    
2.  main(int argc, char **argv) {
    

4.      // If these fail, there's not really anywhere to complain...
    
5.      freopen(TEMPORARY_LOG_FILE, "a", stdout); setbuf(stdout, NULL);
    
6.      freopen(TEMPORARY_LOG_FILE, "a", stderr); setbuf(stderr, NULL);
    

recovery.cpp的main函数中,最开始就将stdout的输出信息保存在了/tmp/recovery.log文件中。也就是说我们需要查看的log信息都在这里。

再看看recovery结束时做了什么



1.  static void
    
2.  finish_recovery(const char *send_intent) {
    
3.      // Copy logs to cache so the system can find out what happened.
    
4.      copy_log_file(TEMPORARY_LOG_FILE, LOG_FILE, true);
    
5.      copy_log_file(TEMPORARY_LOG_FILE, LAST_LOG_FILE, false);
    
6.      copy_log_file(TEMPORARY_INSTALL_FILE, LAST_INSTALL_FILE, false);
    
7.      chmod(LOG_FILE, 0600);
    
8.      chown(LOG_FILE, 1000, 1000);   // system user
    
9.      chmod(LAST_LOG_FILE, 0640);
    
10.      chmod(LAST_INSTALL_FILE, 0644);
    

将"/tmp/recovery.log"拷贝到了"/cache/recovery/last_log"。

  1. 如何查看log

1)如果能使用adb,在recovery模式下就能使用adb pull出log信息

adb pull /tmp/recovery.log .

2)即使adb服务不能使用,前一次recovery的log也会保存到cache/recovery目录下,在reboot正常进入系统后pull 出来查看。

adb pull /cache/recovery/last_log .

cache/recovery/last_install保存的是最后一次更新的OTA包。
 

eng 版本 如何在recovery mode下抓取LOG

[SOLUTION]

1、在recovery mode下,升级动作之后 adb pull /tmp/recovery.log

如果是KK之前版本:

2、在nomal mode下 adb pull /cache/recovery/last_log

如果是KK版本:

2、在nomal mode下 adb pull /cache/recovery/last_log_r

此两种方法均可

如果是user版本:

In recovery mode

目前没有办法在user版本也看到recovery.log,目前的办法是

直接用eng版本的recovery.img替换user版本的recovery.img,然后抓取log。

Reboot to normal mode

    在user版本也会产生/cache/recovery/last_log,但是可能会不能用adb pull出来!目前的办法是做完recovery,reboot到normal mode后,重新烧boot.img,用eng版本的boot.img替换user 版本的boot.img,然后将log pull出来!

你可能感兴趣的:(android,ota)