[Epic 4G Themes] dreamsforgotten:
Meta Morph tutorial

by Dreamsforgotten​

This is a primer in using MetaMorph on the Samsung Epic, at the time of writing I'm using a froyo leak with the Bonsai 2.0.1 rom so MetaMorph being a little buggy for us now will probably clear up when official is out. The bottom of the guide addresses what I'm talking about.

Create a folder on your desktop. Call it froyo (or whatever).

Inside that folder make one called framework-res (don't put the .apk)

Inside that folder put the folders you need to edit example

If I want to change the images in drawable-hdpi, make the folders like this

froyo/framework-res/res/drawable-hdpi

so inside the froyo folder create "framework-res". Inside framework-res create "res". Inside res create "drawable-hdpi". It follows the same structure as apk manager when you decompile. If you want to edit the styles.xml, that gets recompiled into resources.arsc. If you are in apk manager and you goto projects, you'll see unsignededitedframework-res, open it and right inside you'll see resources.arsc, androidmanifest.xml, res, meta inf, etc. So to MetaMorph the resources.arsc, your NEW resources.arsc goes into

froyo/framework-res/

Do this for any .jar or .apk file, create your folder structure and put only the new files into the folder, you don't have to flash an entire drawable-hdpi folder only the files you are changing.

Next thing you need to do is make a xml file that tells metamorph what files your editing and links the folders you created to that file. Do that like this:

Inside the froyo folder, create a text file. Either open Notepad and save the file into this folder or right click choose new file, text file. Set your .xml file up like this:

<?xml version="1.0"?>

<themename>Crystalline Froyo</themename> <--You can call this whatever

<themeversion>2.1</themeversion> <--Number that whatever number you want

<screenshot></screenshot> <--include a screenshot if you like. put the screen in /froyo and type the file name here

<author>Dreamsforgotten</author> <--your name

<authorweblink>http://xdaforums.com/member.php?u=2551535</authorweblink>

<phone>Samsung Epic</phone>

<rom>Bonsai 2.0.1</rom>

<themedescription>UI Improvements for Crystalline Froyo</themedescription>

<item>framework-res.apk</item>

<path>/system/framework/</path>

<description>**** a Reboot Required</description>

Now the line right above this <item, path, description> You have to follow this for any folder your updating. Notice in the <item> space, you put the actual apk name being edited. So here I have <item>framework-res.apk</item> This tells metamorph to put your edits from the folder you named framework-res into framework-res.apk in the same structure as you set up, ie /res/drawable-hdpi or /res/anim whatever it is you might be editing. It's that simple. Now say you wanted to theme the market. You can use metamorph to theme system apps, but NOT market apps!!!!!! You would do this

<item>vending.apk</item> <--name of APK

<path>/system/app/</path <--path to the APK

<description>Market Update</item> <--whatever you like for descripton

You would put somewhere inside the xml as well. You can put the instructions for MetaMorph to flash in any order you like, You can theme apks first, framework-res first, however you like, BUT its good practice to put the framework-res last because it causes a reboot and anything behind it won't flash. Samsung devices pay attention, TWframework-res and framework-res both require a reboot, so you have to have two separate metamorph zips.

Now, moving along. You have your xml file with all the fields written properly, you have your folder structure set up you just need to do two more things. Inside your original froyo folder on your PC, create a blank text file. Name it .nomedia that (dot).nomedia don't forget the period. This tells media scanner not to add all your images from this zip into your gallery. It's very important. Now the final step, zipping it all up to flash. Whatever you chose to name that xml file for example I used this on the last one I created. crystalline2.1.xml This was the name of my theme control file (the .xml file inside of froyo) so your zip file HAS to be named the same exact thing. If your xml is theme.xml, then your zip has to be theme.zip. If your xml file is theme1.2.xml then your zip file has to be theme.1.2.zip. It will error if the zip and xml file don't match. That's it copy it to your SD card under AndroidThemes, open MetaMorph and apply!

Keep in mind MetaMorph has a 500 file limit and gets buggy when you push it toward the 500 mark. Break large themes into 2-3 different files if you must. You already have to have two separate flashes for our two frameworks on the Epic so you might as well split the images between the two anyway.

One last note on MetaMorph on the Epic. I'm using the latest and I noticed sometimes you open it and it closes right back, or you go to extract a new theme and it closes. Seems that the free version has issues with displaying the ads (which could be due to the host file on Bonsia I'm running, not sure, but when you open MetaMorph, give it time for the ads to load before hitting the start checks button. If the ads at the top and bottom of the app don't load soon, and it doesn't close on its own, proceed. If you give it time for the ads to load and it crashes, just open it right back up. Sometimes it takes me 2-3 times opening MM to get it to stay on the screen but after it does, the flash goes smooth every time.