[Guide] How To Create Recovery Flashable .zips / update.zips

Search This thread

demkantor

Inactive Recognized Contributor
Nov 10, 2011
6,861
3,763
mpls
Introduction
Hello Again! I have decided to make a series of tutorials for the XDA-University posted into this forum.
These guides will be geared toward the novice but will involve tips and instructions I hope seasoned users will find helpful as well.

Current list of guides
Fastboot Installation and Usage

All of my guides are to be considered a work in progress, only because I never consider any guide complete and will continue to update and answer questions for a long time to come.

What To Expect From This Guide
The basics on how to create a .zip to be flashed in recovery
*This will include a series of commands executed in the updater-script
And of course this means you will learn at least some basics of Edify, the basic script you will write these commands in.
I also will be adding a short section on Aroma Installer but am willing to answer questions on it use as well.

This Guide will be for Linux and Windows (Sorry Apple fanboys, not trying to be a jerk but I got to stick to my principles)

**As always I encourage questions as I am not always clear and I can easily overlook something.
 

demkantor

Inactive Recognized Contributor
Nov 10, 2011
6,861
3,763
mpls
What Is an update.zip?

Although this guide will cover the basics, I hope you don't need an answer to this question. I am to go over how to make one starting with some basics you will need to understand.

File Structure
There aren't many ways to setup the basic file structure and I have included a sample.zip for you to use. I find looking at one is the easiest way to understand.
To create your own it is as simple as creating a new folder named whatever you would like. Inside this folder create another new folder named exactly
Now inside this folder you will create another folder named
Now another folder named
And lastly one more folder within it named
Here inside the android folder you will have two files, these need to be named exactly again
and
The update-binary is best to be taken from the latest OTA update from your device, chances are you are not the first to make a ROM or mod or whatever else needs to be flashed in recovery
So feel free to take this from one of those as well (these by in large are not custom made by a dev and no permission should be needed)
Structure of your update.zip should be as such:
update/META-INF/com/google/android and in this last folder will be the two scripts.
example.png


Edify

This is the language used in the scripts we are writing, It is simple, straight forward, and much more forgiving then Java for example.
This is the syntax we will use in the updater-script, the update-binary will not be edited and only will need to be copy and pasted. It is best to seek out the latest for your device
The next post will be filled with samples of commands you can use in your updater-script that will perform various functions to your device

Tools Needed
There is no heavy computing here, old and new computers alike can handle this sort of task. I have made update.zips in both Linux and Windows with both super fast and terribly slow machines.
No I will not go over how to create your ROM or mod or whatever you are attempting to flash to your phone, I am only going to explain how to flash it.
So the list of tools needed is very small for the basics here.

Windows
I highly recommend using 7zip but yes there are other options
Another must have will be notepad ++, This really should have a tutorial for itself but I'll help with the basics
There are many tools to sign and i have just used THIS ONE forever so I'll recommend this, there are however easier ones that allow you to right click a file to sign it.
Which is amazing and I use one for my Linux box, now that I'm writing this maybe its time I change my windows one... to THIS MAYBE?
Also be sure to have the latest Java installed found HERE
And really that should cover us, there are lots of helpful apps and programs to make life easier but this will do just fine!

Linux
There are loads of tools I can recommend and variations on each one, so I will just list a few must haves to make your basic update.zip
There is a 7zip variant for Linux, use the terminal and type:
Code:
sudo apt-get install p7zip
Now you can use gedit as your text editor or i personally like Sublime Text there is a Windows compatible version too that i have yet to check out.
And we need to sign these .zips, for Linux i use This One created by Amon_RA
You will need to add this script to your nautilus script directory and name it sign
Code:
#!/bin/sh
# Update the Loc var to where YOU stored the testsign.jar file !

Loc=/home/demkantor/adt-bundle-linux-x86_64-20130219/sdk/tools

for arg
do

java -classpath "$Loc"testsign.jar testsign "$arg" "$arg"-signed
gdialog --title "signapk" --msgbox ""$arg"-signed created" 200 200

done
Be sure to change Loc=/home/demkantor/adt-bundle-linux-x86_64-20130219/sdk/tools to the proper path as yours will be different.

*note* in 13.04 this is moved to ~/.local/share/nautilus/scripts/ but in previous Ubuntu releases it was in ~/.gnome2/nautilus-scripts
This had me pulling my hair out and looking for a nice new tool and am currently trying THIS OUT (the old way still works though)

Also get the most up to date Java, from a terminal type
Code:
sudo add-apt-repository ppa:webupd8team/java
sudo apt-get update
sudo apt-get install oracle-java7-installer
sudo update-java-alternatives -s java-7-oracle
*If doing lots of android development you may want to look into an older java version... but thats another story, see a guide on developing if thats your bag


So now you understand the basics, you have all the tools you need, got may sample.zip and are ready to learn how to.
The next post be available commands to use in your updater-script

*See post #12 to understand a common problem people (sometime even myself) make with the sample.zip below
 

Attachments

  • sample.zip
    251.6 KB · Views: 5,854
Last edited:

demkantor

Inactive Recognized Contributor
Nov 10, 2011
6,861
3,763
mpls
Let's Start!

