This is a very
simple guide on Aroma scripting. You can find the full tutorial for Aroma scripting here: (Link Pending)
The best way to learn is to just examine my aroma script and learn it yourself. That's what I did.
Aroma-config - It's what shows up when you flash an Aroma script. It is where you put the Mods, Apps, and features in. This will only display the selections.
Updater-script - Where it all happens. It will run a command you put in it depending on the selections you selected in the aroma-config. (It figures out what you selected using .prop files)
Let's get started:
The first step in adding a new feature in aroma is in the aroma config. You must add the following to the aroma-config, or else it won't show up as an option when you flash the ROM.
This is what it may look like after you added, say, a keyboard selection using selectbox.
"Select a keyboard:",
Ok. First, everything inside select/check box needs to be "Tabbed"(Not sure what to call it. What I mean is to press TAB on everything inside the selectbox.[I think it should be 4 spaces from where it originally is] Just make sure it looks like the rest of my options. You'll know what I mean when you see it.)
First, to make it easy, everything in the selectbox( with text will have a quotation mark around it. The only exception are the numbers at the end of each selection(i.e. "Stock Keyboard","",0,) The same with commas. Everything inside the selectbox( will have a comma after it. You use the comma to seperate anything with quotation marks. You also use it after each line, except the last line before the ); That line will not have a comma
Now let's go through this
-This is the type of box you have. With selectbox, you must choose 1, but only 1 of the options.
- This is the Title of your mod/app/whatever.
"Select a keyboard:",
- This is the icon that will show up in aroma. This image is found inside aroma/icons. Remember to use the @ before naming the icon.
This will create a tmp file that is very important in the updater script. It will call on this file in the updater-script to check which mod/app to install. You can nams it whatever you want.
"Stock Keyboard","Recommended", 1,
- This is what shows up in aroma as one of the options you can select. Let's break it down even more;
"Stock Keyboard" is what shows up as the name of your option in aroma.
"Recommended" is the smaller text that can describe your option. You can put whatever you want. To leave it blank, simply put ""
1 can also be 0. If it is 1, it will automatically be selected for you in aroma. If it's 0, it's left blank. If its a checkbox(, you can put all of them(the mod/app options) 1 or all of them 0, or some 1, some 0. But in selectbox(, you must make one option 1, and the rest 0.
Also, remember the quotation marks and commas.
What I said about the above goes for each option, except the last one will not have a comma at the end.
Now, if you use checkbox(, then everything stays the same. The only difference is that you can choose as many mods/apps as you want with checkbox. Please note there is a difference between selectbox and checkbox in the updater script.
After this, you should see an new selection box when you flash the ROM. Unfortunatley, nothing will happen if you don't add the corresponding commands in the updater-script.
Ok. So that's a brief(and probably very confusing) rundown of the aroma-config. I will edit this to make it less confusing in the future.
Are you feeling tired? Take a break then. A long break. Just go watch some TV or workout for a few hours. Take a nap. (Seriously, 'cause I'm waiting for tomorrow to do a guide on the updater-script.