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.
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
META-INF
Click to expand...
Click to collapse
Now inside this folder you will create another folder named
com
Click to expand...
Click to collapse
Now another folder named
google
Click to expand...
Click to collapse
And lastly one more folder within it named
android
Click to expand...
Click to collapse
Here inside the android folder you will have two files, these need to be named exactly again
update-binary
Click to expand...
Click to collapse
and
updater-script
Click to expand...
Click to collapse
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.
Click to expand...
Click to collapse
Click to expand...
Click to collapse
{
"lightbox_close": "Close",
"lightbox_next": "Next",
"lightbox_previous": "Previous",
"lightbox_error": "The requested content cannot be loaded. Please try again later.",
"lightbox_start_slideshow": "Start slideshow",
"lightbox_stop_slideshow": "Stop slideshow",
"lightbox_full_screen": "Full screen",
"lightbox_thumbnails": "Thumbnails",
"lightbox_download": "Download",
"lightbox_share": "Share",
"lightbox_zoom": "Zoom",
"lightbox_new_window": "New window",
"lightbox_toggle_sidebar": "Toggle sidebar"
}
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
Click to expand...
Click to collapse
Click to expand...
Click to collapse
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
Click to expand...
Click to collapse
Click to expand...
Click to collapse
*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
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
Click to expand...
Click to collapse
Click to expand...
Click to collapse
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!
Click to expand...
Click to collapse
Click to expand...
Click to collapse
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)
Click to expand...
Click to collapse
Click to expand...
Click to collapse
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
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.
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
Now make sure you set compression level to store, pretty much make sure it looks like pic bellow
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
Click to expand...
Click to collapse
Click to expand...
Click to collapse
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!
And another.....
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:
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.
Click to expand...
Click to collapse
Click to expand...
Click to collapse
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...
Click to expand...
Click to collapse
Click to expand...
Click to collapse
demkantor said:
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.
Click to expand...
Click to collapse
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 ...
Well I'm glad to know I'm wanted
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!
Re: basic update.zip
demkantor said:
set_progress(0.1)
# Something going on
set_progress(0.5)
# Some more stuff is happening
set_progress(0.1)
# Indicates completed task
Click to expand...
Click to collapse
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!
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
Great tutorial. Thanks. :good:
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:
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?
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!
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
@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");
Click to expand...
Click to collapse
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
demkantor said:
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
Click to expand...
Click to collapse
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
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
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
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
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.
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
Related
Everything needs to go in /sdcard/andboot
FILES YOU NEED:
the nbh flashed to your phone
an sd card with the andboot folder at the top level
an androidinstall.tar file plopped into the andboot folder
thats it
then just hold down volume up or dpad center or the middle of your touchscreen when booting and go through the menu to choose where to put things and then install the system. (for those without a dpad, pretend the touchscreen is a giant dpad)
if you're doing it with haret, extract basefiles to your sd, plop the androidinstall.tar into the same folder, and boot, hold down volume up (camera on kaiser/polaris) just like the nand people (but don't pick nand to store the files, it won't work)
---------
all the files
basefiles for the haret folks out there
Grab the nbh files for your device. Only difference between eclair and non-eclair is that eclair is set up to use the newer hw3d driver, non-eclair is set to use the older one (for donut/cupcake)
These do not use rootfs. They remove it completely and free up that extra space in your nand for a bigger, cleaner system.
They also have my new menu-based installer! Yay! Just hold-down volume-up or dpad center or the middle of your touchscreen
THIS WON'T WORK WITH ANY OF THE OLDER SYSTEMS! THE SYSTEM MUST INCORPORATE THE APPROPRIATE FILES FROM ROOTFS (and the rom cooks will let you know when theirs is ready)
The first system to use this is based on eclair 2.1 with working sleep and audio
Here's my tattoo system for this method
FYI Craig & I spent a lot of time on these!!!
How to create a build
How to make your build work with this
So it actually isn't that hard.
Extract your sqsh to a folder somewhere, so you have, say /android/system
Mount/extract whichever rootfs worked best with your system somewhere else, say /android/rootfs
Code:
cp -a /android/rootfs/init.etc/* /android/system/etc
cp /android/rootfs/lib/donut/* /android/system/lib
cp /android/rootfs/lib/modules/* /android/system/lib/modules
cp /android/rootfs/lib/hw/* /android/system/lib/hw
cp /android/rootfs/init.cfg/init.donut.rc /android/system/sysinit.rc
You'll need to modify the sysinit.rc a bit, as in the rootfs some things are commented out that shouldn't be, and it references a few things in /bin or /etc that aren't there anymore.
Also, don't forget to uncomment the line near the top of sysinit.rc that creates a symlink from /system/etc to /etc
Once you are done, just do this to create the installer:
Code:
cd /android
tar cvf androidinstall.tar system
Soon, I may upload some packs for making the process easier, with updated sysinit.rc's for each system type. If I have time, we'll see...
Note, you can update the contents of the .tar file from windows/izarc/winrar/etc and it'll still work. you don't need to keep messing about with linux anymore if you don't want to
How to update things
How to create an update pack
Since not everyone gets things right the first time, and we keep getting updates, the rootfs made it easy to install updates without downloading the whole system again.
Well now anyone can create an update pack
just create a tar file called androidupdate.tar, make sure it has everything in a /system folder with whatever files you want, drop it into /sdcard/andboot and reboot holding down volume-up (camera on kaiser/polaris). Choose the update option and you should be good to go.
If things get wonky when you try to boot up, give the fix permissions option a shot in the installer, if it still fails, try wiping the dalvik cache, that can fix things up too.
About the installer
I ripped it off from here, but put about 6 or 7 solid hours into getting it to fit and react with the keys/screen
May be new
rootfs
may be new
better eclair support
---
with android development this fast for "yomama so old" phone, who knows what future holds?
sshark said:
May be new
rootfs
may be new
better eclair support
---
with android development this fast for "yomama so old" phone, who knows what future holds?
Click to expand...
Click to collapse
whats a rootfs hahaha
Might be something called "Code Name Ginger"....or our tame racing car driver, we call the Stig.
nabicat said:
Might be something called "Code Name Ginger"....or our tame racing car driver, we call the Stig.
Click to expand...
Click to collapse
what the..... that was random
Holy cow.. like there's nothing even in this thread and it's already filling up..
I think I know what it is..
Vilord ported Dalvik from 2.5 which now includes native support for HW accel for MSM7500..
jesus.
Do we still need to have three partitions on the card? Or would one FAT32 partition be sufficient?
@vilord:
is everything needed for the rootfsless nbh in the git? I would like to test this with ´my kaiser
This works for Polaris? Really thanks!
the bootenv git should have everything needed for this. I haven't tested on my polaris yet, but it should "just work" on polaris and kaiser as long as martin's method to drop the active key into /proc works on all hardware.
What happens to the .conf files?
What about /media ?
Thanks for all of your efforts
conf files are no longer used from the sd card.
If the cook put things in the right places, there should be a /system/etc/userinit.conf that gets parsed during android boot, but it is up to the cook to not screw that up.
This way is a lot cleaner, but it does a LOT less handholding for lazy cooks.
the upside is that it is *very* easy for anybody to fix a broken androidinstall by just piecing together what needs to change into an androidupdate.tar
/media is still used if it is on your SD card, but there's enough space and things are fast enough that media files should be included in /system now
This is a HUGE development for rom devs.
I will be honest in saying I've been having a hard time not hitting the 90MB cap with my next Warm Donut release.
Infact, I spent 4 hours yesterday de-odexing and compressing the classes.dex back into the jars and apks to save space.
With this new method this gives us ALOT more space. I applaud you for doing this. It breaks alot of the current builds but at the same time gives us a ton more flexibility for future.
And what I really like from this is it removes the confusion and headaches on configuration, giving the power to the ROM dev to include the necessary settings.
Question though. Different phones (Vogue, Polaris, Kaiser) may require different configurations. In the past it was a simple "just use this conf with this phone"
Thanks again
so when running from haret - getting an error about looking for a system file, I have all the files in andboot folder, any ideas on what I'm missing.
Know what would be really nice? In the setup, the ability to change LCD_Density and resolution.
This would eliminate the confusion users may have in editing the build.prop and rom files to change these values.
I guess the ROM devs could distribute separate files/tars for each res/density but that gets redundant if you know what I mean.
I'm using haret, but I dont see any option to choose to install not to nand, i get into the installer and it says install system so i click that but then it just goes through installation and fails. How do i choose to install to sd card?
i want to change the file "sys/devices/i2c-0/0-0066/leds/jogball-backlight/period" to "2"
to do this i have to edit the permissions for it to work, but every time i reboot it reverts back to the original file
does anyone know how i can change this file permanently?
when i change it, it says file backed up as "period.bak" but i cant find where this is backed up to
This is not a real file. This is a virtual file - interface to device driver parameters. To change it permanently, you need either to see where the initial value comes from and change it there somehow, or to overwrite the driver interface file each boot.
Don't suppose you know where the original file is?
Sent from my Nexus One using XDA App
I don't know if this will work as it is piecing together multiple responses in multiple threads, but I believe if you add a script into the /etc/init.d folder, it will run it.
I believe it needs to be called something that has numbers at the front. Something like 99setpulserate
Code:
#!/system/bin/sh
if [ -e /sys/devices/i2c-0/0-0066/leds/jogball-backlight/period ]
then
/system/xbin/echo "2" > /sys/devices/i2c-0/0-0066/leds/jogball-backlight/period;
fi;
Again, save it something like 99setpulserate and give it 777 permissions
Code:
chmod 777 /etc/init.d/99setpulserate
Hope this works. Let me know.
bassmadrigal said:
I don't know if this will work as it is piecing together multiple responses in multiple threads, but I believe if you add a script into the /etc/init.d folder, it will run it.
I believe it needs to be called something that has numbers at the front. Something like 99setpulserate
Code:
#!/system/bin/sh
if [ -e /sys/devices/i2c-0/0-0066/leds/jogball-backlight/period ]
then
/system/xbin/echo "2" > /sys/devices/i2c-0/0-0066/leds/jogball-backlight/period;
fi;
Again, save it something like 99setpulserate and give it 777 permissions
Code:
chmod 777 /etc/init.d/99setpulserate
Hope this works. Let me know.
Click to expand...
Click to collapse
sorry, 777 permissions? as in tick all of em? never mind
maxib123 said:
Don't suppose you know where the original file is?
Sent from my Nexus One using XDA App
Click to expand...
Click to collapse
Most probably it's hard-coded somewhere in the system, which would require recompiling. Overwriting the value each boot, for example with init.d scripts as suggested above, would be much simpler. Just make sure that the value is initialized by the time you're executing your script, and that the ROM is configured to run them.
Jack_R1 said:
Most probably it's hard-coded somewhere in the system, which would require recompiling. Overwriting the value each boot, for example with init.d scripts as suggested above, would be much simpler. Just make sure that the value is initialized by the time you're executing your script, and that the ROM is configured to run them.
Click to expand...
Click to collapse
how would i do that?
bassmadrigal said:
I don't know if this will work as it is piecing together multiple responses in multiple threads, but I believe if you add a script into the /etc/init.d folder, it will run it.
I believe it needs to be called something that has numbers at the front. Something like 99setpulserate
Code:
#!/system/bin/sh
if [ -e /sys/devices/i2c-0/0-0066/leds/jogball-backlight/period ]
then
/system/xbin/echo "2" > /sys/devices/i2c-0/0-0066/leds/jogball-backlight/period;
fi;
Again, save it something like 99setpulserate and give it 777 permissions
Code:
chmod 777 /etc/init.d/99setpulserate
Hope this works. Let me know.
Click to expand...
Click to collapse
just checking, does the "99setpulserate" file just need to be a new file, or do i copy it over and rename it?
I'm not exactly sure what you mean. It needs to be a new file, but you can copy the text and past it in (if you use adb, or the browser on the phone).
The numbers at the beginning are the order in which things should be run (if I remember correctly from my old linux classes, Slackware uses the RC files which is slightly different). So technically, you can pick any number, but it is best to leave user scripts at 99 so that everything that needs to get loaded beforehand can get loaded.
bassmadrigal said:
I'm not exactly sure what you mean. It needs to be a new file, but you can copy the text and past it in (if you use adb, or the browser on the phone).
The numbers at the beginning are the order in which things should be run (if I remember correctly from my old linux classes, Slackware uses the RC files which is slightly different). So technically, you can pick any number, but it is best to leave user scripts at 99 so that everything that needs to get loaded beforehand can get loaded.
Click to expand...
Click to collapse
yeh... its doesnt work :L
maxib123 said:
yeh... its doesnt work :L
Click to expand...
Click to collapse
What if you manually run the file?
Code:
sh 99setpulserate
See if it is a screwup in the script or my understanding of the init system of Android (I am leaning towards the second one, because I double checked the script and it seems fine).
bassmadrigal said:
What if you manually run the file?
Code:
sh 99setpulserate
See if it is a screwup in the script or my understanding of the init system of Android (I am leaning towards the second one, because I double checked the script and it seems fine).
Click to expand...
Click to collapse
2: not found
tried on adb and emulator
Include the full path to the script when you run it from shell.
I don't know why it wouldn't be working, but I suppose worst case, you could always just add the contents of the script (except for the first line) to the 20userinit file at the bottom.
maxib123 said:
Don't suppose you know where the original file is?
Sent from my Nexus One using XDA App
Click to expand...
Click to collapse
i can show you exactly where the source code is for this file. its the microp.c file in arch/arm/mach-msm folder of the source code kernel.
EDIT: here is the actual file source code.
https://github.com/CyanogenMod/cm-k....37/arch/arm/mach-msm/board-mahimahi-microp.c
you could possibly have someone compile a kernel with changes to this that would set it to your value so you wouldnt have to mess with it each boot up. but i havent look at the code yet to know, so i'll take a look and see.
EDIT: so it looks like when powered up this driver defines the particular data in question from this register address:
Code:
#define MICROP_I2C_WCMD_JOGBALL_LED_PERIOD_SET 0x5D
so you could easily just add some code to set it to your value of 2 upon initialization. i want to say that you can permanently set that register address to a different value. but it seems like its getting cleared upon each reboot, so your best option is to just have the code set it manually.
probably easier than compiling your own kernel would be to just create some simple BASH script that does this upon boot up. though the more fun proper way is change the code.
Jack_R1 said:
Include the full path to the script when you run it from shell.
Click to expand...
Click to collapse
Yeh I did
Sent from my Nexus One using XDA App
How about creating a pre-modified version of the period file, and have the init overwrite the current one at each boot, rather than trying to edit it in the fly...?
danger-rat said:
How about creating a pre-modified version of the period file, and have the init overwrite the current one at each boot, rather than trying to edit it in the fly...?
Click to expand...
Click to collapse
what do i need to do to do that?
If you look at that code, its not an actual file but just a virtual register read from the hardware. So your only option is to create a startup init script to write your desired value to that register (file) on boot up.
why has it changed? it used to be how i want it on the older versions of cyanogen, isnt there some files i could just take from those files and take it over?? seems like a much simpler option :L
USING DSIXDA's KITCHEN TO CREATE YOUR OWN SOFT-MODs
(THIS IS MY FIRST BIG TUTORIAL, SO PLEASE CO-OPERATE AND HELP ME MAKING THIS GUIDE BETTER!!)
DsiXDA has created an excellent Kitchen for 'cooking' custom ROMs. So first THANKS goes to DsiXDA.
READ THIS BEFORE PROCEEDING:
Click to expand...
Click to collapse
For Kitchen to get working you need a Linux environment. My choice is go for Ubuntu 10.04 / 10.10 (I won't recommend 11.xx as Unity spoils the 'Cooking' experience). You should have a little bit of experience with Ubuntu. You can do it on Windows too. Install Ubuntu inside VirtualBox. I won't recommend using cygwin as it may reduce the performance.
Click to expand...
Click to collapse
GIVE CREDITS TO THE ORIGINAL DEVELOPER
I. Setup the Kitchen:
Download DsiXDA's Kitchen at https://github.com/dsixda/Android-Kitchen/archives/master. Download the 0.179 version
Get an 'original' ROM (not soft-modded). The ROM that I used in this tutorial is Pebe's CyanogenMod 7
Get JDK. It's necessary. Execute the following command in Terminal:
sudo apt-get install openjdk-7-jdk
When asked for password, enter the one which you use for logging in.
For 64-bit system, you need the ia32-libs ( sudo apt-get install ia32-libs )
Extract the contents of the dsiXDA's kitchen to a folder, say kitchen, in your Home folder (for convenience). Just inside the kitchen folder there should be the ./menu file
Open Terminal. Browse to your kitchen directory
cd ./kitchen
source ./menu
It should open up the Kitchen Menu
This is the basic setup of your Kitchen. Now move up to the next big step.
II. Actual ROM:
Copy the ROM (in my case, it is cm7_v2.zip (pebe's CM7)) and paste it in the original_update folder
Execute Kitchen (Step 5 from I). Select option '1. Setup working folder from ROM'. Another menu appears, hit ENTER. It'll show up the available ROMs list. It should display at least one ROM. In my case it was "(1) cm7_v2.zip". Enter selection number: 1. Hit ENTER. It'll prompt for changing the name, leave it, no need. Hit ENTER. It'll start extracting the ROM. In my case, it found the updater-script. It'll ask to convert the script into update-script. We want update-script at the moment, so just hit ENTER. It should say 'Finished setting the working folder!'. Hit ENTER. You'll be back to Menu.
The Menu shows various options like 'Adding Root permissions, installing busybox, etc'. You can play with them. As most of the ROMs have Root and Busybox installed, we don't need any of these features.
Now comes a bit advanced part. Select ADVANCED OPTIONS. There are various options like Deodex files, add Nano text editor, signing APKs, etc. I'll explain each of them:
Deodex: Merges ODEX and APK together. However, it's applicable for ODEXed ROMS (mostly Stock 2.1) only. Neither of GB and FroYo versions are ODEXed. So you can skip this step.
Add task killer tweak: It's a good alternative to Supercharger script. Only thing is, it isn't as versatile as Supercharger script. Leave this if you don't know anything about Task killer values like FOREGROUND APP, BACKGROUND APP, etc
Add data/app functionality: Suppose you've come across a situation that the system size reaches almost 150 MB (standard for GT540) and still you want to add some more apps, then this tweak is for you. It adds the /data/app folder. You can place apps in this folder. These apps will be directlty installed in the /data partition thus eliminating the 150MB limit.
Add Bash: Adds command-line completion in Terminal commands. Install if you want. Not needed.
Add Apps2SD: This is much primitive type of Apps2SD in which you have to create an ext partition on your SD card. Not recommended. Link2SD (app) is much better.
Add busybox run-parts: This tweak is most important one. I enables the startup scripts option, that means, scripts placed in /etc/init.d folder will get executed during the booting process. Recommended for Stock and AOSP ROMs only.
Add custom boot animation: If you want to add a custom boot animation to your ROM, then you need this. Select this option. It'll ask you to proceed, hit ENTER. A folder /data/local will be created inside the WORKING_xxxxxxx_xxxxxxx folder. Place your bootanimation.zip in that folder. Google some nice boot animations or if you want to create your own boot animations, Despotovski brothers had made a 'Boot Animation maker', check it here http://forum.xda-developers.com/showthread.php?t=1234611
Rest all tweaks are not required for now
III. Something's Cooking!
There will be a folder named something like WORKING_xxxxx_xxxxxxxx in your kitchen folder. Open it up. It contains the actual system, boot.img file, data directory etc.
The best feature of DsiXDA is that you can easily 'browse' the system.
Open the system folder. Here you can see the apps, etc, lib, usr, etc folders.
Adding / Removing Apps: Open the apps folder. You'll see APKs of all the system apps. Try removing some apps. You can remove Dev tools, pre-installed CM themes or any other app. Add your own apps. Copy-paste your apps here. If their filenames have spaces in them (like Root Explorer.apk) remove these spaces (like RootExplorer.apk). You can also use the /data folder for adding more apps.
Adding some other stuff: The /etc folder has a lot of cool stuff too. The apns-conf.xml file contains the APNs. System can auto-detect the APN according to your carrier. I got an apns-conf.xml file which contains a huge list of APNs. Just replace the existing file.
Adding Fonts: Pick your favorite font (I like Ubuntu). Grab the .ttf file of that font. Open /fonts folder. Remove the existing DroidSans.ttf file. Copy-paste your font file in it and rename it to DroidSans.ttf.
IV. Final Steps:
Open the kitchen menu. Advanced Options → Sign all APKs
Back to main menu. '9. Check update-script for errors'.
'6. Zipalign all APKs'
'99. Build ROM'. If it shows warning regarding BOOT-EXTRACTED folder exists, select y (remove BOOT-EXTRACTED).
Select a build option → 1. Interactive Mode
Would you like to Zipalign → n (we already did that before)
It'll start making update.zip.
Add updater-script to your ROM → y (We want compatibility with ClockworkMod)
Proceed with the change → y
Sign your ROM → y
Change the name → n
Once you're back to main menu, select Exit (x)
Your ROM is located in OUTPUT_ZIP folder (It'll be a zip file)
Copy this zip file on your SD card. Reboot into Recovery. Select 'Install zip from SD card', select the ZIP file.
Reboot. See if everything works properly.
I KNOW THERE MIGHT BE ZILLIONS OF ERRORS IN THIS GUIDE. IF YOU'RE STUCK AT SOME POINT OR CANNOT UNDERSTAND SOMETHING, TELL ME. I'LL TRY TO MAKE THIS GUIDE MORE EASIER TO UNDERSTAND.
THIS IS A BASIC SOFT-MODDING GUIDE. I'M DOING SOME INVESTIGATION REGARDING THEMING AND BUILD.PROP TWEAKS. I'LL BE ADDING THESE SECTIONS LATER.
WOW nice work making this TUT!!
Nice Work!
thanks!!
gonna try this out sometime
There is a search feature guys this was posted about like half a year ago
I tried the kitchen its not that great all you can do is zipalign change some options and re package
TBH androidboss you probably could do more using terminal and root explorer
Sent from my tf101 using xda premium 1.54Ghz
Guys! Before Soft-Modding please ask the Devs first. They worked and took up free time for those roms and they would like a thanks.
Danzano said:
There is a search feature guys this was posted about like half a year ago
I tried the kitchen its not that great all you can do is zipalign change some options and re package
TBH androidboss you probably could do more using terminal and root explorer
Sent from my tf101 using xda premium 1.54Ghz
Click to expand...
Click to collapse
really i should try one day!
with credits and thanks!!
Algud if you need tips or want a hand customizn give me a shout hell if you wana use enigma and just cretic it to you're liking be my guest
Sent from my tf101 using xda premium 1.54Ghz
Danzano said:
Algud if you need tips or want a hand customizn give me a shout hell if you wana use enigma and just cretic it to you're liking be my guest
Sent from my tf101 using xda premium 1.54Ghz
Click to expand...
Click to collapse
yeah thanx bro!!
i will try and make one during this weekend
once i get my phone fixed..
i will pm you if i need help with something about the
soft-mod!!
All good
Sent from my tf101 using xda premium 1.54Ghz
Danzano said:
All good
Sent from my tf101 using xda premium 1.54Ghz
Click to expand...
Click to collapse
pm' ed u!!
soz its a bit long!
I'll be writing the "Theming using UOT Kitchen" tutorial tonight
tejasdj12 said:
I'll be writing the "Theming using UOT Kitchen" tutorial tonight
Click to expand...
Click to collapse
http://forum.xda-developers.com/showthread.php?p=18934516#post18934516
you can base on this if u want
Hey guys, I am going to make a new thread about cooking, since I receive a lot of requests on HOW TO cook your own ROMs. I am always glad to help, but since those are always pretty much the same questions, I am going to gather all the information I have got about it in one simple thread, so everyone who is interested in cooking new ROMs for our device can get an easy start
I wanna start with really basic stuff and slowly come to more and more "complicated"/detailed information. I am still pretty much at the beginning of cooking, especially when it comes to kernels and stuff, but I think I will learn from it as well
But first of all, where do you begin with?
Pretty simple, with either installing a stock ROM and make your own ROM directly from this, or simply download a .zip ROM of your choice.
Either you take CM or a stock ROM like V20n from the repack of my nandroid by Redy.
Maybe you also want an already cleaned/deodexed ROM to start with. Grab them HERE
But watch out, cause this MIGHT contain bugs.
You can also grab any other flashable .zip ROMs out there, that you wanna modify.
For the second possible startpoint, you already will need dsixda's Android Kitchen so grab it and set it up, cause you will also need it for more advanced cooking/and even already some very basic steps. The kitchen simply provides a lot of scripts, that allow you to apply tweaks/mods very easily, without having to do it all manually.
A guide of how to set up kitchen for our device, will come. But I think the one in the thread should be enough for now.
Then you wanna flash a stock ROM, like one of these: http://forum.xda-developers.com/showthread.php?t=1480392
If you use other stock ROMs, you will need to root them, install ClockWorkMod and make a nandroid.
The Nandroid is, what you ll need to start. Copy it from your sd card (scard/clockworkmod/backup/THE-DATE-YOU-CREATED-IT) to your PC.
Then take system.ext4.tar/system.ext3.tar and boot.img and put it to your working folder of kitchen. Working folder path should be similar to this: C:\cygwin\home\USERNAME\kitchen\original_update.
Then start kitchen, by going to cygwin, cd (change directory) to the directory, where you can find the file menu.
Then type ./menu and kitchen will load.
1. Push "1" to set up the working folder.
2. Press enter, if you already added the needed files to working folder.
3. Select "1" again. Or if you already have got more ROMs in there, choose the one, you desire most. ENTER
4. Push "y" and give the folder a name, you will recognize, e.g. V20n if you cook a v20n ROM. ENTER
5. Chill
5.1. DO NOT I REPEAT, DO NOT convert updater-script to update-script! Otherwise your ROM wont boot! So type 2 and hit ENTER.
6. Press "Enter"
8. Now you can enter your Working_Folder (in .../kitchen/Working_FolderName) and e.g. delete /apps, apply tweaks,...
7. Select "99" to build a new flashable ROM. (How to apply tweaks will come later)
8. Select "1" except you know, what you are doing.
9. You can already zipaligne the apk files, but since you wanna do some more modding, push n in order to save time.
10. Push "y"
11. Sign your ROM by pushing "y"
12. Rename it, in order to be able to identify it again, even if you cook more ROMs parallely, so push "y". And then enter the epic name of your ROM
13. Find the ROM in: C:\cygwin\home\USERNAME\kitchen\OUTPUT_ZIP or whatever you called your folders.
Now it's time to get it on. First thing, most of you might wanna do, is to remove all the apps you dont need.
Find lists of removeable files HERE
or HERE.
In order to be able to remove them, you either need a packer like 7zip, but I always simply extract the .zip file, cause it is easier to operate and probably also faster. You will get the following folders:
-META-INF (Dont TOUCH IT! Except you know EXACTLY what you are doing
-system
-boot.img
In system folder, you can find the folder app. Here you can find all the files you wanna remove.
Next step will probably be, that you wanna add some tweaks and mods.
Therefor simply look around in the Dev section and choose whatever you like.
I ll list some of my personal favourites:
- Change the lockscreen: Either take one of these file or simply modify the build.prop, like Huexx found out HERE
- Add eRecovery by Huexxx
- Fix Audio Bug in CM
- Enhance Scores on benchmarks
- Add/remove build.prop tweaks
- Replace libsqlite.so BUT WATCH OUT, this breaks bluetooth file sending. If you only cook for yourself, extract the one from Zeus ROM, if you wanna release your ROM, ask Huexxx, before using his file.
Whenever you wanna try to flash your ROM, you ll first have to pack it and then sign it. Simply mark the folder system, META-INF and the file boot.img and click on add to .zip file. Best method to begin with is storage,because it "compresses" fastest. Then you already have a flashable .zip, but in order to flash it, you ll also have to sign it. Here is the simple way, I am doing it: http://forum.xda-developers.com/showthread.php?p=6232592. Just set it up, like it is said in the thread. Then right click your .zip ROM and click on sign this file. Wait till a popup comes up that tells you the file has been signed and find the new folder. The folder is called "Signed files" and in there, you can find the signed version of your ROM.
Here is a second possible solution.
Now you can flash it and test your new custom ROM.
If your phone gets stuck in a bootloop, you ll have to unbrick it. Look it up in my noob how to do it, there are several ways you can do it. The most simple is to set up adb and simply send the command adb reboot recovery to the phone.
To be able to fix errors, I think it will be best, if you always only make one change at a time and flash it directly afterwards. Then you can
More coming Have fun so far and if you experiance problems, while cooking, post it here, so I can correct the thread/add new cool stuff dsixda's kitchen thread will be posted in the next couple of days. Also, how to add cust kernels. Maybe a dev can help me, on how to compile one's own.
Oh I almost forgot: I am not responsible, for any damage, you do to your phone, bricking, not waking up, because you messed the alarm clock, bad food you made yourself, smelling feet, wars, bad films,...
dsixda's Android Kitchen guide coming here:
Like zipaligne, deodex, replace the kernel, ...
Going to edit this a bit tonight Hope you ll enjoy it
Reserved 10 CHARS
There are a lot a of cooking tutorials already in xda, instead you could make a collections of links to tutorials already out there.
Enviado desde mi LG-P970 usando Tapatalk
Thanks N00BY0815
I actually tried to cook a rom yesterday but bricked my device.
Dont hesitate to post links here, I will add em up there, if necessary, or already modify them to fit our device
It's a great idea N00by I have your tips yet but for others noobs (I'm too!) it a good thing to debut developping a ROM! I just meditate : do you think it is possible to create a topic where everyone could post his/her work?
Sent from my LG-P970 using XDA
hi... I had a couple of question to ask:
1. what If I want to add eg. erecovery by huexxx... I download the zip file, and extract the 2 files in the folder /system/bin and extract it to my /system/bin folder... is that step are right ? or do I have to add the updater-script to add permission of that 2 files
2. And what if I delete the default LG launcher and copy zeam.apk to /system/app does the system automaticaly detect zeam as a launcher, or do I have change the script?
thanx...
About the launcher, you simply have to delete one and add another one. To be on the safe side, I always renamed the new launcher to the old ones name, but the other solution works as well.
About eRecovery, idk, I need to confess, should work without, but I think you need to try. If it doesnt work, add these lines to updater-script:
set_perm(0, 0, 0755, "/system/bin/pvrsrvinit");
set_perm(0, 0, 0755, "/system/bin/pvrsrvinit2");
What if I take the stock Gingerbread launcher and replace with LG's stock one by just renaming it or overwriting it?
Will it work ??
ok I bricked my phone 5 times while trying cook my own rom... so I gonna back again from square one... Delete all my previous work and start again
V.0.2 Using v20N from redy, open dsixda, just zippalign, using updater-script from dsixda... test... result... When flashing my ROM I get the error "mount expects 4 args got 3"
V.0.3 using redy's original updater-script & update-script fille copy to my V.0.2 rom.. result... working perfect
V.0.4 Deodexed all files, except 3 files... result: missing market android
V.0.5 Delete bloatware and add google market apk (vending.apk)... result... good... I'm gonna use it to check the stability of this rom...
N00BY0815 said:
About the launcher, you simply have to delete one and add another one. To be on the safe side, I always renamed the new launcher to the old ones name, but the other solution works as well.
About eRecovery, idk, I need to confess, should work without, but I think you need to try. If it doesnt work, add these lines to updater-script:
set_perm(0, 0, 0755, "/system/bin/pvrsrvinit");
set_perm(0, 0, 0755, "/system/bin/pvrsrvinit2");
Click to expand...
Click to collapse
And if i add other apps that there isn't on default system, eg. OI File Manager, the app is installed automatically when i put it on system/app?
And if i want to put the beats audio mod, It's only necessary to put the file in the correct folder?
For the apps it's true, but its always better not to put too many new apps in there, since I think they cant be updated.
About beats audio, I think putting in the right folder should be enough, but pls check the updater-script and if needed add the corresponding lines to the updater-script of your ROM
Hum.... I'll try this... Worst that can happen?
s1ck82 said:
Hum.... I'll try this... Worst that can happen?
Click to expand...
Click to collapse
Worst that can happen is, you have to unbrick your device... At least as long as you dont REALLY mess it. But as long, as you stick to the guide you wont have problems I think And the unbricking guide is in my noob how to, so basically nothing can happen Just do a nandroid and your back to normal within 10 minutes
Hi... I always get trouble when using updater-script & update binary after build my rom from cygwin...
some times I get the error "mount expects 4 args got 3"
and I already changed my update-binary files from folder update_files folder...
but when I flash again CWM error (7) or sometime error (0)
sometime the resolution is to copy the update-binary and updater-script from previous Redy's rom
But now I want to make add /data/app functionality in my custom rom... and if I using update-binary and updater-script from previous Redy's rom it doesn't work...
I think the problem is in my updater script file created by cygwin:
Code:
package_extract_file("check_data_app", "/tmp/check_data_app");
set_perm(0, 0, 0777, "/tmp/check_data_app");
run_program("/tmp/check_data_app");
mount("MTD", "userdata", "/data");
package_extract_dir("data", "/data");
set_perm_recursive(1000, 1000, 0771, 0644, "/data/app");
show_progress(0.900000, 30);
format("ext4", "EMMC", "/dev/block/mmcblk0p8");
mount("ext4", "EMMC", "/dev/block/mmcblk0p8", "/system");
mount("MTD", "system", "/system");
package_extract_dir("system", "/system");
symlink("busybox", "/system/xbin/[");
symlink("busybox", "/system/xbin/[[");
I think it is missing "format" code, because it mounts system and data, but only format system...
and now i dont have a clue...
Try using a virtual machines.
Trolling in the deep
Pls gimme the full updater-script. And always watch to change update-script back to updater-script.
Because lines like these, I think are unreadable for some devices...
mount("MTD", "userdata", "/data");
mount("MTD", "system", "/system");
should look like this:
mount("ext4", "EMMC", "/dev/block/mmcblk0p8", "/system");
other mountpoints (e.g. for data) can be found by typing mount into terminal emulator.
Hope you get it working and I somewhen find time to make a step by step guid for kitchen
N00BY0815 said:
Pls gimme the full updater-script. And always watch to change update-script back to updater-script.
Because lines like these, I think are unreadable for some devices...
mount("MTD", "userdata", "/data");
mount("MTD", "system", "/system");
should look like this:
mount("ext4", "EMMC", "/dev/block/mmcblk0p8", "/system");
other mountpoints (e.g. for data) can be found by typing mount into terminal emulator.
Hope you get it working and I somewhen find time to make a step by step guid for kitchen
Click to expand...
Click to collapse
ok this is updater script from cygwin
Im still trying to mod it but get another bootloop
If you have any free time, N00by, could you tell us if/how we can use the google ADV Manager to simulate our cooked ROM ?
Hello, I am trying to make a flashable zip that replaces framework-res.apk in CM9. I have searched and read a bunch of other threads on this, but they all seem to be out of date and none of them actually address the update-binary. Whenever I flash my zip, it aborts due to "error 4" or sometimes "error 0." I have been just copying and pasting the update-binary from other zips, but it seems to give me these errors.
I've attached the .zip in case someone wants to look at it. I'm almost positive my script is solid. Thanks
Script (written in notepad++):
ui_print("Modified framework for CM9 nightly 04/02/2012");
ui_print("by korockinout13");
show_progress(1, 1.5);
ui_print("Installing now...");
run_program("/sbin/busybox", "mount", "/system");
package_extract_dir("system", "/system");
set_perm(0,0,0644, "/system/framework/framework-res.apk");
run_program("/sbin/busybox", "unmount", "/system");
ui_print("Happy didling!!!");
Try taking out the commas between the 0 0 0644 (per this).
jmtheiss said:
Try taking out the commas between the 0 0 0644 (per this).
Click to expand...
Click to collapse
That guide isn't in edify though, so those guidelines are out of date. I also think that the script would fail once it got to that step, but mine fails instantly and nothing from the script shows up at all.
in notepad ++ is it a UNIX file or Dos/Windows?
do you have a update binary compatible with ICS ? (this one took me a whole night)
sometimes its just best to start with someone elses script, erase everything and start yours, working these files on windows can be a pain.
I have also used D4 update zip maker to proof my scripts and re-save them in correct format, when i run into odd issues.
korockinout13 said:
That guide isn't in edify though, so those guidelines are out of date. I also think that the script would fail once it got to that step, but mine fails instantly and nothing from the script shows up at all.
Click to expand...
Click to collapse
cwm usually proof reads the script to make sure there are no errors and it can complete the task before it starts. if you have an error at the end of the script, nothing will happen.
error 4 isnt familiar but 0 is.
TRusselo said:
in notepad ++ is it a UNIX file or Dos/Windows?
do you have a update binary compatible with ICS ? (this one took me a whole night)
sometimes its just best to start with someone elses script, erase everything and start yours, working these files on windows can be a pain.
I have also used D4 update zip maker to proof my scripts and re-save them in correct format, when i run into odd issues.
Click to expand...
Click to collapse
Under the edit menu, for EOL conversion, I chose UNIX format after I read an article somewhere. I think that's the right place?
For the update-binary, I used one from Glitch, CM9, and also another framework.zip but it seems to fail.
I agree, I'll try using somebody else's again
Edit: Well, apparently the command for unmount is umount! I still get the same status 4 error though. I got it to work eventually by copying somebody else's script, but I have no freaking clue how it was in any way different from mine.
Click sig links at the bottom of my sig and you will find a cwm flash pack creator.