Incremental Updates

From The XDAndroid Project
Jump to: navigation, search

Several components of the XDAndroid system are updated continuously as development progresses. To facilitate more widespread testing and easier development, the project has created a few build services for those components.

Advanced users may download live-updated versions of those components to follow development and test changes as they occur.

These updates are intended to be performed at some point after a full installation. For information regarding full system installation, please see the Installation Guide.

zImage Updates

Live kernel builds are available from the kernel build service (alternate mirror location). These builds are packaged as bzip2 tarballs and can be unpacked with the Unix tar utility or the 7-Zip program on Windows.

To install a kernel update, unpack the tar.bz2 package into the directory where you run HaRET.exe from - or the root of the SD, if that's where you run HaRET from... This will create new zImage_VERSION and modules-VERSION.tar.gz files in that directory (where VERSION is the new version number).

At this point, you may do either one of the following:

  • Edit the startup.txt to change the line set KERNEL zImage to set KERNEL zImage_VERSION, OR
  • Delete the original zImage file and rename the new zImage_VERSION file to zImage. Delete the original modules-VERSION.tar.gz file to avoid any confusion as to which modules go to which kernel. The kernel must match the modules, or several advanced features will not work - the main one being wifi.

Note - Do NOT rename the modules-VERSION.tar.gz, or extract it. Only rename zImage, to zImage.

The latter method is recommended - to prevent confusion. The new kernel and modules can now be used by rebooting into XDAndroid.

rootfs Updates

The rootfs builds are available from the rootfs build service. These builds are packaged as common Zip files.

To install a rootfs update, unpack the Zip package into your MicroSD card's andboot directory. This will create a new rootfs-VERSION.img file.

Delete the original rootfs.img file. Rename the new rootfs-VERSION.img file to rootfs.img.

The new rootfs can now be used by rebooting into XDAndroid.

initrd Updates

New initrd.gz builds are rare. The image should be quite stable, so few updates are expected. Updates are available from the initramfs build service. These builds are packaged as gzip files and do not need to be unpacked.

After downloading an initrd-VERSION.gz update (where VERSION is the new version number), you may do either one of the following:

  • Edit the startup.txt file to change the line set initrd initrd.gz to set initrd initrd-VERSION.gz, OR
  • Delete the original initrd.gz file and rename the new initrd-VERSION.gz file to initrd.gz

The later method is recommended - to prevent confusion. The new initrd can now be used by rebooting into XDAndroid