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} --> {@code .class}) --> <b>dx</b> ({@code 141 .class} --> {@code .dex}) 142 </li> 143 144 <li>新版 Jack 工具链:<br> 145 <b>Jack</b> ({@code .java} --> {@code .jack} --> {@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>