Compatible with Windows (Cygwin) / Linux / Mac OS X
Who is this kitchen for?
Please note:
Code:
=================================================================== Android Kitchen - by dsixda (xda-developers.com) =================================================================== Main Menu 1. Set up working folder from ROM 2. Add root permissions 3. Add BusyBox 4. Disable boot screen sounds 5. Add wireless tethering 6. Zipalign all *.apk files to optimize RAM usage 7. Change wipe status of ROM 8. Change name of ROM 9. Check update-script for errors 10. Show working folder information Advanced Options 11 - Deodex files in your ROM 12 - Add task killer tweak for speed (stock ROM only) 13 - Add /data/app functionality 14 - Add Nano text editor + sysro/sysrw 15 - Add Bash (command shell) 16 - Add Apps2SD 17 - Add /etc/init.d scripts support (busybox run-parts) 18 - Add custom boot animation functionality 19 - Porting tools (experimental) 20 - Tools for boot image (unpack/re-pack/etc.) 21 - Unpack data.img 22 - Sign APK or ZIP file(s) 23 - Convert update-script or updater-script 24 - Miscellaneous optins / Plugin scripts 99. Build ROM from working folder 00. About/Update kitchen 0. Exit
Quote:
Currently there is support for the following devices: How to add new devices: Kitchen Help - List of Supported Android Devices - Look above in this post for details! - ALL INSTRUCTIONS, FREQUENTLY ASKED QUESTIONS, AND HELP - Posts #3 and #4 - Release Notes - Post #2 - General questions about Linux/Mac/Cygwin - Use Google Download Kitchen If you've read the above, are aware of the supported devices listed, know where the release notes for each version are (post #2), agree to read the FAQ for setup and help (posts #3 and #4), agree to not ask for new features, and agree to stop asking a 1000th time ;) about unsupported devices (I don't have them and I really don't have time for so many devices anymore), then click below to download the kitchen from GitHub. Have fun and I hope you support my work! Support my work [ DONATE / FOLLOW ON TWITTER] Follow my updates on Twitter, or optionally send me a donation (will go towards medical expenses, toys for my kids, etc.) Download (optional) user-contributed plugins for Kitchen See post #5 Acknowledgements See post #5
[Follow me on Twitter] [My GitHub] [dsixda's Android Kitchen] [CWM for SGH-I757M] [CM9 for SGH-I757M] [CM10 for SGH-I757M] [Onyx ROMs for HTC Elf/Elfin] |
|
|
The Following 915 Users Say Thank You to dsixda For This Useful Post: [ Click to Expand ] |
|
|
Ads by Google
|
xda-developers
|
Embedded Developer Tools
Vybrid controller solutions based on ARM cores. Freescale.com/Vybrid |
The Following 212 Users Say Thank You to dsixda For This Useful Post: [ Click to Expand ] |
|
|
15th February 2010, 07:49 AM
(Last edited by dsixda; 14th March 2013 at 06:07 AM.) Reason: Updated cygwin_install.txt with more specific instructions
#3
|
|||||
Recognized Developer / Retired Senior Moderator -
OP
Thanks Meter
3508
Posts:
9,477
Join Date:
Nov 2007
Location:
Ottawa
MORE INFO
>
|
Frequently Asked Questions - Page 1
PLEASE DO NOT DUPLICATE THIS POST UNDER YOUR OWN THREAD What operating systems are supported, and how do I set them up for the kitchen? Choose one of the installation methods based on your computer's current operating system:
Quote:
Quote:
Quote:
After following the setup for the operating system, how do I use the kitchen? Summary:
Detailed instructions (for newbies): How do I import a ROM into the kitchen to use as my base? (The instructions below are for HTC devices in general. For other devices, please visit the appropriate thread.) Please see Page 2 of FAQ (Other Questions) - in next post! .
ATTACHED FILES
[Follow me on Twitter] [My GitHub] [dsixda's Android Kitchen] [CWM for SGH-I757M] [CM9 for SGH-I757M] [CM10 for SGH-I757M] [Onyx ROMs for HTC Elf/Elfin] |
|||||
|
The Following 207 Users Say Thank You to dsixda For This Useful Post: [ Click to Expand ] |
|
|
15th February 2010, 07:49 AM
(Last edited by dsixda; 13th March 2013 at 12:45 AM.)
#4
|
Recognized Developer / Retired Senior Moderator -
OP
Thanks Meter
3508
Posts:
9,477
Join Date:
Nov 2007
Location:
Ottawa
MORE INFO
>
|
Frequently Asked Questions - Page 2
PLEASE DO NOT DUPLICATE THIS POST UNDER YOUR OWN THREAD QUESTION: Does the kitchen support ROMs for Device X?? See post #1. If it is not listed there then I have not done anything for it, and I have no idea about it. Keep in mind that this is primarily a kitchen for HTC devices. Most of the ROMs for non-HTC devices that are supported in the kitchen are there because they are easy to support, as their file structure is not much different from that in HTC ROMs. However, certain devices use a completely different ROM file structure, so they are currently not supported in the kitchen. I am also limited by the fact that I only own one or two Android devices at a time, which affects the extent of my testing. Finally, please don't expect me to do every Android known device known to man, as I am a busy guy with mouths to feed, like a lot of you. QUESTION: Whenever I double-click on the 'menu' file in Linux or Mac OS X, the screen immediately closes or I get an error like "File not found." No, do not click on the file. You were instructed to type "./menu" from the command prompt. Follow the instructions as they have been given. Please refrain from asking me this question again and again, or from requesting me to fix it - double-clicking is not how shell scripts are meant to be run!! QUESTION: Whenever I type ./menu to start the kitchen it says "Permission denied." Your file attributes are somehow missing the 'execute' flag. Type the command chmod 777 menu (or chmod +x menu) and try ./menu again. QUESTION: In Cygwin whenever I type ./menu it says the 'clear' command (and/or other binaries like 'chmod') is not found. Read this for possible solutions; however, these instructions only apply if you used the old (2010-2012) method of installing Cygwin for the kitchen. QUESTION: What versions of the Java JDK are supported with this kitchen? I have successfully built ROMs using Java 5 JDK and also later versions. QUESTION: In the Advanced Menu's boot.img tools, why is there only an option to unpack a boot.img but not to re-pack it? There is an option, you just need to unpack it first! Read this. QUESTION: When I flash a ROM I get an error with a Status code. What does it mean? Why don't you read the full error message first so that you understand why it's failing. Next, google the error. Anyways, this is what the status codes should mean:
QUESTION: I flashed a ROM and when it boots, it gets stuck on the splash screen (boot loop) or goes back to recovery menu. If you are stuck on the splash screen, the first thing to try is to wipe the cache and dalvik-cache from the recovery menu. A full wipe may also be required, although I would not recommend it until you try the suggestions below. Debug the issue with "logcat" (you need the Android SDK to use it):
QUESTION: After I flashed a ROM, it doesn't boot but I get 'File not found' and/or 'No such file or directory' (usually in reference to /system/bin/sh) error messages in logcat. The /system partition was not flashed properly due to an issue on your device. This usually could mean one of the following:
QUESTION: I get errors in the recovery menu when I flash a ROM. This may mean your update-script/updater-script has errors or there is an issue with how the kitchen created your ROM. Read the rest of the FAQ for potential solutions, or you may need to inspect the recovery.log to debug the issue (see above). QUESTION: When I flash my ROM, some of my changes don't appear, e.g. Apps copied to my working folder's /data/app. Check the recovery.log to debug the issue (see above). QUESTION: Can you help me port a ROM? Or can you tell me if Device X's ROM can be ported to Device Y? No, I am not an expert on porting so I cannot help you; however, there is a Porting option in the kitchen. Keep in mind though that it is not the magic solution for all devices and will not work all the time. It uses a very generic set of rules for porting, which can be seen if you open up the appropriate script files. The recovery log and logcat tool should help you debug issues with porting (see instructions above). QUESTION: What is an update-script or updater-script file? This is a file found under the META-INF/com/google/android folder, and specifies the operations required for flashing your ROM. It performs various file operations, such as creating file shortcuts (also known as symlinks or symbolic links), adding permissions to files, running scripts and copying files and folders. After flashing your ROM this file is not executed again. The updateR-script is more advanced than the update-script and supports more devices. When you see someone refer to "Edify" format they are talking about the updateR-script; whereas "Amend" format refers to update-script. The updateR-script also requires an update-binary file included with it. The update-binary contains all the binaries for the commands that the updater-script uses (e.g. set_perm, symlink, format, mount, etc.). The update-script does not need an update-binary. Unlike the update-script, the updater-script is supported in newer versions of ClockworkMod Recovery. QUESTION: Why do I need to convert the ROM's updater-script to an update-script when using the kitchen? First of all, the kitchen supports updater-scripts. BUT, the problem is that the updater-script in different devices (and by different authors) may use various formatting/alignment styles, mount points, partition types and may also employ different commands for the same functionality, and thus there would be an awful lot of variations to check for every time a kitchen script is using it. Hence at the beginning, the kitchen will convert the updater-script into a universal format (e.g. I chose the update-script format) so that all the scripts of the kitchen will work on the ROM without encountering these issues. When the ROM is built, the kitchen converts it back to an updater-script with the correct syntax, and the partition details are fully restored. If we didn't convert the updater-script then it would take A LOT OF work to overhaul the dozens of scripts to accept updater-scripts, which would really NOT make a difference in the end anyway, and would likely slow down the kitchen due to extra checks made in the updater-script. So please do not request this again and again, there is no gain in doing it. Believe me, I have spent many months and stayed up late many, many nights getting this update-script/updater-script compatibility issue working with the kitchen with all ROMs and numerous HTC and non-HTC devices. When you build the ROM you have the option of converting it back to an updater-script, or the kitchen will convert it automatically if it decides it's necessary. The conversion back to the original updater-script is near-perfect, as I have already spent months on the implementation to get it right. If you want to instead convert your updater-script or update-script *before* you build, then use the option found under the Advanced section of the kitchen menu. QUESTION: I have converted my update-script to an updater-script, but after flashing I still have the original ROM on the device. That means your updater-script did not have the proper mount points defined for the system (and/or data) partition. Refer to this post for more info. EDIT: You can now add your own mount-point definition file to the kitchen's "tools/edify_defs/" folder for when it creates the updater-script for your device. QUESTION: My device only supports ROMs with the updater-script/update-binary files but not the update-script If you extract a ROM that contains an updater-script, then the kitchen will ask you if it should convert it to an update-script. You *must* use an update-script while customizing the ROM, as the kitchen is not capable of modifying updater-scripts. When you are ready to build the ROM, though, you will need to convert it back to an updater-script if the device requires it. Use the option in the Advanced menu to convert update-script to updater-script, or else the kitchen will ask you to convert it while building the ROM. QUESTION: When flashing my ROM I get the error "mount expects 4 args got 3" or similar. This refers to the fact your mount command takes 4 parameters (e.g. ext4, EMMC, /dev/block/.., /system) and your update-binary file only checks for 3 parameters. You'll have to change the update-binary file to a compatible one, found under the /tools/update_files folder. Just copy the appropriate file and rename to update-binary. e.g. If you're going to be using MTD partitions, copy 'mtd-update-binary' to /META-INF/com/google/android as "update-binary". QUESTION: How do I get Ubuntu to see my device with ADB? First, download the Android SDK and copy it to a folder like ~/AndroidSDK/ Then, use the following commands:
Code:
cd ~/AndroidSDK/tools ./adb kill-server sudo ./adb start-server ./adb devices QUESTION: I get the following error when flashing a ROM: E:Board does not support mtd utils.E:Failure atline 77: write_raw_image PACKAGE:boot.img BOOT: Please see this post for the solution. In some recovery menus the boot.img cannot be flashed straight from the ROM's ZIP, so it needs to be copied first to a temporary area on your device and then flashed from there. QUESTION: How do I add or port a kernel to my kitchen's working folder? Follow the instructions here. QUESTION: I get busybox errors during flashing; e.g. "Can't chown/mod /system/xbin/busybox (No such file or directory)" or "E:Can't symlink busybox ..." Apparently you need to upgrade your SPL, and it has nothing to do with the kitchen:
QUESTION: While flashing my ROM, I get an error about 'assert getprop ("ro.product.device")'. Read about a solution here. You will likely need to modify your build.prop and update-script files in the kitchen and rebuild the ROM. QUESTION: I created a ROM with root permissions, but whenever I access an app with the superuser prompt, it hangs or force-closes. Under Settings/Applications, ensure that USB Debugging is enabled. You probably disabled it after flashing your ROM. QUESTION: When I flash my ROM in the recovery menu, I get an error like "E:Can't open (bad)". You may need to change your custom recovery menu. For example, see here. QUESTION: How do I add a theme to my ROM? I don't know, as I just write the scripts and am not a ROM theming/modding expert. Please ask in the forum but not this thread, as I cannot help you with your question. Sorry. QUESTION: Can you add APK decompilers and other APK modding tools? Or how about PNG optimizers? See this answer. QUESTION: Can you give me an explanation of de-odexing? De-odexing will take the *.odex files in your ROM and convert them into classes.dex files, which will then be zipped into their corresponding APK or JAR files. For a technical overview, read this. A short summary of why it is used is in this post. QUESTION: Can you add an option in the kitchen to odex a de-odexed ROM? No. I don't know how to do it with a kitchen and probably don't have the time at the moment. There is a way to do it, but not from your computer. The odex script must be run on your device - within the Android command shell - after the de-odexed ROM has been flashed (I don't have the script, just Google it). (Here's a thread about it but the link to the script is dead.) QUESTION: Why do some applications in the data/app folder force-close and others don't? Probably they have native libraries which are not installed after you flash your ROM. Use the Application Verifier in to check such apps, and to make the required update.zip to flash after you have installed the ROM (see the Plugins section in this thread, after the FAQ). QUESTION: When we build the ROM, why can't we create a new system.img instead of a ZIP file? Read this post. QUESTION: What is Apps2SD and what version does the kitchen use? There are multiple 'types' of Apps2SD -- one is the implementation found in Android 2.2+ that gives you the option of moving your apps to the SD card. Normally however, this does not move all of the app components to the SD card, and not all apps support this feature. The other Apps2SD is sometimes referred to as "Apps2Ext" and requires an extra step by the user beforehand to format a new EXT-based partition on your SD card for the apps (normally an SD card is in FAT32 format). Unlike the 'Froyo Apps2SD', the Apps2Ext feature moves everything to the SD card, even apps that normally do not support the storage card option. The Apps2Ext version is found in the kitchen as DarkTremor's Apps2SD (by XDA user tkirton) and supports older devices that have a very limited amount of internal storage. QUESTION: I am using Ubuntu Linux on a 64-bit Windows PC, and whenever I run 'zipalign' I get an error about "No such file or directory". You need to install the Ubuntu package "ia32-libs". QUESTION: Can you include an option to overwrite the ROM's existing Apps2SD with the one in the kitchen? Answered here. QUESTION: Can I copy this FAQ for my own thread? No, that's plagiarism. You are a lazy bum and I will hate you. .
[Follow me on Twitter] [My GitHub] [dsixda's Android Kitchen] [CWM for SGH-I757M] [CM9 for SGH-I757M] [CM10 for SGH-I757M] [Onyx ROMs for HTC Elf/Elfin] |
|
The Following 132 Users Say Thank You to dsixda For This Useful Post: [ Click to Expand ] |
|
|
15th February 2010, 07:58 AM
(Last edited by dsixda; 16th October 2012 at 12:04 PM.)
#5
|
Recognized Developer / Retired Senior Moderator -
OP
Thanks Meter
3508
Posts:
9,477
Join Date:
Nov 2007
Location:
Ottawa
MORE INFO
>
|
OPTIONAL: Download User-Contributed Plugins (used in Advanced Menu of Kitchen)
Acknowledgements Thanks to all the people who use the kitchen and also to those who voluntarily donated. Reading and searching will always help you in this forum. I learned everything from several places, but these are the best sources:
[Follow me on Twitter] [My GitHub] [dsixda's Android Kitchen] [CWM for SGH-I757M] [CM9 for SGH-I757M] [CM10 for SGH-I757M] [Onyx ROMs for HTC Elf/Elfin] |