[G1 Android Development] ezterry:
[size=+3]EzGingerbread[/size]

(Latest release: stable v1.0)

Welcome to the ezGingerbread Rom and Development thread

Here we discuss building, testing, and patching a basic gingerbread build for the Dream Sapphire platform.

The goal is for this to be a reasonably bare bones build gingerbread build; Focusing on memory and speed performance.

[size=+2]Installation Guide (of Binaries)[/size]

While ezGingerbread remains as open source as possible this sections will provide some pointers to installing the latest distributed binary.

(The following is automatically done if installed via Rom Manager)

Requirements

EzGingerbread works on most 32b Dream, 32b Magic (MT3G), and 32a magic devices running 2.22, and/or 3.22 radios, and will auto detect the correct configuration on install.

However the following configurations are optimal:

32b Dream: Radio-2.22.28.25 and SPL 1.33.0013d are recommended

32b Sapphire: Radio-2.22.28.25 and either SPL 1.33.0013d or 1.33.0013 (if the SPL is not already installed I recommend 1.33.0013d)

32a Sapphire w/ audio plug (ie MT2.1/fender): Radio-2.22.28.25 and either SPL 1.33.0013d or 1.33.0013 (This is likely what you already have installed, if you don't have this and your phone works you likely you don't have a MT2.1/fender)

32a Classic (no audio plug): Radio 3.22.20.17 + any SPL (however 1.33.2009 or 1.33.2010 may be better) [Note 6.x radio will not work with this rom]

Users of customMTD must have an 87 Meg system '87 2' is common. There is no need to flash the cMTD boot patch as the rom installer automatically patches the boot image for cMTD.

Download Rom related files

> The ROM: GINGERBREAD-DS-Stable-v1.0-20111204.zip (md5: 2ae9f618b0650c98b9621b37ad7e8596)

> GAPPS: gapps-mdpi-gb-20110709_S.zip (mirror)(mirror 2 -- dead) (md5: 6f9a6d27cce1f58be1f34f696212d326)

> GPRS Patch (optional but recommended) gprs_patch_S.zip (md5: fa259735ca394a650710e6b26673c91a)

> Alt Launcher [Zeam] Completely optional, but for those that want a smaller launcher, or just intend to replace the default (Launcher2) anyway with a market download this may apply to you, Note its an older version, and the newer market version has been slightly unstable:

ezgb_ZeamReplacement2_S.zip (md5: 6416ec0efa15f92f3d36f6ec6b524a11)

Language Port/Pack File

If you use (German, English, Spanish, French, Italian, Japanese, Korean, Polish, Portuguese, Russian, and Chinese)

These are contained in the base rom, do not download a language pack.

If you use (Bulgarian, Czech, Danish, Greek, Finnish, Hungarian, Dutch, Slovak, Serbian, Swedish, Tagalog, Turkish, Ukrainian)

These require lang pack 1:

EZGB_lang1_20111204_S.zip MD5: 37ee9cbf4f4c80a4b5fd96269332b853

Copy Files to the phone

Copy all the downloaded zip packages to your SD Card, Remember Ra-Recovery users must put them on the root of the sd-card.

wipe or not to wipe, and other preparations

> Users upgrading from

GINGERBREAD-DS-Alpha-20110509-1, Beta builds, or the Gamma build

There is no need to wipe as long as you wiped when you first installed one of these versions of ezGingerbread. You are however encouraged to uninstall SetCPU or other overclock software, and backup your rom before installing. (if the new built in CPU Speed function is not to your liking feel free to disable and re-install the 3rd party overclock software after upgrading)

> Users New to ezGingerbread (upgrading from a different rom)

You are encouraged to wipe before installing, however feel free to use Titanium or other utility to back up your application and application data to be restored after installation.

Installing the rom

flash in the following Order:

> GINGERBREAD-DS-Stable-v1.0-20111204.zip

> [If you need it] EZGB_lang1_20111204_S.zip

> gapps-mdpi-gb-20110709_S.zip

> [optional but recommended] gprs_patch_S.zip

> [if you chose it] ezgb_ZeamReplacement2_S.zip

Reboot

Reboot the phone and wait for the screen to dim before interacting with the phone

(First boot will take additional time; longer if you had many applications installed and are doing a no-wipe upgrade)