Now We Have Our Tools And A Basic Understanding
But we need to know how to have our update.zip do what we would like!
We need to see the various functions available to us, this I copied from the XDA wiki as it is precise and simple, (Normally I wouldn't copy and paste but this is what you need exactly) I will next give examples:

Need To Know!
Syntax
The script file must use UNIX newlines as EOL.
Whitespace (space, tab, LF 0x0a, but not CR 0x0d) may be freely used.
Comments are any line prefaced with #
All commands are terminated with a semicolon. Clauses (in ifelse) may contain any number of commands, each terminated with a semicolon.
Strings are usually delimited with double quotation marks.
Numbers are really just strings and are usually not delimited.
Logical values are "t" for true or "" for false.
The comparison operators are == (string equal), != (string not equal).
The logical operators are || (logical or), && (logical and), ! (logical not).
The concatenation operator is +. (Caution: 2+2==22)
The conditional keywords if, then, else and endif operate as expected. The ifelse macro may be used instead.

Disk operations
format(type, device)
mount(type, device, mountpoint)
unmount(mountpoint)
is_mounted(mountpoint)

Image operations
write_raw_image
write_firmware_image

File operations
package_extract_file(source, destination)
package_extract_dir(source, destination)
delete(file) – deletes a file
delete_recursive(directory) – completely deletes a directory
symlink(target, link0, ...) – create any number of links to a target
set_perm(user, group, mode, file) – performs a chown, chmod on a file
set_perm_recursive(user, group, mode, directory) – performs a chown, chmod on all contents of a directory
getprop(key) – returns a string value of the associated key from the system properties
file_getprop(file, key) – returns a string value of the associated key from a specific file

Patching operations
apply_patch
apply_patch_check
apply_patch_space
run_program(program, arg0, ...)

Control
assert(condition0, ...) – aborts and prints on any false condition
abort(message)
ifelse(condition, trueclause, falseclause) – conditional, falseclause is optional

Predicates
is_substring(substring, string) – checks to see if string constains substring anywhere
less_than_int(x, y) – checks to see if x<y when considered as integers
greater_than_int(x, y) – checks to see if x>y when considered as integers

User feedback
show_progress(fraction, seconds) – advance progress bar a fractional amount over a period of seconds
set_progress(fraction) – advance progress bar a fractional amount
ui_print(message0, ...) – print any number of strings
sleep(seconds) – pause a number of seconds


Having a list of the available commands is great but we need to understand what they do, consider the above a reference point and below and understanding of the commands


How To begin the Process
First find out what you want to do, get your apps, images, what ever you are trying to do in order and then open your text editor (Windows notepad ++ and Linux gedit)
Then make sure the file structure in your folders are correct and have the update-binary specific to your device and be ready to write your updater-script
I will go deeper into the setup in a moment but for now we need to understand how to write the updater-script

Basic Usage
Often you will start this script with a ui_print(" "); to explain the purpose of the package you made. There are many ways to go about this but a simple start maybe:
Code:
ui_print("Modded Google Play App By demkantor");
This can be as complex or simple as you want and include as many lines as you would like. We just want to tell the user what is happening to their phone.
We also want to have the progress show, this will help the user know when everything will finish, especially bigger packages that can take some time, don't want people to think its stuck!
There are a couple ways to do this, I tend to use a series of set_progress(0.1); starting in the beginning and working to set_progress(1.0); when complete. you may also use time as in show_progress(fraction, seconds) choice is yours:
Code:
set_progress(0.1)
# Something going on
set_progress(0.5)
# Some more stuff is happening
set_progress(1)
# Indicates completed task
Now you may have notice I used # symbols in front of some lines, these are used to comment lines that aren't part of your script and for you and only you by and large.
Any line that begins with # will not be read by the script, here is a short example of usage:
Code:
set_progress(0.1)
ui_print("Modded Google App By demkantor");
ui_print(" ");
# Need to mount system
ui_print("mounting system partition");
set_progress(0.3)
mount("ext4", "EMMC", "/dev/block/mmcblk0p25", "/system");
# Flash modded google app
ui_print("Flashing App!");
set_progress(0.5)
package_extract_dir("system/app/com.modded.app", "/system/app");
# Don't Forget to set Permissions
ui_print("Setting Permissions");
set_progress(0.7)
set_perm(0, 0, 0644, "/system/app/ModdedGoogleApp.apk");
# Unmount system before we finish
ui_print("Unmounting System");
unmount("/system");
ui_print("You're Finished! Thanks For Using My App!");
set_progress(1)

Explaining the Above
This would be a very basic setup, and the comments, extra uiprints, and set progress are not really necessary in such a basic flash, but it will be good practice to use all this as you progress
I need to explain a few things in that script quickly:
You notices i commented out a line (# Need to mount system) and underneath a line read <mount("ext4", "EMMC", "/dev/block/mmcblk0p25", "/system");>
This will change from device to device but you need to mount your system or data or whatever to flash to it.
The first bit "ext4" is the type of file system, there are many options here but use what your phone is partitioned to.
Some common file systems: rfs yaffs2 ext2 ext3 ext4 vfat
Next is the partition type: "EMMC" or "MTD" for the most part
Next is the location of the file system; This is key as you don't want to flash an app to your EFS partition or whatever. "/dev/block/mmcblk0p25" is the system partition location for the device in this example, to find yours do this:
Open a terminal emulator on your devices and type: mount
Or
Open an adb shell and type : mount
these are just two quick and simple ways but there are many others
Last is the mount point, or name of this partition, the example above was "/system"); The more common partitions you will mount will be system and data but you can of course do others, just make sure everything matches.

You also noticed this line: # Flash modded google app , and the comment is just telling you what command you want to do next, in this case:
package_extract_dir("system/app/com.modded.app", "/system/app");
This is taking everything in the folder /com.modded.app from within the update.zip and installing it in /system/app on the device.
**Note understand if an app installed is best as a system app or userdata app**
package_extract_dir("data/app/myspecialapp", "/data/app");
this may be a more common example.

You also saw the commented line: # Don't Forget to set Permissions
and permissions that were set: set_perm(0, 0, 0644, "/system/app/ModdedGoogleApp.apk");
This set rw- r-- r-- with no special permissions to ModdedGoogleApp.apk
This is important to do as not setting the proper permissions will to allow the app to function as you intend.
If you are familiar with Linux/Unix chmod commands (change mode) then this is all we are doing. Or if you ever user Root Explorer or any other root access file manager in Android you may be familiar
If not I suggest to read up on THIS as its important to know

And The last piece in there was unmount("/system"); which I'm sure wont need any explaining.
You also notice progress and ui prints helping the user along, These were not placed well or really all too needed in such a simple script,
but I wanted you to see an example and learn to use them along with comments for yourself as your scripts become more complex.
Lets do some of this more complex stuff now!


The last chunk should have helped you understand some simple scripting, but really this is far from enough unless you are only ever planing to flash one app!
So lets dig deeper into Edify and see if we can create an ever better update.zip!


Erase Commands
Format, delete, and delete_recursive can be very helpful, I'm a huge supporter of wiping clean before flashing a new ROM and occasionally wiping cache and dalvik after.
It will be handy for you to add these functions in to lets say a ROM you made before a flash if you deem it necessary or wipe cache and dalvik after your mod.
No matter the reason you should understand how and when you should do this.
Code:
delete("/data/app/googlePlayMusic.apk");
delete("/system/app/Provision.apk","/system/app/QuickSearchBox.apk","/system/app/SetupWizard.apk");
The above is doing two things, first it is deleting a single app from data partition (googlePlayMusic.apk)
Next it is deleteing a series of apps from system partition (Provision.apk, QuickSearchBox.apk, and SetupWizard.apk)
The reasoning why you want to delete a single file or app is up to you to decide, but the above will do it easily. If you want to delete a full directory then:
Code:
delete_recursive("/system"); 
delete_recursive("/cache"); 
delete_recursive("/data");
So this is a series of three commands to delete everything in system, cache and data. You may also string them together into one command separating each with a comma.
Code:
ui_print("Formatting system");
format("ext4", "EMMC", "/dev/block/mmcblk0p25", 0);
The above will completely format and erase system, you could also do data, cache, boot, whatever. Just be careful as this will make all data unrecoverable.
You would need to unmount the partition before you run any format command
Code:
unmount("/system");
unmount("/data");
Know the partition to unmount, then know the partition to format (ie mmcbl0p25 is not always system!)
when you are ready to flash something to a partition go back and mount it (this I covered earlier)


So now we have an idea on how to use some basic commands, lets put together a couple simple scripts and try to flash them!
Once you are confident with do this we will create our own more complicated flashable .zips


Lets try something simple
So most everyone who is bothering to read this enjoys flashing ROMs and probably does this a lot. But as we all know setting up a new ROM is time consuming!
One of the first update.zips I ever wrote was to flash about 20 apps I always used and each time I flashed a new ROM I would have to redownload them or use an app like Titanium Backup to reinstall them.
I found it just far easier to make a flashable .zip and keep in on SD card so after each wipe and ROM flash I could just flash this next and all would be there.
So lets do it together!

First
Make the file structure I showed before, or download my sample.zip from previous post. If its a new folder lets name it apps2install, If you have the .zip extract contents and name the main folder apps2install.

Second
Now we need some apps, lets take a couple free apps (never share paid apps in this forum! or anywhere really) For simplicity sake lets take three apps:
ADW Launcher, Dropbox, and Pandora... all are free on the market and for simplicity sake I suggest you take these same apps.
Download from market and bring the .apks to your computer, do this with either copying them with a file explorer and saving them to sd card, then transferring to computer or I prefer to use ADB. Your choice:
*Method 1... File Explorer
Open any file explorer after downloading apps, go to /data/app , and now copy the three .apks and transfer to sd card.
Now go back to /data/app-lib and copy com.dropbox.android-1 folder to SD card
ScreenshotCombo.jpg
Once you have the 3 .apks and one app-lib, connect phone to USB and transfer to computer. Then we need to put them in proper folders, again there are multiple ways but play along for learning purposes.
FileStructure.jpg
Your file structure should now look like the above, orange is folders, green .apks, and grey files

*Important, most apps store themselves to /data partition, some need to be in /system. Some apps are downloaded to /mnt/asec and not always do libs go into data/app-lib
My point is to know where your apps are to pull them and know if there are any needed libs to make them function properly. This is on an app by app and ROM by ROM basis


*Method 2... using adb
For me adb is faster and I like the command line so if your good with adb I say go this route, if not I suggest reading up on it and then using it or use previous method
So download the apps to your phone I mentioned above, now connect phone to PC and open terminal/cmd and type
Code:
adb pull /data/app /pulled
adb pull /data/app-lib /pulled
This will pull all apps store on /data/app and all app libs stored on /data/app-lib to your PC into a folder called pulled.
If you only want to pull the apps in question the add com.dropbox.android-1 after /app and /app-lib (or whatever the app / lib is titled you want to pull)
And if you want a differemt folder to be stored on pc change the /pulled to whatever you like, maybe C:\Users\youraccount\Desktop\pulled (for windows)
Or /home/youraccount/pulled (for Linux) your choice on all this

Third
Lets write the script, I'm using notepad++ in windows here (currently booted in windows so...), use gedit or what you prefer in Linux, just be sure to write in UNIX format.
Code:
ui_print("Flasing Your First update.zip.....");
set_progress(0.1);
# Mount System Partition
ui_print("Mounting System");
mount("/system");
# Mount Data Partition
ui_print("Mounting Data");
mount("/data");
set_progress(0.3);
ui_print("Flashing Apps!");
ui_print("....");
package_extract_dir("system/app", "/system/app");
set_perm(0, 0, 0644, "/system/app/org.adw.launcher-1.apk");
package_extract_dir("data", "/data");
set_perm(0, 0, 0644, "/data/app/com.dropbox.android-1.apk");
set_perm(0, 0, 0644, "/data/app/com.pandora.android-1.apk");
ui_print("....");
set_progress(0.6);
# Set Permissions
ui_print("Setting Permissions");
set_perm_recursive(0, 0, 0755, 0644, "/system/app");
set_perm_recursive(1000, 1000, 0771, 0644, "/data/app");
set_progress(0.8);
# Unmount System & Data
ui_print("Unmounting System");
unmount("/system");
ui_print("Unmounting Data");
unmount("/data");
ui_print("****Hope You Learned Something New Today!****");
set_progress(1);
This Is an example of your updater-script, it should look similar but it does not have to be the same. Let me explain further:
The first few lines in this script we have gone over, the ui_prints and the mounts, do what you want with ui_prints and use mounts for your devices
#comments - we talked about these too, these will not be read by the script, rather for your purpose.
You also should be familiar with the set_progress, use at your will, not needed
Now you see package_extract_dir("system/app", "/system/app"); this, like before is dumping everything from system/app in your update.zip to /system/app on device
Now the permissions again, set_perm is for a single file, in this case rw- r-- r--to adw launcher, which was just flashed as a system app.

Then there is package_extract_dir("data", "/data");
This is taking everything from the data folder in your update.zip and transferring it to /data on your device.
Remember we had 2 apps and 1 lib in data, but with this one command we put all on device in proper places. We could have separated the commands, but why bother!

Speaking of why bother you may have noticed that after each transfer from update.zip to device there were permissions set at the end.
Then toward the end of this script more permissions? Why? Well, to learn!

The first command <set_perm> is for a single file and the last commands <set_perm_recursive> were for an entire directory.
So you can set up each individual app or whatever with permissions, or just change a full directory. Each case is different and you will need to asses what is best in your situation.
But yes, there was no need to do it twice here ;)

