8. Error handling and typical problems

Things are not always working as they should. This section gives an overview over typical problems and how to solve them.

8.1. Workspace

Never use a workspace in Eclipse which has spaces in the directory path name, this may lead to several strange problems.

8.2. Clean Project

Several users report that they get the following errors:

1. Project ... is missing required source folder: 'gen'
2. The project could not be built until build path errors are resolved.
3. Unable to open class file R.java.

To solve any of these errors, go to the project menu and select Project → Clean.

8.3. Problems with Android Debug Bridge (adb)

The communication with the emulator or your Android device might have problems. This communication is handled by the Android Debug Bridge (adb).
Eclipse allows to reset the adb in case this causes problems. Select therefore the DDMS perspective via Window → Open Perspective → Other → DDMS
To restart the adb, select the "Reset adb" in the Device View.

8.4. LogCat

The "LogCat" View shows you the log messages of your Android device and helps you to analyze problems. For example Java exceptions in your program would be shown here. To open this view, select Window → Show View → Other → Android → LogCat.

8.5. Android editor not opened

Android provides nice editors to edit Android resource files, unfortunately these editor are not always automatically used due to bugs in the ADT. If that happens, you can open this editor manually. Right-click on your menu file and select Open with → Android Menu Editor.

8.6. Emulator does not start

If your emulator does not start, make sure that the android-sdk version is in a path without any spaces in the path name.

8.7. Timeout during deployment

If you face timeout issues during deployment you can increase the default timeout in the Eclipse preferences. Select Window → Preferences → Android → DDMS and increase the "ADB connection timeout (in ms)" value.

8.8. Installation failed due to insufficient storage

Sometimes the emulator will refuse to install an application with the error message: INSTALL_FAILED_INSUFFICIENT_STORAGE.
An Android virtual device provides per default only 64M for the storaging Android applications. You can clean your installed application by re-starting the emulator and selecting the "Wipe user data" flag.
Alternatively you can set the data partition size. If you press edit on the AVD, you can set the "Ideal size of data partition" property via the "New" button.

8.9. Debug Certificate expired

If you get the error message "Debug Certificate expired" switch to the folder which contains the Android AVD, e.g. ".android" under Linux and delete the "debug.keystore" file. This file is only valid for a year and if not present, Eclipse will regenerate the password.

8.10. Error message for @override

The @override annotation was introduced in Java 1.6. If you receive an error message for @override, change the Java compiler level to Java 1.6. To do this, right-click on the project, select Properties → Java Compiler → Compiler compliance level and select "1.6" in the drop-down box.

8.11. Missing Imports

Java requires that classes which are not part of the standard Java Language are either fully qualified or declared via imports.
If you see an error message with "XX cannot be resolved to a variable", right-click in your Editor and select Source → Organize Imports to important required packages.

8.12. Eclipse Tips

To work more efficiently with Eclipse, select Window → Preferences → Java → Editor → Save Actions and select that the source code should be formated and that the imports should be organized at every save action.