1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
|
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>
|