The last bit in this script is unmounting partitions and some ui_prints and set_progress, these we have covered.
And being this the end, lets move on to our next steps! (save your work!)

Forth
Now we should look over our script for errors, check for proper encoding, and make sure everything is saved to proper directory.
Once all is correct we need to zip it, I prefer 7zip but do as you please.
In windows, highlight the 3 folders (system,data,META-INF) > right click > 7zip > add to archive
sevenzipexample.jpg
Now make sure you set compression level to store, pretty much make sure it looks like pic bellow
7zipExample.png
Now that this is done, you will see your new zip (apps2install.zip) Great but it is still best to now sign this zip, but not needed depending on your recovery setup.

**Note will soon add photos for Linux (just need to reboot!)

Fifth
Signing the zip, again there are multiple ways, I will show two signing methods, one in Windows and one in Linux. Choose one of these or another method, use what works for you!

**Windows**
I am choosing to use SignApk to sign apps in windows, the link is above and why not, HERE IT IS AGAIN
Unzip it, put the contents where you want (directly on (C:) or creating a path in environmental variables is nice but unneeded)
Put the apps2install.zip in this folder then open CMD in the same location as contents and type:
Code:
java -jar signapk.jar certificate.pem key.pk8 apps2install.zip apps2install-signed.zip
And now you will see two copies (of course the one titled apps2install-signed.zip is the one to flash)
As a side note you can change apps2install-signed.zip to what you want, no need for the -signed but at first it is nice to know which is which

**Linux**
So on both my Linux boxes I use @Amon_RA's right click to sign script, but have recently been trying out another by @lithid-cm which is quite nice.
See the second post for a quick guide on how to set up and know that nautilus-scripts have moved in Ubuntu 13.04!
So simply right click on the .zip, navigate to scripts, choose sign, profit


All right! Now transfer your newly made update.zip to your recovery and give it a flash! When complete see if your new apps appear and if they work!
If all is good try your to make your own, if you get errors, post here and I'll try to help!

Happy Flashing!
 

Attachments

  • Sample2.zip
    252.9 KB · Views: 2,232
Last edited:

demkantor

Inactive Recognized Contributor
Nov 10, 2011
6,861
3,763
mpls
How To Make An Aroma Installer Package

Now it seems like every ROM or mod is flashed with aroma rather than a simple .zip, and for good reason.
Aroma is a handy tool to allow users to flash what they want, be it a ROM, kernel, Mod, whatever, it just makes things simple. Not to mention a customizable UI.
In truth this is very easy to set up and only requires a few more steps than making you standard flashable .zip, it will be only as complicated as you make it.
The best advice I have for anyone wanting to use Aroma is to download the demo from HERE and see how it works.
Then download a few other Aroma Packages to see how the file structure differs, and how the updater-script and aroma-config are used.
Here are a couple I have made for different devices, feel free to download and look them over.
An Aroma Package for any ROM for the Samsung Sidekick 4G This one flashes no ROM just basic apps and mods
Splash Screen and Bootanimation Aroma for the HTC VISION This only flashes new splash screens and Bootanimations
An Aroma Package for the HTC Vision for a specific ROM This one is ROM specific as it contains mods for only one ROM
A ROM Using Aroma To Install Various Features This one is a ROM specific to the HTC Vision that uses Aroma to customize the install

As you can see there are many ways to use Aroma to your benefit, and its up to you how to use it. I will be keeping this short but will try to help you understand the basics.
As Always i encourage questions whenever you have them! Another Great Place To Ask Questions

File Structure
So once you download any Aroma package (be it from a ROM or the demo) you should see something similar to this:
AromaFileStructure.jpg
Create any folder you need in the same level as META-INF, such as system, data, or whatever you want really. You just will need to organize it in a way to tell the updater-script where to look.

To Start
Take an update-binary from your device and rename it to update-binary-installer, replace this in the one in the aroma demo.
Now the two main files we will cover here are the aroma-config and updater-script.
Think of aroma-config as the script for how you want aroma to look and what options to flash.
Then think of the updater-script as what actually does the installation after user choose what he/she wants. This is written in the same syntax as covered before but a few extras are added.

aroma-config
Lets begin with editing the aroma-config (if using windows we need to use notepad++, in Linux use your favorite editor)
We will create something simple, an Aroma package to flash a choice between four kernels, four launchers, and four apps. (of course we could do a lot more but this will do for a start)

Lets Begin!
Open a new file in notepad++ or your Linux text editor and name it aroma-config. Or feel free to take the one in the demo package, but we are going to start fresh so make sure you are on a blank page.
The beginning should look like this
Code:
# Demo Aroma Script, Make changes accordingly.
# ---------------------------------------------
ini_set("rom_name",		"MyFirstAromaInstaller");
ini_set("rom_version",		"1.0");
ini_set("rom_author",		"demkantor");
ini_set("rom_device",		"MyDevice");
ini_set("rom_date",		"CurrentDate");
Of Course name it as you please, change the version as necessary, best to use your name over mine, use your device and add the date.
These are all variables that can be set throughout the install process and by adding this in the script you can just change date, build, etc at the top of the script rather than searching... some of my scripts are well over 1000 lines and this is a nice feature.

Ok, next lets add a blank line to separate (hit enter) and start line 9 like so
Code:
# Splash screen "3000" = "3" secs , "cyan_splash"=filename of splash png
# --------------------------------------------------------------------
splash(4000, "cyan_splash");
This will be the splash screen when aroma first starts up, I am directing it to a .png image named cyan_splash.png and have it set for 4 seconds (change accordingly)
this image is to be place in the aroma folder, in the demo there is one named sample_splash - feel free to edit this at your will

The next two chunks in the script will be for the font and theme, we aren't going to get fancy here so adding this to the script will suffice
Code:
# Font size declaration. "0" = Small Font. "1" = Big Font.
# --------------------------------------------------------
fontresload( "0", "ttf/Roboto-Regular.ttf", "12" );
fontresload( "1", "ttf/Roboto-Regular.ttf", "18" );

# Theme used for aroma interface
# ------------------------------
theme("ics");
This is to use the already made Robot font, and we have both the large and small set, then a space and we are using the premade ics theme.
If you want to change any of this feel free to use whats already in the aroma demo (look in the folders) or create your own. But for now lets move on

The first page of your aroma package should be a welcome/explanatory page. It should inform your users what the will be flashing, what device it is meant for and anything else you may want to convey.
Here is a sample and just change accordingly:
Code:
# First page info
# ---------------
viewbox("Welcome!","You are about to install <b>XXX.AromaPackage</b> for your <b>Name Of DEvice</b>, built by <b>demkantor</b>.\n\n"+
	"Proceed with the installation only if you're <b>Ready to be wowed by my amazingness!</b>\n\n"+
	"You May Leave Aroma Installation At Any Time Using The <b>Menu Button</b>.\n\n"+
		" Version: \t<b><#selectbg_g>"+ini_get("rom_version")+"</#></b>\n"+
        " Built: \t\t<b><#selectbg_g>"+ini_get("rom_date")+"</#></b>\n"+
        "\n\n"+
    "Press Next to Continue the Installation",
  
    "@welcome"
);
A couple things to note here, <b> </b> boldens the chosen text, the \n\n"+ ends the line, the @welcome tells aroma what the screen should be setup like, the viewbox( begins the code and the ); ends the code for this section.
I will go over viewbox, checkbox, and selectbox in more depth later.

Remember the ini_set variables from the beginning, this will automatically add the proper date and version to the welcome screen... nice!
And now lets add
Code:
setvar("installer_title",
       "You are about to install <b>MyAromaPackage</b> "+
       "with the following choices:");