[size=+2]Tips and Tricks[/size]

Now that the system is installed I have some pointers to making the system as fast as possible, you may ignore these if you really must have something they don't allow but if the phone runs slower you know why:

Tip 1: Google Maps: If you can live without it the phone will be much more stable.. (Maybe using mapquest as an alternative) However if you really do need Google Maps note the newer versions require much more resources than the older ones.

If you must have google maps try an older version rather than maps 5+

Google Maps 4.7 (mirror) MD5: b8c558351949be97eb8703d1f4a05807 (download/place on SD card and install with File Manager)

Brut Maps based on Maps v4.6

Tip 2: Facebook: Well I can't say facebook was ever fast on our slow Dream, but the most resent versions run an "Upload Service" 24/7 in the background eating much unnecessary ram.. v1.6.4 is the newest version I know of without this behavior.

Tip 3: Apps2SD, well best to keep apps you want to use frequently of quickly on the system, but to enable Apps2SDext if you have an ext partition here are the directions:

> goto settings->Applications->Development

> Check SD-EXT

> Reboot

> Now you can use the Manager Applications screen to move apps to/from sd-ext .. if you want sd-ext to be the default install location choose it in Settings->Applications->Preferred install Location

> Data2sd will move all your application data to the sd-ext partition.. this will significantly slow down the phone thus best to leave unchecked.

Tip 4: SuperUser

The system by default prevents the update of superuser or anything signed with the same key (such as superuser elite); to temporary lift this restriction goto Settings->Applications->Development and check Update Superuser.

This will allow superuser to be updated, superuser elite to be installed/updated until reboot.

This ensures no application can change Superuser.apk on your behalf when you do not expect it thus can't grant themselves superuser access.

Tip 5: EzGb Extras

Settings->EzGingerbread Extras

This menu has historic "Spare Parts" funcitons, as well as other performance enhancements.

> Configure PowerWidget allows you to configure the powerbar widgets, when you are done configuring either reboot, or rotate the display to re-set the widget and see the update

> Incoming Call TouchUI - enables the slide to answer/end calls when a call comes in, rather than only being able to use send/end hardware buttons

> Busybox NTP Cliemt - If your phone is not keeping time, even with the sync to network time enabled, checking this may help keep the phone in sync with earthly time

> CPU Speeds, This lets you overclock and under volt, I recommend setting Min speed to 128000, leave Max screen off 480000, and max screen on may either stay 528000, or very slightly overclock to 537600. If you want the settings to apply after your next boot tap "Apply On Boot" if you have problems with the settings, before the screen turns off after boot enter this screen and tap "Reset CPU Settings" before rebooting again.

> Compcache RAM Usage, sets the amount of compcache, keep this as low as possible but not so low background services keep restarting.

> Use KSM Module, this may improve ram usage if checked, however may also slightly increase CPU usage and reduce battery life (all three results are very slight and thus hard to notice) no restart is required so test when/if it works best for you

> Window/Transition animatinos, since froyo animation times have been increased.. many find speeding these up make the rom feel more responsive as they are historically used to.

> End button behavior: choose "go to sleep"

> Haptic feedback/Compatibility Mode .. most will leave these alone

Tip 6: Surface Dithering:

Well this is a trade off [Settings->Display->Surface Dithering] if its checked the display may loose some more frames than if unchecked.. but some people rather loose the frames than see the artifacts left by skipping the dither, choose your poison and reboot

Tip 7: sync: disable what you can

Go into settings -> Accounts &sync

Tap your Google Id. Unless otherwise needed, unchecked Sync Picasa Web Albums, and Books

If you have Google plus you may also wish to disable Sync Instant Upload.

Historic versions, and additional addons can be found below in post 2

[size=+2]Kernels:[/size]

Regarding kernels: If you are looking for stand alone kernels (sometimes there is an update between official releases; or for use in other roms):

See the Stand Alone Kernel Post

The Stand Alone Kernel Post contains both the ezgb-2636 kernels and links to the tags in github they are built from.

[size=+2]Developers:[/size]

Developer's Guide (How to build ezGingerbread and the ezgb2636 kernel) is now on GitHub:

https://github.com/ezterry/manifest-gingerbread-DS/blob/gingerbread/README.mkdn

Includes instructions to fetch and build from source both ezGingerbread and its related kernel.