• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1page.title=Java 8 语言功能
2page.keywords="android N", "Java 8", "Jack"
3@jd:body
4
5<div id="qv-wrapper">
6  <div id="qv">
7    <ol>
8      <li>
9        <a href="#supported-features">支持的 Java 8 语言功能和 API</a>
10      </li>
11      <li>
12        <a href="#configuration">启用 Java 8 功能和 Jack 工具链</a>
13      </li>
14    </ol>
15  </div>
16</div>
17
18<p>Android N 支持 Java 8 语言功能,您可以在开发面向 Android N 的应用时使用这些功能。本页面介绍了 Android N Preview 中支持的新语言功能、如何正确设置项目以使用这些功能,以及您可能遇到的任何已知问题。
19
20
21
22
23</p>
24
25<p>要开始使用这些功能,您需要下载并设置 Android Studio 2.1 和 Android N Preview SDK,包括所需的 Jack 工具链和更新的 Android Plugin for Gradle。
26
27如果您尚未安装 Android N Preview SDK,请参阅 <a href="{@docRoot}preview/setup-sdk.html">Develop for Android N 设置</a>。
28</p>
29
30
31
32<p class="note">
33  <strong>注:</strong>开发面向 Android N 平台的应用并不要求必须使用新的 Java 8 语言功能。
34如果您不想使用 Java 8 语言功能编写代码,您可以将项目的源和目标兼容性值保留为 Java 7,但您仍必须使用 JDK 8 进行编译,以便针对 Android N 平台进行构建。
35
36
37
38</p>
39
40<h2 id="supported-features">
41  支持的 Java 8 语言功能和 API
42</h2>
43
44<p>
45  Android 目前仅支持部分 Java 8 语言功能。在开发面向 Android N Preview 的应用时,现已可使用以下功能:
46
47
48</p>
49
50<ul>
51  <li>
52    <a class="external-link" href="https://docs.oracle.com/javase/tutorial/java/IandI/defaultmethods.html">默认和静态接口方法</a>
53
54  </li>
55
56  <li>
57    <a class="external-link" href="https://docs.oracle.com/javase/tutorial/java/javaOO/lambdaexpressions.html">Lambda 表达式</a>(也在 API 级别 23 及更低版本中使用)
58
59  </li>
60
61  <li>
62    <a class="external-link" href="https://docs.oracle.com/javase/tutorial/java/annotations/repeating.html">重复注解</a>
63
64  </li>
65
66  <li>
67    <a class="external-link" href="https://docs.oracle.com/javase/tutorial/java/javaOO/methodreferences.html">方法引用</a>(也在 API 级别 23 及更低版本中使用)
68
69  </li>
70</ul>
71
72<p class="note">
73  <strong>注:</strong>在 Android 的较早版本中测试 Lambda 表达式和方法引用,前往您的 {@code build.gradle} 文件,将 {@code compileSdkVersion} 和 {@code targetSdkVersion} 设置为 23 或更低版本。
74
75
76您仍需要<a href="#configuration">启用 Jack 工具链</a>以使用这些 Java 8 功能。
77
78</p>
79
80<p>
81  此外,现已可使用以下 Java 8 语言功能 API:
82</p>
83
84<ul>
85  <li>反映和语言相关 API:
86    <ul>
87      <li>
88        <a class="external-link" href="https://docs.oracle.com/javase/8/docs/api/java/lang/FunctionalInterface.html">{@code java.lang.FunctionalInterface}</a>
89
90      </li>
91
92      <li>
93        <a class="external-link" href="https://docs.oracle.com/javase/8/docs/api/java/lang/annotation/Repeatable.html">{@code java.lang.annotation.Repeatable}</a>
94
95      </li>
96
97      <li>
98        <a class="external-link" href="https://docs.oracle.com/javase/8/docs/api/java/lang/reflect/Method.html#isDefault--">{@code java.lang.reflect.Method.isDefault()}</a>
99
100      </li>
101
102      <li>和与重复注解关联的反映 API,例如<a class="external-link" href="https://docs.oracle.com/javase/8/docs/api/java/lang/reflect/AnnotatedElement.html#getAnnotationsByType-java.lang.Class-">{@code AnnotatedElement.getAnnotationsByType(Class)}</a>
103
104
105      </li>
106    </ul>
107  </li>
108
109  <li>实用程序 API:
110    <ul>
111      <li>
112        <a class="external-link" href="https://docs.oracle.com/javase/8/docs/api/java/util/function/package-summary.html">{@code java.util.function}</a>
113
114      </li>
115
116      <li>
117        <a class="external-link" href="https://docs.oracle.com/javase/8/docs/api/java/util/stream/package-summary.html">{@code java.util.stream}</a>
118
119      </li>
120    </ul>
121  </li>
122</ul>
123
124<h2 id="configuration">
125  启用 Java 8 功能和 Jack 工具链
126</h2>
127
128<p>
129  要使用新的 Java 8 语言功能,还需使用新的 <a class="external-link" href="https://source.android.com/source/jack.html">Jack 工具链</a>。新的 Android 工具链将 Java 源语言编译成 Android 可读取的 Dalvik 可执行文件字节码,且有其自己的 {@code .jack} 库格式,在一个工具中提供了大多数工具链功能:重新打包、压缩、模糊化以及 Dalvik 可执行文件分包。
130
131
132
133
134
135</p>
136
137<p>以下是构建 Android Dalvik 可执行文件可用的两种工具链的对比:</p>
138<ul>
139  <li>旧版 javac 工具链:<br>
140  <b>javac</b> ({@code .java} --&gt; {@code .class}) --&gt; <b>dx</b> ({@code
141  .class} --&gt; {@code .dex})
142  </li>
143
144  <li>新版 Jack 工具链:<br>
145  <b>Jack</b> ({@code .java} --&gt; {@code .jack} --&gt; {@code .dex})
146  </li>
147</ul>
148
149<h3>
150  配置 Gradle
151</h3>
152
153<p>
154  如需为您的项目启用 Java 8 语言功能和 Jack,请在模块层级的 {@code build.gradle} 文件中输入以下内容:
155
156</p>
157
158<pre>
159android {
160  ...
161  defaultConfig {
162    ...
163    jackOptions {
164      enabled true
165    }
166  }
167  compileOptions {
168    sourceCompatibility JavaVersion.VERSION_1_8
169    targetCompatibility JavaVersion.VERSION_1_8
170  }
171}
172</pre>
173
174<h3 id="known-issues">
175  已知问题
176</h3>
177
178<p>
179  <a href="{@docRoot}tools/building/building-studio.html#instant-run">Instant Run</a> 目前不能用于 Jack,在使用新的工具链时将被禁用。
180
181
182</p>
183
184<p>由于 Jack 在编译应用时不生成中间类文件,依赖这些文件的工具目前不能用于 Jack。例如以下工具:
185
186</p>
187
188<ul>
189  <li>对类文件进行操作的 Lint 检测工具
190  </li>
191
192  <li>需要应用类文件的工具和库(例如使用 JaCoCo 进行仪器测试中)
193
194  </li>
195</ul>
196
197<p>如果您在使用 Jack 的过程中发现其他问题,<a href="http://tools.android.com/filing-bugs">请提交错误</a>。</p>