Rename as you see fit, oh and this next piece is optional but i throw it in many of my packages, here is a good time for:
Code:
# ---------------
# Generic Warning
# ---------------
alert(
	"Warning!",
	"Please Make Sure You Know What You Are Doing And Can Recover Your Device, What You Do To Your Phone Is Your Own Choice!",
	"@alert"
);
This is a small alertbox that flashes on the users screen, you can have it say whatever you'd like and change the style, font, colors, etc. You can also add a yes/no button or view changelog, etc etc, but we're keeping this simple
On to the real codding!
Code:
# -------------------------------
# Kernel choices using selectbox.
# -------------------------------
    selectbox(
      "Kernel Choices",
      "Choose the Kernel to install to your device",
      "@personalize",
      
      "kernel_choices.prop",
      
      #------------------------------------[ selectbox With Groups ]---------------------------------#
      # TITLE            |  SUBTITLE                                                 | Initial Value #
      #------------------+-----------------------------------------------------------+---------------#

      "Kernel Choices",					"",								2,      #-- Group 1. key = "selected.1"
        "Kernel Choice 1",				"A Kernel as boot.img",				0,      #-- selected.1 = 1
        "Kernel Choice 2",				"A Kernel as zImage",				0,      #-- selected.1 = 2
        "Leave Kernel as is",			"Not Touching Kernel",				1       #-- selected.1 = 3
    );

        appendvar("installer_title", "\n\n<b>Kernel Choices</b>");
        appendvar("installer_title", iif(prop("kernel_choices.prop", "selected.1")=="1", "- Flash Kernel 1 ", ""));
        appendvar("installer_title", iif(prop("kernel_choices.prop", "selected.1")=="2", "- Flash Kernel 2 ", ""));
        appendvar("installer_title", iif(prop("kernel_choices.prop", "selected.1")=="3", "- Skip Kernel Installation ", ""));
Ok, lets explain this chunk. The first three lines you see are commented out, this is just for anyone looking at the code to know what is happening.
the next line gives us the aroma ui option of select box, this allows user to select one and only one option (as you may have guesses you don't want to flash two kernels)
It starts from selectbox( and ends the ui at );
The next line will be the header on the ui "Kernel Choices", after this an explanation in the ui "Choose the Kernel to install to your device",
and the following "@personalize", is the style aroma will use, for the most part "@personalize", will be used at all user install screens within aroma
And next we have "kernel_choices.prop", which the updater script uses to know what option the user want to flash from the category Kernel Choices

Now we have some more commented lines, again this is just for reference to make life easier
And know you see 4 more lines, the first is giving the header for the category, and the next three are the two kernel options and the third is to not flash a kernel.
"Kernel Choices", is your header "", is an empty subtitle that could be filled for added info to the user the 2, explains to aroma its the header
The #-- Group 1. key = "selected.1" is telling aroma this is the first group and to write the choice to kernel_choices.prop as selected.1
If we wanted to we could have multiple groups within this category but were keeping this small.
The two kernel choices have subtitles saying as a boot.img or zImage, I'm just giving two common options on how the kernel will be installed in the updater-script
And the three choice in this ui has #-- selected.1 = 1 or 2 or 3, these will be what is written to the kernel_choices.prop to allow the updater-script to chose the right option
As you can see the final option has a 1 instead of a 0 after it, this makes it the default selected and although not needed "do nothing options" I feel should be defaulted to
And the last two important thing that many new scripters miss are the absence of , after the 1 this is to let aroma know there are no more options and the next line will be the end of this section, signaled by );

I cant think of an easy explanation for appendvar if your unfamiliar with coding, but it is adding a string to a variable.
This is for the updater-script and will be come more clear when we get to this part. So for now copy and paste...
 
Last edited:

danyal241

Senior Member
Sep 18, 2012
581
64
Introduction
Hello Again! I have decided to make a series of tutorials for the XDA-University posted into this forum.
These guides will be geared toward the novice but will involve tips and instructions I hope seasoned users will find helpful as well.

Current list of guides
Fastboot Installation and Usage

All of my guides are to be considered a work in progress, only because I never consider any guide complete and will continue to update and answer questions for a long time to come.

What To Expect From This Guide
The basics on how to create a .zip to be flashed in recovery
*This will include a series of commands executed in the updater-script
And of course this means you will learn at least some basics of Edify, the basic script you will write these commands in.
I also will be adding a short section on Aroma Installer but am willing to answer questions on it use as well.

This Guide will be for Linux and Windows (Sorry Apple fanboys, not trying to be a jerk but I got to stick to my principles)

**As always I encourage questions as I am not always clear and I can easily overlook something.

I consider myself a complete noob I just know how to root and install roms kernals etc. I want to learn how to create roms so will be waiting for your guides ...
 
  • Like
Reactions: demkantor

demkantor

Inactive Recognized Contributor
Nov 10, 2011
6,861
3,763
mpls
Well I'm glad to know I'm wanted :D
Learning to make your own modifications, kernel, ROMs, whathaveyou can get to be tricky. I would really recommend to start real small
start with some easy stuff like take a ROM you like in a .zip, extract it, and dig through each folder so you see what types of things are in there.
Grab an app and do the same thing, don't bother to decomplie it just use 7zip or something to extract its contents and just peer.
Learn some coding, code.org and code academy is great for simple stuff, I just love Marakana TechTV (a Youtube channel)

When you get your head around the simple things, try a small task, don't try to
here is some sage advice from one of the top dev's ever Read

I'm not saying this to stop or slow you down, just want to say be ready to do a lot (seriously a lot) of reading and research and be ready to fail a few times for sure. I am more to teach you what i know but I cant say I'm an expert in android coding, but as always, ask questions and ill do my best to answer!
 

They Drew First Blood

Senior Member
Aug 27, 2011
369
240
Re: basic update.zip

set_progress(0.1)
# Something going on
set_progress(0.5)
# Some more stuff is happening
set_progress(0.1)
# Indicates completed task

Thank you for delving into the basics of Edify- would you clarify here on the set_progress command? In both examples your final set_progress contains a value of (0.1) - should we be setting this to (1.0) as you mentioned above? Thanks again, great writeup!
 
  • Like
Reactions: demkantor

demkantor

Inactive Recognized Contributor
Nov 10, 2011
6,861
3,763
mpls
Ahh and only if I could write an edify script to edit my guide! Thanks for catching that and yes it should read 1.0, ill change as soon as I can get back to it.
I'm getting married in a few weeks so although I'm on spring brake from college I still need to find the time to finish these guides, usually late at night! But expect a much more comprehensive write up as well as edit guide!

Sent from my RubiX NonSense using xda app-developers app
 

DZYR

Senior Member
Jan 25, 2011
111
29
Bruxelles, Belgium
Thanks

Great clear & concise guide on How to create Recovery Flashable .zips.
I am definitely going to give this a go.
I always need to push several apks to /data/apps after flashing a new ROM and have been using TiBu for this.
But, will give me immense satisfaction if I could write my own script and create a flashable zip for these apks.

Thanks once again! :laugh:

PS: All the best for your wedding! :good:
 
  • Like
Reactions: demkantor

demkantor

Inactive Recognized Contributor
Nov 10, 2011
6,861
3,763
mpls
oops!

So I had a little more time to add to this guide, still lots more to cover! and i plan to overhaul and edit it to a more readable/searchable format once its more complete
(never complete in my mind - but still...)
I did notice that the sample.zip in the second post is flawed, come on 30 some downloads and no one caught it? :p
My bad though, when I zipped it I did it wrong as you can see there is an extra folder that should not be there, if you're not sure what I mean by this, see the third post for sample2.zip
Pretty much I just zipped the sample folder rather than its contents inside.

I will leave the original there so people can see the mistake (so you dont do it to!)
as always,
Happy Flashing!
 
  • Like
Reactions: chayes627

KidCarter93

Retired Forum Moderator
Mar 26, 2012
14,587
7,732
30
Coventry, UK
Hi,

I've got a kind of related question and this actually seems like an ideal place to ask it.

Recently I took an existing boot animation from an older phone so that I could have it on my HTC One. As the resolution of my phone is bigger, I took apart the boot animation and resized all the images and edited the desc.txt file to make it compatible. I replaced the default boot animation with the new resized one and it worker great.
I then decided it would be easier to make it flashable so that other members wouldn't need to mess around with moving the file to a certain place for it to work. This is where the problem starts.
I don't have access to a computer so I tried used jrummy's app ZIPme to make the animation flashable. It said it had installed but in fact it hadn't.

So how could I successfully turn it into a flashable zip direct from my phone?

Also a secondary question.
With the One (not sure if other phones are the same) you need to specify the path to which the boot animation will be saved to. As different ROMs have the boot animation located in different places, I asked a few people how I could make it flash across all ROMs. I got told that I'd need to specify it in the updater script.
So, would I simply be able to copy the updater script from another boot animation for this phone or will that not work?

Apologies for the longer than expected post. It's just that this side of Android is new to me :)


SGS2 FAQ | HTC One FAQ
 

demkantor

Inactive Recognized Contributor
Nov 10, 2011
6,861
3,763
mpls
@KidCarter93
Hey I saw you asking in the other thread and was going to chime in but others beat me to it and you stopped posting so i assumed it was all figured out.
correct, the updater script will put the boot animation were you tell it, its up to you to know where the phone keeps it.
an option may be to send it to multiple locations within the script provided the other installs wont harm anything, i guess i would have to know each location you are thinking of to answer this fully.
a common place (at least across the androids i use) would be /system/media so the script would look like
package_extract_dir("system/media/com.android.bootanimation-googlegears", "/system/media");
set_perm(0, 0, 0644, "/system/media/bootanimation.zip");
or whatever you have it called and what folder you have it in.
If you would like me to look at the script you are writing I'd be glad to, This guide is taking me forever to write as i have too many projects and too little time, but bootanimations will be covered as some update.zip options.
feel free to pm me If you need a hand further than whats above, ill be around for a while yet tonight!


