150 lines
6.0 KiB
Plaintext
150 lines
6.0 KiB
Plaintext
page.title=Importing Legacy Apps into Android Studio
|
|
meta.tags="android, performance, profiling, tools"
|
|
page.tags="android", "performance", "profiling", "tools"
|
|
page.metaDescription=Required changes when importing legacy apps into Android Studio.
|
|
page.article=true
|
|
|
|
@jd:body
|
|
|
|
<div id="tb" style="margin-left: 7px; margin-bottom: 5px;">
|
|
|
|
<h2>In this document</h2>
|
|
<ul>
|
|
<li><a href="#WhatYouNeed">Prerequisites</a></li>
|
|
<li><a href="#StepsForImporting">Steps for Importing</a></li>
|
|
</ul>
|
|
|
|
<h2>You should also read</h2>
|
|
<ul>
|
|
<li><a href="/tools/device.html">Using Hardware Devices</a></li>
|
|
<li><a href="/tools/help/index.html">Tools</a></li>
|
|
</ul>
|
|
|
|
</div>
|
|
|
|
|
|
<p>Importing some pre-Android-1.0 projects into Android 1.0 or newer can trigger a series of
|
|
errors. This document shows you how to resolve them, using a version of the Sunshine app used in
|
|
the <a href="https://www.udacity.com/course/ud853">Android Fundamentals Udacity Course</a> as an
|
|
example.</p>
|
|
|
|
<p><b>CAVEAT:</b> As with all documentation of this kind, the details are likely to vary for each
|
|
application and each update of Android Studio.</p>
|
|
|
|
<h2 id="WhatYouNeed">Prerequisites</h2>
|
|
|
|
<ul>
|
|
<li>The latest version of <a href="http://developer.android.com/sdk/index.html">Android
|
|
Studio</a> (this document uses version 1.1).</li>
|
|
|
|
<li>It helps to know how to <a href="https://developer.android.com/training/index.html">build
|
|
and run apps from Android Studio</a> on your device.</li>
|
|
|
|
<li>To use Sunshine, you need to download code from <a href=
|
|
"https://github.com/">github.com</a>. More info at <a href=
|
|
"https://help.github.com/">help.github.com</a>.</li>
|
|
</ul>
|
|
|
|
<h2 id="StepsForImporting">Steps for Importing Sunshine into Android Studio 1.1.0</h2>
|
|
|
|
<ol>
|
|
<li>Download Sunshine ZIP from GitHub: <a href=
|
|
"https://github.com/udacity/sunshine/tree/6.10-update-map-intent">https://github.com/udacity/sunshine/tree/6.10-update-map-intent</a>.
|
|
(If you are having any problems with Android Studio or the app, use the following version, or
|
|
your own app, to follow along with the example.<a href=
|
|
"https://github.com/udacity/sunshine/tree/3.13-add-share-action-provider">https://github.com/udacity/sunshine/tree/3.13-add-share-action-provider</a>)
|
|
|
|
<li>Unzip the application to extract the code folder.</li>
|
|
|
|
<li>Start Android Studio. (This works best if you close all projects, then restart.)</li>
|
|
|
|
<li>Click <b>Import</b> <b>project (Eclipse ADT, Gradle, etc.)</b>.
|
|
<br><img src="{@docRoot}images/tools/performance/import_image001.png">
|
|
</li>
|
|
|
|
<li>In the popup, find and select the Sunshine-6-10-updated-map-intent folder and click
|
|
<b>OK</b>.
|
|
<br><img src="{@docRoot}images/tools/performance/import_image002.png">
|
|
</li>
|
|
|
|
<li>If prompted, choose a destination folder for your project. If prompted to choose a build
|
|
system, choose Gradle. (These prompts vary, depending on your project and Android Studio
|
|
version.) If you need more guidance, see this <a href=
|
|
"http://www.lynda.com/articles/eclipse-into-android-studio">Lynda tutorial</a>.</li>
|
|
|
|
<li>Wait for the import to complete. If you see no errors, you are now ready to work with your
|
|
app.
|
|
|
|
<p><b>If you get a Gradle error:</b></p>
|
|
|
|
<li>If you get a Gradle error, you have some extra work to do.(Because the Import
|
|
didn(t finish, at this point, you may only see the <b>Gradle
|
|
Scripts</b> directory in your Project view.)</li>
|
|
|
|
<li>You may see the link <b>Install missing platform(s) and sync
|
|
project</b>, or a link to install missing build tools.
|
|
Click whatever link and
|
|
proceed.</li>
|
|
|
|
<li>The next time through, your build will fail with:
|
|
<br><img src="{@docRoot}images/tools/performance/import_image003.png">
|
|
</li>
|
|
|
|
<li>Click the <b>Fix plugin version and re-import project</b> link
|
|
in the error message. This will rebuild the app and present you with new of errors.
|
|
<br><img src="{@docRoot}images/tools/performance/import_image004.png">
|
|
</li>
|
|
|
|
<li>Click the <b>Gradle Settings</b> link in the error message.</li>
|
|
|
|
<li>Check the <b>Use auto-import</b> and click <b>OK</b>.
|
|
<br><img src="{@docRoot}images/tools/performance/import_image005.png">
|
|
</li>
|
|
|
|
<li>Expand the project hierarchy and find the <b>build.gradle file</b>.The file you are looking
|
|
for is not the one showing at the top level, but the one inside <b>Sunshine</b> <b>></b>
|
|
<b>app > build.gradle</b>, as shown below.
|
|
<br><img src="{@docRoot}images/tools/performance/import_image006.png">
|
|
</li>
|
|
|
|
<li>Double-click the <code>build.gradle</code> file.</li>
|
|
|
|
<li>Make the following changes to the file:</li>
|
|
<ul>
|
|
<li>Set <code>compileSdkVersion 21</code></li>
|
|
|
|
<li>Set <code>targetSdkVersion 21</code></li>
|
|
|
|
<li>Replace <code>runProguard</code> with <code>minifyEnabled</code></li>
|
|
</ul>
|
|
|
|
<p>Your file should look like this: </p>
|
|
<img src="{@docRoot}images/tools/performance/import_image007.png">
|
|
</li>
|
|
|
|
<li>Save (Ctrl-S).</li>
|
|
|
|
<p>For the following two messages (Steps 18/19), what you see might vary. You might see either
|
|
message or both messages in sequence. Click the appropriate links to continue until the Language
|
|
Level Changed dialog opens.</p>
|
|
|
|
<li>In the code view bar, click the <b>Try again</b> link.
|
|
<br><img src="{@docRoot}images/tools/performance/import_image008.png">
|
|
</li>
|
|
|
|
<li>If you see these warnings, click the <b>Sync now</b> link.
|
|
<br><img src="{@docRoot}images/tools/performance/import_image009.png">
|
|
</li>
|
|
|
|
<li>In the Language Level Changed dialog, click <b>Yes</b>. And if you get the Gradle Running
|
|
dialog, <b>Yes</b> again.
|
|
<br><img src="{@docRoot}images/tools/performance/import_image010.png">
|
|
</li>
|
|
|
|
<li>After the project reloads, run the app on your device. (If it crashes the first time, try
|
|
again, and it will run.)
|
|
<br><img src="{@docRoot}images/tools/performance/import_image011.png">
|
|
</li>
|
|
</ol>
|
|
|