For the known issues in the current versions of the tools, see the Known Issues page.
Tools 22.6
The command line lint script (tools\lint.bat on Windows platforms, tools/lint on other platforms) and the lint target on ant builds fail with the following error:
Exception in thread "main" java.lang.NoClassDefFoundError: lombok/ast/AstVisitor
As a temporary workaround, rename the file tools\lib\lombok-ast-0.2.2.jar
to tools\lib\lombok-ast.jar
. We will release an updated version of the tools with a fix for this issue as soon as possible.
Android Studio 0.5.1
Creating a new
blank file does not work (New > File). Other types of files are not affected -- New Java class, package, Android resource file works. We'll fix this in 0.5.2.
https://code.google.com/p/android/issues/detail?id=66818Android Studio 0.5.0
If you are on Mac OSX, and you are trying to use Java 7 to run Android Studio, the IDE may not start. There are two possible workarounds:
- Invoke
/Applications/Android Studio.app/Contents/MacOS/studio
directly - Switch back to Java 6 on OSX. (NOTE: You do not need to run Android Studio with Java 7 in order to use Android 4.4 language features; the IDE can use a different JDK than the one associated with your project.)
Edit your Android Studio.app/Contents/Info.plist
file back to using <string>1.6*</string>
Android Studio 0.4.6 & 0.5.0
The "build" directory in Java-only project modules (non-Android) is being excluded, causing ClassNotFoundExceptions in the layout preview/editor if you use these library classes from custom views. A workaround is to open the .iml file in the module and remove the line:
<excludeFolder url="file://$MODULE_DIR$/build" />
Android Studio 0.4.1
There is a bug which prevents building the project from working sometimes (see issue
64607). We've fixed this issue in 0.4.2 which is now available; please upgrade.
Android Studio 0.4.0 & Gradle 1.10
Note: You must use Gradle 1.9 with Gradle 0.4.0. Gradle 1.10 will not work.
Android Gradle Plugin 0.6.2
The Android Gradle plugin 0.6.2 was published with incorrect dependencies. There isn't a way to delete it, so we have instead release 0.6.3 which fixes the problems. Just switch your version from 0.6.+ to 0.6.3, or run gradlew with --refresh-dependencies to force Gradle to look for an update.
dependencies {
classpath 'com.android.tools.build:gradle:0.6.+'
}
instead of
dependencies {
classpath 'com.android.tools.build:gradle:0.6.3'
}
Android Studio 0.3 /
Using JDK 6 on Linux
On some Linux systems, Studio fails with this error message: "The window must use a translucency-compatible graphics configuration". To work around this, use JDK 7 instead. This is bug http://youtrack.jetbrains.com/issue/IDEA-114626 which will be fixed in the next version of Studio. 0.5.0 Upgrade
As noted in
Android Studio 0.2.0 Released, you will need to update your projects to the gradle plugin 0.5; without that, project import and sync will not work in the IDE.
If you prefer to make this change by hand, you basically need to find
dependencies {
classpath 'com.android.tools.build:gradle:0.4.0'
}
and replace it with
dependencies {
classpath 'com.android.tools.build:gradle:0.5.+'
}
(You can use "0.5.1" instead of "0.5.+" if you prefer; the latter will basically automatically adapt to 0.5.2, 0.5.3 etc as they are released.)
NOTE: You should not use 0.5.0; use 0.5.1 if you do not want to use the + syntax. We've released a new version to fix a bug in 0.5.0. Search for "VariantDependencies" in this document to see the relevant troubleshooting section.
Bundled Maven Repository
If for some reason you are using a different SDK than the bundled one, you may run into the following gradle build error if your project depends on the v4 support library:
FAILURE: Build failed with an exception.
* What went wrong:
A problem occurred configuring project ':MyApplication'.
> Failed to notify project evaluation listener.
> Could not resolve all dependencies for configuration ':MyApplication:_DebugCompile'
.
> Could not find any version that matches com.android.support:support-
v4:13.0.+.
Required by:
MyApplicationProject:
MyApplication:unspecified
* Try:
Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output.
BUILD FAILED
To fix this, open the SDK manager, and make sure that the "Android Support
Repository" (not just Android Support Library) is installed:
Corrupted Install on Windows
There are some reports that on Windows, running the installer will simply install 0.2.0 in place on top of 0.1.9. And apparently that can lead to problems.
One symptom of this is the following error message:
6:40:33 PM ClassCastException: cannot assign instance of com.android.build.gradle.
internal.model.
DependenciesImpl to field com.android.build.gradle.
internal.model.
ArtifactInfoImpl.dependencies of type com.android.builder.model.
Dependencies in instance of com.android.build.gradle.
internal.model.
ArtifactInfoImpl: cannot assign instance of com.android.build.gradle.
internal.model.
DependenciesImpl to field com.android.build.gradle.
internal.model.
ArtifactInfoImpl.dependencies of type com.android.builder.model.
Dependencies in instance of com.android.build.gradle.
internal.model.
ArtifactInfoImpl
To fix this, move the older installation out of the way before running the 0.2.0 installer (or alternatively, uninstall it first).
Task 'assemble' not found
If you get the following error message:
Gradle:
FAILURE: Could not determine which tasks to execute.
* What went wrong:
Task 'assemble' not found in root project 'MyProject'.
* Try:
Run gradle tasks to get a list of available tasks.
The real problem is that previous version of Android Studio misconfigured the IDEA file (e.g. MyProject.iml) -- it added an extra "<component name="FacetManager">" XML element that shouldn't be present. In the case above, the solution is to edit "MyProject.iml" and to remove the "<component name="FacetManager">" part as shown here:
<?xml version="1.0" encoding="UTF-8"?>
<module external.system.id="GRADLE" type="JAVA_MODULE" version="4">
<component name="FacetManager">
...remove this element and everything inside such as <facet> elements...
</component>
<component name="NewModuleRootManager" inherit-compiler-output="true">
...keep this part...
</component>
</module>
Alternatively you could remove the project's .idea folder and iml files and re-import your sources into a new Android Studio project.
In the next release we'll fix this -- there will be a "fix this" button to do that fix automatically for you.
No such property: type for class: com.android.build.gradle.internal.dependency.VariantDependencies
If you run into the following compilation error:
> No such property: type for class: com.android.build.gradle.
internal.dependency.
VariantDependencies
...
Caused by: groovy.lang.
MissingPropertyException: No such property: type for class: com.android.build.gradle.
internal.dependency.
VariantDependencies
Possible solutions: name
at com.android.build.gradle.
internal.dependency.
DependencyChecker.
getConfigName(
DependencyChecker.groovy:81)
at com.android.build.gradle.
internal.dependency.
DependencyChecker.excluded(
DependencyChecker.groovy:53)
at com.android.build.gradle.
internal.dependency.
DependencyChecker$excluded.
call(Unknown Source)
This is a bug in the gradle plugin version 0.5.0. We released a new version, 0.5.1, which fixes this.
If you are using this dependency:
dependencies {
classpath 'com.android.tools.build:gradle:0.5.0'
}
you should replace it with 0.5.+ or 0.5.1:
dependencies {
classpath 'com.android.tools.build:gradle:0.5.+'
}
If you are already using 0.5.+, it may not immediately detect that there is a better version than 0.5.0 available, because gradle does not connect for every build; it checks for updates at a regular interval, perhaps a day.
You can run with --refresh-dependencies
to force gradle to check for new versions in its dependencies.
Windows: Application doesn't launch [fixed in 0.1.1]
We have 2 possible issues:
- On some systems the launcher script does not find where Java is installed. Workaround is to set a variable indicating the location of Java [
b/55281]: - Open Start menu > computer > System Properties > Advanced System Properties
- In the Advanced tab > Environment Variables, add new system variable JAVA_HOME that points to your JDK folder, for example C:\Program Files\Java\jdk1.7.0_21.
- Another issue we found is that the launcher script uses an option that is unknown to Java on some system [
b/55267] - Open the installation folder of Android Studio (e.g. C:\Programs Files\Android\android-studio, or C:\Users\<username>\AppData\Local\Android\android-studio) and find the "bin" directory in there.
- Open a "cmd.exe" (command prompt), cd to the android-studio\bin folder and run "studio.bat". You will most likely see an error: for example b/55267 is about the option -XX:+UseCodeCacheFlushing not being recognized. Report the error, remove the line from the studio.exe.vmoptions or studio64.exe.vmoptions and it should now work.
Apologies for this weak launcher.We know 0.1 is pretty rough and we're working actively on getting things better.
Tools R20
SDK Manager- If you have Tools 20.0.1 and don't see the latest 20.0.3 update, a simple solution is to open SDK Manager Tools 20.0.1 and use the menu Packages > Reload. You will then see the Tools 20.0.3 update.
- Explanation: The SDK Manager in Tools 20.0.0 now has a cache mechanism -- it keeps a local copy of small manifest XML files to perform a faster start when opened. There's also a mechanism to automatically update the cache. However in Tools 20.0.0 and 20.0.1, that refresh is broken and in some conditions the manager will not show new tools that are available unless a reload is performed. Clearing the SDK Manager cache or manually forcing a reload forces the manager to get the latest manifest.
Tools R15
SDK Manager- When using the command-line interface to install packages, system-images are not installed. [See issue for a workaround:
21880]
Tools R14
Emulator
- Fixed in r15. Wipe data is broken. Manually remove userdata-qemu.img from the AVD folder under .android/avd/<avdname>.avd/ (Mac/Linux: in ~, Windows XP: C:\Documents and settings\<user>\, Windows Vista/7: C:\Users\<user>).
- Snapshot support is not completely working for Android 4.0 system image for now. After loading a snapshot, some hardware features (sensors, gps, camera) will be broken.
- Loading earlier snapshots (created with tools version < 14) is broken. Symptoms include emulator failing to boot or crashing. We will improve version detections to more gracefully handle incompatible snapshot format, but for now, you’ll need to delete them and recreate them.
- Fixed in r15. Some linux users are reporting crashes when launching the emulator and have figured out that trying to access the webcam is the culprit. [Issue:
20952]
You can disable the webcam by editing the AVD ini file and adding hw.webcam.count=0 in it.
Build System
- 9-patch issue in Library. If the 9-patches located in library don't look like 9-patch (they appear as stretched bitmap) in your application, try to refresh the library project and do a clean build of the application. Changing your workspace to refresh automatically will help as well (in Preferences under General > Workspace). We will be improving this to not require forced refreshes.
DDMS/ADT LogCat View
ADT
- Projects don't show the Project Libraries container with the library jar files.
This can happen when starting Eclipse. Closing and opening the offending project should properly populate it again with the library jar files.
- Fixed in r15. The SDK Manager and the AVD Manager windows cannot be resized. On Linux, behavior is a bit odd -- the window can be shrunk but not expanded. [Issue: 20939]
Testing