Edit
somehow I missed the part where you asked if you could do it with your phone, and I'm sure there is an for it somewhere, just never tried... Actually I saw a post on g+ not long ago about someone looking for testers for one, I'll see if I can dig up the link for you, otherwise send me the file and tell me where its located etc and I'll make one for you, only takes a min or two

edit 2
NEVER TRIED THIS but who knows, it may be what youre looking for
im about to hit the shower quick, but ill be around for another hour or so before i need to sleep, if you want me to make the zip for you just let me know
 
Last edited:

KidCarter93

Retired Forum Moderator
Mar 26, 2012
14,587
7,732
30
Coventry, UK
Edit
somehow I missed the part where you asked if you could do it with your phone, and I'm sure there is an for it somewhere, just never tried... Actually I saw a post on g+ not long ago about someone looking for testers for one, I'll see if I can dig up the link for you, otherwise send me the file and tell me where its located etc and I'll make one for you, only takes a min or two

edit 2
NEVER TRIED THIS but who knows, it may be what youre looking for
im about to hit the shower quick, but ill be around for another hour or so before i need to sleep, if you want me to make the zip for you just let me know
Well most of the ROMs store it in system/media but the stock based ROMs I've tried store it in system/customize/resource. As far as I'm aware there aren't any other locations though.

That g+ post you linked to is the one that I mentioned, ZIPme. It works for other files but didn't seem to work for this for some reason. I might have to contact him and see if I went wrong anywhere.

Yeah it would be great if you could do it for me. Here's the zip - http://d-h.st/xo6


SGS2 FAQ | HTC One FAQ
 

demkantor

Inactive Recognized Contributor
Nov 10, 2011
6,861
3,763
mpls
haha, like it, will make one for me too!
do you have system mount points for me and an update-binary for your phone?
eh, ill see if i can dig them up...

edit
damn...just a bit to big to post on xda... link coming

edit 2
@KidCarter93 - hope you like it!
XDA-Bootanimation-signed.zip - 18.99 MB
of course i don't have this phone so i would recommend testing it before you publish it, but it should work with any ROM for your phone... let me know
 
Last edited:
  • Like
Reactions: KidCarter93

KidCarter93

Retired Forum Moderator
Mar 26, 2012
14,587
7,732
30
Coventry, UK
I'm currently getting the following in recovery:

Installing XDA Bootanimation. . .
set_perm: some changes failed
E : Error in /sdcard/0/download/XDA-Bootanimation-signed.zip
(Status 7)
Installation aborted.


SGS2 FAQ | HTC One FAQ
 

demkantor

Inactive Recognized Contributor
Nov 10, 2011
6,861
3,763
mpls
Is system/customize/resource a folder on your phone? If so can you give me what permissions it uses? I'm guessing the chmod is wrong for that section.
If you are using a ROM that has bootanimation in /system/media then extract the zip and go to the updater script and comment out the two lines about /system/customize/resources
Then rezip and sign and see if it will flash

Sent from my Nexus 7 using xda premium

Edit: @KidCarter93
were you able to get it to work? if not i have some ideas that may help
 
Last edited:
  • Like
Reactions: KidCarter93

KidCarter93

Retired Forum Moderator
Mar 26, 2012
14,587
7,732
30
Coventry, UK
Apologies for the slow reply. As it was stored in system/media, I done the changes you said and it installed fully through recovery yet it hasn't actually installed the bootanimation. It's still showing the ROMs bootanimation when I boot up.
 

demkantor

Inactive Recognized Contributor
Nov 10, 2011
6,861
3,763
mpls
No worries,
Ill check when I get home but I believed I used the tmobile htc one update binary and I see you are posting in the htc one thread (no carrier) not sure how these phones differ if at all, but ill check on this for ya.
But if you could do me a favor until then, see if there is anything in build prop that will always be there on a stock rom vs something different on a another based rom, I'm thinking to have it flash where you need we can have the update script check build prop and use if then ifelse then to choose the proper place to flash, this of course is if there is something there.
Again not having this phone makes it difficult but still should be an easy fix

Sent from my myTouch_4G_Slide using xda premium

Edit: @KidCarter93
I got a feeling this should work on any ROM for your phone, going the simple route...
XDA-Bootanimation-signed.zip - 44.61 MB
Let me know
 
Last edited:
  • Like
Reactions: KidCarter93

