summaryrefslogtreecommitdiff
path: root/docs/html/preview/setup-sdk.jd
blob: 3b479e25b675ccfb71ea2c793c807bf8d563e468 (plain)
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
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
page.title=Set Up the Preview
meta.keywords="preview", "android"
page.tags="preview", "developer preview"
page.image=images/cards/card-n-sdk_2x.png

@jd:body


<div id="qv-wrapper">
  <div id="qv">
<ol>
  <li><a href="#get-as13">Get Android Studio 2.1</a></li>
  <li><a href="#get-sdk">Get the Android N SDK</a>
    <ol>
      <li><a href="#docs-dl">Reference documentation</a>
    </ol>
  </li>
  <li><a href="#java8">Get the Java 8 JDK</a></li>
  <li><a href="#create-update">Update or Create a Project</a></li>
  <li><a href="#next">Next Steps</a></li>
</ol>
  </div>
</div>

<p>To develop apps for the Android N Preview, you need to make some updates
to your developer environment, as described on this page.</p>

<p>To simply test your app's compatibility on the
Android N system image, follow the guide to <a
href="{@docRoot}preview/download.html">Test on an Android N Device</a>.</p>

<img src="{@docRoot}preview/images/n-preview-setup.png" width="700" alt="" />


<h2 id="get-as13">Get Android Studio 2.1</h2>

<p>The Android N platform adds support for <a
href="{@docRoot}preview/j8-jack.html">Java 8 language features</a>,
which require a new compiler called Jack. The latest version of Jack
is currently supported only in Android Studio 2.1. So if you want to
use Java 8 language features, you need to use Android Studio 2.1 to
build your app. Otherwise, you don't need to use the Jack compiler, but you
still need to update to JDK 8 to compile against the Android N platform,
as described below.</p>

<p>If you already have Android Studio installed, make sure you have Android
Studio 2.1 or higher by clicking <strong>Help > Check for Update</strong>
(on Mac, <strong>Android Studio > Check for Updates</strong>).</p>

<p>If you don't have it, <a href="{@docRoot}studio/">download Android Studio
2.1 here</a>.</p>


<h2 id="get-sdk">Get the N Preview SDK</h2>

<p>To start developing with Android N APIs, you need to install the
Android N Preview SDK in Android Studio as follows:</p>

<ol>
  <li>Open the SDK Manager by clicking <strong>Tools > Android >
  SDK Manager</strong>.</li>

  <li>In the <strong>SDK Platforms</strong> tab, select the
  <strong>Android N Preview</strong> check box.</li>

  <li>Click the <strong>SDK Tools</strong> tab, then select the
    <strong>Android SDK Build Tools</strong>, <strong>Android SDK
    Platform-Tools</strong>, and <strong>Android SDK Tools</strong> check
    boxes.
  </li>

  <li>Click <strong>OK</strong>, then accept the licensing
    agreements for any packages that need to be installed.
  </li>
</ol>

<h3 id="docs-dl">Get the N Preview reference documentation</h3>

<p>
  Detailed information about the Android N APIs is available in the N Preview
  reference documentation, which you can download from the following table.
  This package contains an abridged, offline version of the Android developer
  web site, and includes an updated API reference for the Android N APIs and an
  API difference report.
</p>

<table>
  <tr>
    <th scope="col">Documentation</th>
    <th scope="col">Checksums</th>
  </tr>
  <tr>
    <td style="white-space: nowrap">
    <a href="{@docRoot}shareables/preview/n-preview-3-docs.zip"
      >n-preview-3-docs.zip</a></td>
    <td width="100%">
      MD5: 19bcfd057a1f9dd01ffbb3d8ff7b8d81<br>
      SHA-1: 9224bd4445cd7f653c4c294d362ccb195a2101e7 
    </td>
  </tr>
</table>



<h2 id="java8">Get the Java 8 JDK</h2>

<p>To compile your app against the Android N platform and use some tools with
Android Studio 2.1, you need to install the Java 8 Developer Kit (JDK 8). So, if
you don't already have the latest version, download JDK 8 now.</p>

<p>Then set the JDK version in Android Studio as follows:</p>

<ol>
  <li>Open an Android project in Android Studio, then open the
    Project Structure dialog by selecting <strong>File &gt;
        Project Structure</strong>. (Alternatively, you can set the default
        for all projects by selecting <strong>File &gt; Other Settings &gt;
        Default Project Structure</strong>.)
   </li>
   <li>In the left panel of the dialog, click <strong>SDK Location</strong>.
   </li>
   <li>In the <strong>JDK Location</strong> field, enter the location of the
    Java 8 JDK (click the button on the right
    to browse your files), then click <strong>OK</strong>.
   </li>
</ol>

<img src="{@docRoot}preview/images/studio-jdk-location.jpg" width="700"
  alt="" />


<h2 id="create-update">Update or Create a Project</h2>

<p>
  To use the Android N APIs, your project must be configured appropriately.
</p>

<p>If you plan to use Java 8 language features, you should also read
<a href="{@docRoot}preview/j8-jack.html">Java 8 Language Features</a>
for information about the supported Java 8 features and
how to configure your project with the Jack compiler.</p>


<h3 id="update">Update an existing project</h3>

<p>Open the
  <code>build.gradle</code> file for your module and update the values as
  follows:
</p>

<pre>
android {
  compileSdkVersion <strong>'android-N'</strong>
  buildToolsVersion <strong>'24.0.0-rc3'</strong>
  ...

  defaultConfig {
     minSdkVersion <strong>'N'</strong>
     targetSdkVersion <strong>'N'</strong>
     ...
  }
  ...
}</pre>


<h3 id="create">Create a new project</h3>


<p>To create a new project for development with the Android N Preview SDK:</p>

<ol>
  <li>Click <strong>File > New Project</strong>. and follow the steps until
  you reach the Target Android Devices page.
  </li>
  <li>On this page, select <strong>Phone and Tablet</strong> option.</li>
  <li>Under <strong>Phone and Tablet</strong> option, in the <strong>Minimum
    SDK</strong> option list, select
    <strong>N: Android API 23, N Preview (Preview)</strong>.</li>
</ol>


<h2 id="next">Next Steps</h2>

<ul>
  <li>Follow the guide to <a
href="{@docRoot}preview/download.html">Test on an Android N Device</a>.</li>
  <li>Learn more about the Android N platform with
<a href="{@docRoot}preview/behavior-changes.html">Behavior Changes</a>
and <a href="{@docRoot}preview/api-overview.html">Android N APIs
and Features</a>.</li>
</ul>