IDE Integration for Android* Part of the Intel® Integrated Native Developer Experience (Intel® INDE) 1.5.7 Overview IDE Integration for Android provides productivity-oriented design, coding, and debugging tools for applications targeting Android* on ARM* and Intel® architecture (x86) devices, including smartphones and tablets. The tools are compatible with Android Studio*, Microsoft* Visual Studio* and Eclipse* and support popular Android SDKs including the Android Native Development Kit (NDK). New Features Added in 1.5.7 Updated Intel® Hardware Accelerated Execution Manager (Intel® HAXM) to 1.1.1 o Add 64 bit Guest Support - Able to boot 64 bit Kernel and User space Features IDE Integration for Android provides the user the opportunity to select their favorite development environment components to install for native Android* development in an Eclipse*, Microsoft* Visual Studio or Android Studio* IDE. Below is a list of tools that IDE Integration for Android may install. Component Version Android Studio (Beta) 0.8.6 Android Studio plugins for Intel® INDE 1.1 Android ADT 23.0.2 Android SDK android-19 Eclipse 4.2 Android NDK r10 Intel® Hardware Accelerated Execution Manager (Intel® HAXM) 1.1.1 1.0.7 on Windows 8.1 vs-android* for Visual Studio 0.963 Apache Ant* 1.9.4 Eclipse plugins for Intel® INDE 1.2 Visual Studio 2012 & 2013 plugins for Intel® INDE 1.1 (Express Edition is not supported) System Requirements Hardware Host: System with Intel® Core processor and Intel® microarchitecture code name Sandy Bridge or later. Device: Intel® architecture (x86) or ARM Software: JDK 1.7 64-Bit for Android Studio and Eclipse JDK 1.7 32-bit for Visual Studio Microsoft* .NET 4.5 Microsoft* Windows* 7, Microsoft Windows 8 or Microsoft Windows 8.1 Microsoft* Visual Studio* Professional/Ultimate/Team 2012 or 2013 Microsoft* Visual Studio* Express Edition is not supported since it lacks plugin support Contents Depending on the installation options chosen, IDE Integration for Android will create the following directories: <install-folder> <install-folder>\ADT <install-folder>\Ant <install-folder>\Docs <install-folder>\NDK <install-folder>\NDK32 <install-folder>\SDK %LOCALAPPDATA%\Android\android-studio C:\Intel\INDE\IDEintegration by default Android Development Tools Ant build tool Release Notes Native Development Kit 64-bit host/32-bit target Native Development Kit 32-bit host/32-bit target Android Software Development Kit Android Studio General Notes If you receive an "exceeds memory limit" while launching an AVD it is because the AVD's RAM Memory Option exceeds the Intel HAXM Memory Reservation set during install. You can either increase the HAXM Memory Reservation or decrease the AVD's RAM Memory Option. To migrate from Beacon Mountain to this IDE Integration for Android, first uninstall Beacon Mountain. Uninstall can be found under the name “Intel® INDE IDE Integration for Android” During Modify, if you select to remove a required component (e.g. NDK) the Setup will ask for the PATH to an already installed component. At the end of the Setup you may see an error about uninstalling the component. IDE Integration for Android has been validated to interoperate with the Android NDK version r10. Use of other versions may experience issues creating and/or building projects depending upon their existing IDE environment setup. Choosing the “Android Studio” IDE selection requires previous versions of Android Studio be removed. Android Studio Environment Notes A native project activity template is included to help jump start native code projects. To create a new native project activity: 1. Create a New Project in Android Studio. Be sure not to use underscores '_' anywhere in the 'Application name' or 'Company Domain', as this will cause runtime errors. 2. Select “Blank Activity with NDK support" on the second screen of the wizard. 3. On the next screen enter the full NDK path. If you installed the one with INDE the default path is C:\Intel\INDE\IDEintegration\NDK. Things to note about the Native Android project: 1. The wizard will create a simple project using NDK that outputs a single string via a JNI call. 2. The wizard creates a new build.gradle file that defines a number of target configurations that are accessible via the “Product Variants” menu. Use the predefined configurations to build release, debug, x86 or ARM build types. The default configuration is debug x86. Eclipse Environment Notes The ABI Chooser is only visible when an Android project is selected in Package Explorer, Project Explorer, or Resource Navigator. If you change your Eclipse workspace from %USERPROFILE%\Documents\INDEWorkspace, you will need to initially set Window > Preferences > Android > NDK to your NDK path. If you modify your initial installation to point to a different ADT (through the ‘modify’ option of the installer), you will need to migrate your configuration files (plugins/dropins, workspace settings, etc.) to the new ADT. Creating a new project may also create an appcompat project. This is known to cause build issues. To work around them, either refresh the appcompat project to resolve the errors, or set the minimum API to 14 or greater to avoid creating the appcompat project. More information can be found at http://stackoverflow.com/questions/22256746/eclipse-adt-project-name-appcompat-v 7-being-created-after-creating-every-new. When creating a new x86 Native Android project: 1. Ensure the desired minimum API level is installed using the SDK Manager 2. It is recommended that you set the Run -> Run Configuration -> Target to automatically select the x86 emulator. 3. Select Run -> Run As “Android Application” once to run it. Visual Studio Environment Notes If Microsoft Visual Studio Professional/Ultimate/Team 2012 or 2013 is not found then the Visual Studio Development Environment will not be enabled as an install option. If the Visual Studio Plugins was were selected to be installed, then a new project can be started by following these steps once Visual Studio is open: 1. Select 'File'-->'New' --> 'Project' 2. Select (On the left side) 'Installed' --> 'Visual C++' --> 'Android' 3. Click on 'Android x86 Native Project' in the center panel. An ‘Android x86 Native Project’ can be configured to compile for the ARM platform by doing the following: 1. Right click on the project name in the Solution Explorer, and choose ‘Properties’. 2. Click the ‘General’ tab on the left hand side of the Property Pages window. 3. Choose the desired ARM toolset from the pull-down menu next to the ‘Platform Toolset’ property. 4. Choose the desired ARM architecture from the pull-down menu next to the ‘Target Architecture’ property. 5. Click ‘Ok’ Using the 32-bit JDK provides the most stable setup for vs-android. If you encounter this error while building Microsoft Visual Studio x86 Native Project: 1>AntBuild: 1> Envvar: JAVA_HOME is set to 'C:\Program Files\Java\jdk1.7.0_21' 1> Envvar: JAVA_OPTS is set to '' 1> D:\Android\apache-ant-1.9.0\bin\ant.bat debug 1> The system cannot execute the specified program. Install the x86 version of the Java JDK, and set your JAVA_HOME environment variable to the x86 version. The x86 version is installed into the "Program Files (x86)" directory (on a x64 PC). If you encounter this error: Error <#> error : Could not create the Java Virtual Machine. c:\<Ant path>\ANTBUILD <Project Name> Error <#> error : A fatal exception has occurred. Program will exit. c:\<Ant path>\ANTBUILD <Project Name> Set the '_JAVA_OPTIONS' environment variable to '-Xmx128M' Legal Information INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH INTEL PRODUCTS. NO LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT. EXCEPT AS PROVIDED IN INTEL'S TERMS AND CONDITIONS OF SALE FOR SUCH PRODUCTS, INTEL ASSUMES NO LIABILITY WHATSOEVER AND INTEL DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE OF INTEL PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT. UNLESS OTHERWISE AGREED IN WRITING BY INTEL, THE INTEL PRODUCTS ARE NOT DESIGNED NOR INTENDED FOR ANY APPLICATION IN WHICH THE FAILURE OF THE INTEL PRODUCT COULD CREATE A SITUATION WHERE PERSONAL INJURY OR DEATH MAY OCCUR. Intel may make changes to specifications and product descriptions at any time, without notice. Designers must not rely on the absence or characteristics of any features or instructions marked "reserved" or "undefined." Intel reserves these for future definition and shall have no responsibility whatsoever for conflicts or incompatibilities arising from future changes to them. The information here is subject to change without notice. Do not finalize a design with this information. The products described in this document may contain design defects or errors known as errata which may cause the product to deviate from published specifications. Current characterized errata are available on request. Contact your local Intel sales office or your distributor to obtain the latest specifications and before placing your product order. Copies of documents which have an order number and are referenced in this document, or other Intel literature, may be obtained by calling 1-800-548-4725, or by visiting Intel's Web Site. Intel, the Intel logo, Intel Core, are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.