Top Liked Posts

  • There are no posts matching your filters.
  • 63
    Introduction
    Hello Again! I have decided to make a series of tutorials for the XDA-University posted into this forum.
    These guides will be geared toward the novice but will involve tips and instructions I hope seasoned users will find helpful as well.

    Current list of guides
    Fastboot Installation and Usage

    All of my guides are to be considered a work in progress, only because I never consider any guide complete and will continue to update and answer questions for a long time to come.

    What To Expect From This Guide
    The basics on how to create a .zip to be flashed in recovery
    *This will include a series of commands executed in the updater-script
    And of course this means you will learn at least some basics of Edify, the basic script you will write these commands in.
    I also will be adding a short section on Aroma Installer but am willing to answer questions on it use as well.

    This Guide will be for Linux and Windows (Sorry Apple fanboys, not trying to be a jerk but I got to stick to my principles)

    **As always I encourage questions as I am not always clear and I can easily overlook something.
    33
    What Is an update.zip?

    Although this guide will cover the basics, I hope you don't need an answer to this question. I am to go over how to make one starting with some basics you will need to understand.

    File Structure
    There aren't many ways to setup the basic file structure and I have included a sample.zip for you to use. I find looking at one is the easiest way to understand.
    To create your own it is as simple as creating a new folder named whatever you would like. Inside this folder create another new folder named exactly
    Now inside this folder you will create another folder named
    Now another folder named
    And lastly one more folder within it named
    Here inside the android folder you will have two files, these need to be named exactly again
    and
    The update-binary is best to be taken from the latest OTA update from your device, chances are you are not the first to make a ROM or mod or whatever else needs to be flashed in recovery
    So feel free to take this from one of those as well (these by in large are not custom made by a dev and no permission should be needed)
    Structure of your update.zip should be as such:
    update/META-INF/com/google/android and in this last folder will be the two scripts.
    example.png


    Edify

    This is the language used in the scripts we are writing, It is simple, straight forward, and much more forgiving then Java for example.
    This is the syntax we will use in the updater-script, the update-binary will not be edited and only will need to be copy and pasted. It is best to seek out the latest for your device
    The next post will be filled with samples of commands you can use in your updater-script that will perform various functions to your device

    Tools Needed
    There is no heavy computing here, old and new computers alike can handle this sort of task. I have made update.zips in both Linux and Windows with both super fast and terribly slow machines.
    No I will not go over how to create your ROM or mod or whatever you are attempting to flash to your phone, I am only going to explain how to flash it.
    So the list of tools needed is very small for the basics here.

    Windows
    I highly recommend using 7zip but yes there are other options
    Another must have will be notepad ++, This really should have a tutorial for itself but I'll help with the basics
    There are many tools to sign and i have just used THIS ONE forever so I'll recommend this, there are however easier ones that allow you to right click a file to sign it.
    Which is amazing and I use one for my Linux box, now that I'm writing this maybe its time I change my windows one... to THIS MAYBE?
    Also be sure to have the latest Java installed found HERE
    And really that should cover us, there are lots of helpful apps and programs to make life easier but this will do just fine!

    Linux
    There are loads of tools I can recommend and variations on each one, so I will just list a few must haves to make your basic update.zip
    There is a 7zip variant for Linux, use the terminal and type:
    Code:
    sudo apt-get install p7zip
    Now you can use gedit as your text editor or i personally like Sublime Text there is a Windows compatible version too that i have yet to check out.
    And we need to sign these .zips, for Linux i use This One created by Amon_RA
    You will need to add this script to your nautilus script directory and name it sign
    Code:
    #!/bin/sh
    # Update the Loc var to where YOU stored the testsign.jar file !
    
    Loc=/home/demkantor/adt-bundle-linux-x86_64-20130219/sdk/tools
    
    for arg
    do
    
    java -classpath "$Loc"testsign.jar testsign "$arg" "$arg"-signed
    gdialog --title "signapk" --msgbox ""$arg"-signed created" 200 200
    
    done
    Be sure to change Loc=/home/demkantor/adt-bundle-linux-x86_64-20130219/sdk/tools to the proper path as yours will be different.

    *note* in 13.04 this is moved to ~/.local/share/nautilus/scripts/ but in previous Ubuntu releases it was in ~/.gnome2/nautilus-scripts
    This had me pulling my hair out and looking for a nice new tool and am currently trying THIS OUT (the old way still works though)

    Also get the most up to date Java, from a terminal type
    Code:
    sudo add-apt-repository ppa:webupd8team/java
    sudo apt-get update
    sudo apt-get install oracle-java7-installer
    sudo update-java-alternatives -s java-7-oracle
    *If doing lots of android development you may want to look into an older java version... but thats another story, see a guide on developing if thats your bag


    So now you understand the basics, you have all the tools you need, got may sample.zip and are ready to learn how to.
    The next post be available commands to use in your updater-script

    *See post #12 to understand a common problem people (sometime even myself) make with the sample.zip below
    24
    Let's Start!

    Now We Have Our Tools And A Basic Understanding
    But we need to know how to have our update.zip do what we would like!
    We need to see the various functions available to us, this I copied from the XDA wiki as it is precise and simple, (Normally I wouldn't copy and paste but this is what you need exactly) I will next give examples:

    Need To Know!
    Syntax
    The script file must use UNIX newlines as EOL.
    Whitespace (space, tab, LF 0x0a, but not CR 0x0d) may be freely used.
    Comments are any line prefaced with #
    All commands are terminated with a semicolon. Clauses (in ifelse) may contain any number of commands, each terminated with a semicolon.
    Strings are usually delimited with double quotation marks.
    Numbers are really just strings and are usually not delimited.
    Logical values are "t" for true or "" for false.
    The comparison operators are == (string equal), != (string not equal).
    The logical operators are || (logical or), && (logical and), ! (logical not).
    The concatenation operator is +. (Caution: 2+2==22)
    The conditional keywords if, then, else and endif operate as expected. The ifelse macro may be used instead.

    Disk operations
    format(type, device)
    mount(type, device, mountpoint)
    unmount(mountpoint)
    is_mounted(mountpoint)

    Image operations
    write_raw_image
    write_firmware_image

    File operations
    package_extract_file(source, destination)
    package_extract_dir(source, destination)
    delete(file) – deletes a file
    delete_recursive(directory) – completely deletes a directory
    symlink(target, link0, ...) – create any number of links to a target
    set_perm(user, group, mode, file) – performs a chown, chmod on a file
    set_perm_recursive(user, group, mode, directory) – performs a chown, chmod on all contents of a directory
    getprop(key) – returns a string value of the associated key from the system properties
    file_getprop(file, key) – returns a string value of the associated key from a specific file

    Patching operations
    apply_patch
    apply_patch_check
    apply_patch_space
    run_program(program, arg0, ...)

    Control
    assert(condition0, ...) – aborts and prints on any false condition
    abort(message)
    ifelse(condition, trueclause, falseclause) – conditional, falseclause is optional

    Predicates
    is_substring(substring, string) – checks to see if string constains substring anywhere
    less_than_int(x, y) – checks to see if x<y when considered as integers
    greater_than_int(x, y) – checks to see if x>y when considered as integers

    User feedback
    show_progress(fraction, seconds) – advance progress bar a fractional amount over a period of seconds
    set_progress(fraction) – advance progress bar a fractional amount
    ui_print(message0, ...) – print any number of strings
    sleep(seconds) – pause a number of seconds


    Having a list of the available commands is great but we need to understand what they do, consider the above a reference point and below and understanding of the commands


    How To begin the Process
    First find out what you want to do, get your apps, images, what ever you are trying to do in order and then open your text editor (Windows notepad ++ and Linux gedit)
    Then make sure the file structure in your folders are correct and have the update-binary specific to your device and be ready to write your updater-script
    I will go deeper into the setup in a moment but for now we need to understand how to write the updater-script

    Basic Usage
    Often you will start this script with a ui_print(" "); to explain the purpose of the package you made. There are many ways to go about this but a simple start maybe:
    Code:
    ui_print("Modded Google Play App By demkantor");
    This can be as complex or simple as you want and include as many lines as you would like. We just want to tell the user what is happening to their phone.
    We also want to have the progress show, this will help the user know when everything will finish, especially bigger packages that can take some time, don't want people to think its stuck!
    There are a couple ways to do this, I tend to use a series of set_progress(0.1); starting in the beginning and working to set_progress(1.0); when complete. you may also use time as in show_progress(fraction, seconds) choice is yours:
    Code:
    set_progress(0.1)
    # Something going on
    set_progress(0.5)
    # Some more stuff is happening
    set_progress(1)
    # Indicates completed task
    Now you may have notice I used # symbols in front of some lines, these are used to comment lines that aren't part of your script and for you and only you by and large.
    Any line that begins with # will not be read by the script, here is a short example of usage:
    Code:
    set_progress(0.1)
    ui_print("Modded Google App By demkantor");
    ui_print(" ");
    # Need to mount system
    ui_print("mounting system partition");
    set_progress(0.3)
    mount("ext4", "EMMC", "/dev/block/mmcblk0p25", "/system");
    # Flash modded google app
    ui_print("Flashing App!");
    set_progress(0.5)
    package_extract_dir("system/app/com.modded.app", "/system/app");
    # Don't Forget to set Permissions
    ui_print("Setting Permissions");
    set_progress(0.7)
    set_perm(0, 0, 0644, "/system/app/ModdedGoogleApp.apk");
    # Unmount system before we finish
    ui_print("Unmounting System");
    unmount("/system");
    ui_print("You're Finished! Thanks For Using My App!");
    set_progress(1)

    Explaining the Above
    This would be a very basic setup, and the comments, extra uiprints, and set progress are not really necessary in such a basic flash, but it will be good practice to use all this as you progress
    I need to explain a few things in that script quickly:
    You notices i commented out a line (# Need to mount system) and underneath a line read <mount("ext4", "EMMC", "/dev/block/mmcblk0p25", "/system");>
    This will change from device to device but you need to mount your system or data or whatever to flash to it.
    The first bit "ext4" is the type of file system, there are many options here but use what your phone is partitioned to.
    Some common file systems: rfs yaffs2 ext2 ext3 ext4 vfat
    Next is the partition type: "EMMC" or "MTD" for the most part
    Next is the location of the file system; This is key as you don't want to flash an app to your EFS partition or whatever. "/dev/block/mmcblk0p25" is the system partition location for the device in this example, to find yours do this:
    Open a terminal emulator on your devices and type: mount
    Or
    Open an adb shell and type : mount
    these are just two quick and simple ways but there are many others
    Last is the mount point, or name of this partition, the example above was "/system"); The more common partitions you will mount will be system and data but you can of course do others, just make sure everything matches.

    You also noticed this line: # Flash modded google app , and the comment is just telling you what command you want to do next, in this case:
    package_extract_dir("system/app/com.modded.app", "/system/app");
    This is taking everything in the folder /com.modded.app from within the update.zip and installing it in /system/app on the device.
    **Note understand if an app installed is best as a system app or userdata app**
    package_extract_dir("data/app/myspecialapp", "/data/app");
    this may be a more common example.

    You also saw the commented line: # Don't Forget to set Permissions
    and permissions that were set: set_perm(0, 0, 0644, "/system/app/ModdedGoogleApp.apk");
    This set rw- r-- r-- with no special permissions to ModdedGoogleApp.apk
    This is important to do as not setting the proper permissions will to allow the app to function as you intend.
    If you are familiar with Linux/Unix chmod commands (change mode) then this is all we are doing. Or if you ever user Root Explorer or any other root access file manager in Android you may be familiar
    If not I suggest to read up on THIS as its important to know

    And The last piece in there was unmount("/system"); which I'm sure wont need any explaining.
    You also notice progress and ui prints helping the user along, These were not placed well or really all too needed in such a simple script,
    but I wanted you to see an example and learn to use them along with comments for yourself as your scripts become more complex.
    Lets do some of this more complex stuff now!


    The last chunk should have helped you understand some simple scripting, but really this is far from enough unless you are only ever planing to flash one app!
    So lets dig deeper into Edify and see if we can create an ever better update.zip!


    Erase Commands
    Format, delete, and delete_recursive can be very helpful, I'm a huge supporter of wiping clean before flashing a new ROM and occasionally wiping cache and dalvik after.
    It will be handy for you to add these functions in to lets say a ROM you made before a flash if you deem it necessary or wipe cache and dalvik after your mod.
    No matter the reason you should understand how and when you should do this.
    Code:
    delete("/data/app/googlePlayMusic.apk");
    delete("/system/app/Provision.apk","/system/app/QuickSearchBox.apk","/system/app/SetupWizard.apk");
    The above is doing two things, first it is deleting a single app from data partition (googlePlayMusic.apk)
    Next it is deleteing a series of apps from system partition (Provision.apk, QuickSearchBox.apk, and SetupWizard.apk)
    The reasoning why you want to delete a single file or app is up to you to decide, but the above will do it easily. If you want to delete a full directory then:
    Code:
    delete_recursive("/system"); 
    delete_recursive("/cache"); 
    delete_recursive("/data");
    So this is a series of three commands to delete everything in system, cache and data. You may also string them together into one command separating each with a comma.
    Code:
    ui_print("Formatting system");
    format("ext4", "EMMC", "/dev/block/mmcblk0p25", 0);
    The above will completely format and erase system, you could also do data, cache, boot, whatever. Just be careful as this will make all data unrecoverable.
    You would need to unmount the partition before you run any format command
    Code:
    unmount("/system");
    unmount("/data");
    Know the partition to unmount, then know the partition to format (ie mmcbl0p25 is not always system!)
    when you are ready to flash something to a partition go back and mount it (this I covered earlier)


    So now we have an idea on how to use some basic commands, lets put together a couple simple scripts and try to flash them!
    Once you are confident with do this we will create our own more complicated flashable .zips


    Lets try something simple
    So most everyone who is bothering to read this enjoys flashing ROMs and probably does this a lot. But as we all know setting up a new ROM is time consuming!
    One of the first update.zips I ever wrote was to flash about 20 apps I always used and each time I flashed a new ROM I would have to redownload them or use an app like Titanium Backup to reinstall them.
    I found it just far easier to make a flashable .zip and keep in on SD card so after each wipe and ROM flash I could just flash this next and all would be there.
    So lets do it together!

    First
    Make the file structure I showed before, or download my sample.zip from previous post. If its a new folder lets name it apps2install, If you have the .zip extract contents and name the main folder apps2install.

    Second
    Now we need some apps, lets take a couple free apps (never share paid apps in this forum! or anywhere really) For simplicity sake lets take three apps:
    ADW Launcher, Dropbox, and Pandora... all are free on the market and for simplicity sake I suggest you take these same apps.
    Download from market and bring the .apks to your computer, do this with either copying them with a file explorer and saving them to sd card, then transferring to computer or I prefer to use ADB. Your choice:
    *Method 1... File Explorer
    Open any file explorer after downloading apps, go to /data/app , and now copy the three .apks and transfer to sd card.
    Now go back to /data/app-lib and copy com.dropbox.android-1 folder to SD card
    ScreenshotCombo.jpg
    Once you have the 3 .apks and one app-lib, connect phone to USB and transfer to computer. Then we need to put them in proper folders, again there are multiple ways but play along for learning purposes.
    FileStructure.jpg
    Your file structure should now look like the above, orange is folders, green .apks, and grey files

    *Important, most apps store themselves to /data partition, some need to be in /system. Some apps are downloaded to /mnt/asec and not always do libs go into data/app-lib
    My point is to know where your apps are to pull them and know if there are any needed libs to make them function properly. This is on an app by app and ROM by ROM basis


    *Method 2... using adb
    For me adb is faster and I like the command line so if your good with adb I say go this route, if not I suggest reading up on it and then using it or use previous method
    So download the apps to your phone I mentioned above, now connect phone to PC and open terminal/cmd and type
    Code:
    adb pull /data/app /pulled
    adb pull /data/app-lib /pulled
    This will pull all apps store on /data/app and all app libs stored on /data/app-lib to your PC into a folder called pulled.
    If you only want to pull the apps in question the add com.dropbox.android-1 after /app and /app-lib (or whatever the app / lib is titled you want to pull)
    And if you want a differemt folder to be stored on pc change the /pulled to whatever you like, maybe C:\Users\youraccount\Desktop\pulled (for windows)
    Or /home/youraccount/pulled (for Linux) your choice on all this

    Third
    Lets write the script, I'm using notepad++ in windows here (currently booted in windows so...), use gedit or what you prefer in Linux, just be sure to write in UNIX format.
    Code:
    ui_print("Flasing Your First update.zip.....");
    set_progress(0.1);
    # Mount System Partition
    ui_print("Mounting System");
    mount("/system");
    # Mount Data Partition
    ui_print("Mounting Data");
    mount("/data");
    set_progress(0.3);
    ui_print("Flashing Apps!");
    ui_print("....");
    package_extract_dir("system/app", "/system/app");
    set_perm(0, 0, 0644, "/system/app/org.adw.launcher-1.apk");
    package_extract_dir("data", "/data");
    set_perm(0, 0, 0644, "/data/app/com.dropbox.android-1.apk");
    set_perm(0, 0, 0644, "/data/app/com.pandora.android-1.apk");
    ui_print("....");
    set_progress(0.6);
    # Set Permissions
    ui_print("Setting Permissions");
    set_perm_recursive(0, 0, 0755, 0644, "/system/app");
    set_perm_recursive(1000, 1000, 0771, 0644, "/data/app");
    set_progress(0.8);
    # Unmount System & Data
    ui_print("Unmounting System");
    unmount("/system");
    ui_print("Unmounting Data");
    unmount("/data");
    ui_print("****Hope You Learned Something New Today!****");
    set_progress(1);
    This Is an example of your updater-script, it should look similar but it does not have to be the same. Let me explain further:
    The first few lines in this script we have gone over, the ui_prints and the mounts, do what you want with ui_prints and use mounts for your devices
    #comments - we talked about these too, these will not be read by the script, rather for your purpose.
    You also should be familiar with the set_progress, use at your will, not needed
    Now you see package_extract_dir("system/app", "/system/app"); this, like before is dumping everything from system/app in your update.zip to /system/app on device
    Now the permissions again, set_perm is for a single file, in this case rw- r-- r--to adw launcher, which was just flashed as a system app.

    Then there is package_extract_dir("data", "/data");
    This is taking everything from the data folder in your update.zip and transferring it to /data on your device.
    Remember we had 2 apps and 1 lib in data, but with this one command we put all on device in proper places. We could have separated the commands, but why bother!

    Speaking of why bother you may have noticed that after each transfer from update.zip to device there were permissions set at the end.
    Then toward the end of this script more permissions? Why? Well, to learn!

    The first command <set_perm> is for a single file and the last commands <set_perm_recursive> were for an entire directory.
    So you can set up each individual app or whatever with permissions, or just change a full directory. Each case is different and you will need to asses what is best in your situation.
    But yes, there was no need to do it twice here ;)

    The last bit in this script is unmounting partitions and some ui_prints and set_progress, these we have covered.
    And being this the end, lets move on to our next steps! (save your work!)

    Forth
    Now we should look over our script for errors, check for proper encoding, and make sure everything is saved to proper directory.
    Once all is correct we need to zip it, I prefer 7zip but do as you please.
    In windows, highlight the 3 folders (system,data,META-INF) > right click > 7zip > add to archive
    sevenzipexample.jpg
    Now make sure you set compression level to store, pretty much make sure it looks like pic bellow
    7zipExample.png
    Now that this is done, you will see your new zip (apps2install.zip) Great but it is still best to now sign this zip, but not needed depending on your recovery setup.

    **Note will soon add photos for Linux (just need to reboot!)

    Fifth
    Signing the zip, again there are multiple ways, I will show two signing methods, one in Windows and one in Linux. Choose one of these or another method, use what works for you!

    **Windows**
    I am choosing to use SignApk to sign apps in windows, the link is above and why not, HERE IT IS AGAIN
    Unzip it, put the contents where you want (directly on (C:) or creating a path in environmental variables is nice but unneeded)
    Put the apps2install.zip in this folder then open CMD in the same location as contents and type:
    Code:
    java -jar signapk.jar certificate.pem key.pk8 apps2install.zip apps2install-signed.zip
    And now you will see two copies (of course the one titled apps2install-signed.zip is the one to flash)
    As a side note you can change apps2install-signed.zip to what you want, no need for the -signed but at first it is nice to know which is which

    **Linux**
    So on both my Linux boxes I use @Amon_RA's right click to sign script, but have recently been trying out another by @lithid-cm which is quite nice.
    See the second post for a quick guide on how to set up and know that nautilus-scripts have moved in Ubuntu 13.04!
    So simply right click on the .zip, navigate to scripts, choose sign, profit


    All right! Now transfer your newly made update.zip to your recovery and give it a flash! When complete see if your new apps appear and if they work!
    If all is good try your to make your own, if you get errors, post here and I'll try to help!

    Happy Flashing!
    7
    Well I'm glad to know I'm wanted :D
    Learning to make your own modifications, kernel, ROMs, whathaveyou can get to be tricky. I would really recommend to start real small
    start with some easy stuff like take a ROM you like in a .zip, extract it, and dig through each folder so you see what types of things are in there.
    Grab an app and do the same thing, don't bother to decomplie it just use 7zip or something to extract its contents and just peer.
    Learn some coding, code.org and code academy is great for simple stuff, I just love Marakana TechTV (a Youtube channel)

    When you get your head around the simple things, try a small task, don't try to
    here is some sage advice from one of the top dev's ever Read

    I'm not saying this to stop or slow you down, just want to say be ready to do a lot (seriously a lot) of reading and research and be ready to fail a few times for sure. I am more to teach you what i know but I cant say I'm an expert in android coding, but as always, ask questions and ill do my best to answer!
    6
    How To Make An Aroma Installer Package

    Now it seems like every ROM or mod is flashed with aroma rather than a simple .zip, and for good reason.
    Aroma is a handy tool to allow users to flash what they want, be it a ROM, kernel, Mod, whatever, it just makes things simple. Not to mention a customizable UI.
    In truth this is very easy to set up and only requires a few more steps than making you standard flashable .zip, it will be only as complicated as you make it.
    The best advice I have for anyone wanting to use Aroma is to download the demo from HERE and see how it works.
    Then download a few other Aroma Packages to see how the file structure differs, and how the updater-script and aroma-config are used.
    Here are a couple I have made for different devices, feel free to download and look them over.
    An Aroma Package for any ROM for the Samsung Sidekick 4G This one flashes no ROM just basic apps and mods
    Splash Screen and Bootanimation Aroma for the HTC VISION This only flashes new splash screens and Bootanimations
    An Aroma Package for the HTC Vision for a specific ROM This one is ROM specific as it contains mods for only one ROM
    A ROM Using Aroma To Install Various Features This one is a ROM specific to the HTC Vision that uses Aroma to customize the install

    As you can see there are many ways to use Aroma to your benefit, and its up to you how to use it. I will be keeping this short but will try to help you understand the basics.
    As Always i encourage questions whenever you have them! Another Great Place To Ask Questions

    File Structure
    So once you download any Aroma package (be it from a ROM or the demo) you should see something similar to this:
    AromaFileStructure.jpg
    Create any folder you need in the same level as META-INF, such as system, data, or whatever you want really. You just will need to organize it in a way to tell the updater-script where to look.

    To Start
    Take an update-binary from your device and rename it to update-binary-installer, replace this in the one in the aroma demo.
    Now the two main files we will cover here are the aroma-config and updater-script.
    Think of aroma-config as the script for how you want aroma to look and what options to flash.
    Then think of the updater-script as what actually does the installation after user choose what he/she wants. This is written in the same syntax as covered before but a few extras are added.

    aroma-config
    Lets begin with editing the aroma-config (if using windows we need to use notepad++, in Linux use your favorite editor)
    We will create something simple, an Aroma package to flash a choice between four kernels, four launchers, and four apps. (of course we could do a lot more but this will do for a start)

    Lets Begin!
    Open a new file in notepad++ or your Linux text editor and name it aroma-config. Or feel free to take the one in the demo package, but we are going to start fresh so make sure you are on a blank page.
    The beginning should look like this
    Code:
    # Demo Aroma Script, Make changes accordingly.
    # ---------------------------------------------
    ini_set("rom_name",		"MyFirstAromaInstaller");
    ini_set("rom_version",		"1.0");
    ini_set("rom_author",		"demkantor");
    ini_set("rom_device",		"MyDevice");
    ini_set("rom_date",		"CurrentDate");
    Of Course name it as you please, change the version as necessary, best to use your name over mine, use your device and add the date.
    These are all variables that can be set throughout the install process and by adding this in the script you can just change date, build, etc at the top of the script rather than searching... some of my scripts are well over 1000 lines and this is a nice feature.

    Ok, next lets add a blank line to separate (hit enter) and start line 9 like so
    Code:
    # Splash screen "3000" = "3" secs , "cyan_splash"=filename of splash png
    # --------------------------------------------------------------------
    splash(4000, "cyan_splash");
    This will be the splash screen when aroma first starts up, I am directing it to a .png image named cyan_splash.png and have it set for 4 seconds (change accordingly)
    this image is to be place in the aroma folder, in the demo there is one named sample_splash - feel free to edit this at your will

    The next two chunks in the script will be for the font and theme, we aren't going to get fancy here so adding this to the script will suffice
    Code:
    # Font size declaration. "0" = Small Font. "1" = Big Font.
    # --------------------------------------------------------
    fontresload( "0", "ttf/Roboto-Regular.ttf", "12" );
    fontresload( "1", "ttf/Roboto-Regular.ttf", "18" );
    
    # Theme used for aroma interface
    # ------------------------------
    theme("ics");
    This is to use the already made Robot font, and we have both the large and small set, then a space and we are using the premade ics theme.
    If you want to change any of this feel free to use whats already in the aroma demo (look in the folders) or create your own. But for now lets move on

    The first page of your aroma package should be a welcome/explanatory page. It should inform your users what the will be flashing, what device it is meant for and anything else you may want to convey.
    Here is a sample and just change accordingly:
    Code:
    # First page info
    # ---------------
    viewbox("Welcome!","You are about to install <b>XXX.AromaPackage</b> for your <b>Name Of DEvice</b>, built by <b>demkantor</b>.\n\n"+
    	"Proceed with the installation only if you're <b>Ready to be wowed by my amazingness!</b>\n\n"+
    	"You May Leave Aroma Installation At Any Time Using The <b>Menu Button</b>.\n\n"+
    		" Version: \t<b><#selectbg_g>"+ini_get("rom_version")+"</#></b>\n"+
            " Built: \t\t<b><#selectbg_g>"+ini_get("rom_date")+"</#></b>\n"+
            "\n\n"+
        "Press Next to Continue the Installation",
      
        "@welcome"
    );
    A couple things to note here, <b> </b> boldens the chosen text, the \n\n"+ ends the line, the @welcome tells aroma what the screen should be setup like, the viewbox( begins the code and the ); ends the code for this section.
    I will go over viewbox, checkbox, and selectbox in more depth later.

    Remember the ini_set variables from the beginning, this will automatically add the proper date and version to the welcome screen... nice!
    And now lets add
    Code:
    setvar("installer_title",
           "You are about to install <b>MyAromaPackage</b> "+
           "with the following choices:");
    Rename as you see fit, oh and this next piece is optional but i throw it in many of my packages, here is a good time for:
    Code:
    # ---------------
    # Generic Warning
    # ---------------
    alert(
    	"Warning!",
    	"Please Make Sure You Know What You Are Doing And Can Recover Your Device, What You Do To Your Phone Is Your Own Choice!",
    	"@alert"
    );
    This is a small alertbox that flashes on the users screen, you can have it say whatever you'd like and change the style, font, colors, etc. You can also add a yes/no button or view changelog, etc etc, but we're keeping this simple
    On to the real codding!
    Code:
    # -------------------------------
    # Kernel choices using selectbox.
    # -------------------------------
        selectbox(
          "Kernel Choices",
          "Choose the Kernel to install to your device",
          "@personalize",
          
          "kernel_choices.prop",
          
          #------------------------------------[ selectbox With Groups ]---------------------------------#
          # TITLE            |  SUBTITLE                                                 | Initial Value #
          #------------------+-----------------------------------------------------------+---------------#
    
          "Kernel Choices",					"",								2,      #-- Group 1. key = "selected.1"
            "Kernel Choice 1",				"A Kernel as boot.img",				0,      #-- selected.1 = 1
            "Kernel Choice 2",				"A Kernel as zImage",				0,      #-- selected.1 = 2
            "Leave Kernel as is",			"Not Touching Kernel",				1       #-- selected.1 = 3
        );
    
            appendvar("installer_title", "\n\n<b>Kernel Choices</b>");
            appendvar("installer_title", iif(prop("kernel_choices.prop", "selected.1")=="1", "- Flash Kernel 1 ", ""));
            appendvar("installer_title", iif(prop("kernel_choices.prop", "selected.1")=="2", "- Flash Kernel 2 ", ""));
            appendvar("installer_title", iif(prop("kernel_choices.prop", "selected.1")=="3", "- Skip Kernel Installation ", ""));
    Ok, lets explain this chunk. The first three lines you see are commented out, this is just for anyone looking at the code to know what is happening.
    the next line gives us the aroma ui option of select box, this allows user to select one and only one option (as you may have guesses you don't want to flash two kernels)
    It starts from selectbox( and ends the ui at );
    The next line will be the header on the ui "Kernel Choices", after this an explanation in the ui "Choose the Kernel to install to your device",
    and the following "@personalize", is the style aroma will use, for the most part "@personalize", will be used at all user install screens within aroma
    And next we have "kernel_choices.prop", which the updater script uses to know what option the user want to flash from the category Kernel Choices

    Now we have some more commented lines, again this is just for reference to make life easier
    And know you see 4 more lines, the first is giving the header for the category, and the next three are the two kernel options and the third is to not flash a kernel.
    "Kernel Choices", is your header "", is an empty subtitle that could be filled for added info to the user the 2, explains to aroma its the header
    The #-- Group 1. key = "selected.1" is telling aroma this is the first group and to write the choice to kernel_choices.prop as selected.1
    If we wanted to we could have multiple groups within this category but were keeping this small.
    The two kernel choices have subtitles saying as a boot.img or zImage, I'm just giving two common options on how the kernel will be installed in the updater-script
    And the three choice in this ui has #-- selected.1 = 1 or 2 or 3, these will be what is written to the kernel_choices.prop to allow the updater-script to chose the right option
    As you can see the final option has a 1 instead of a 0 after it, this makes it the default selected and although not needed "do nothing options" I feel should be defaulted to
    And the last two important thing that many new scripters miss are the absence of , after the 1 this is to let aroma know there are no more options and the next line will be the end of this section, signaled by );

    I cant think of an easy explanation for appendvar if your unfamiliar with coding, but it is adding a string to a variable.
    This is for the updater-script and will be come more clear when we get to this part. So for now copy and paste...