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 Preview でサポートしている Java 8 の新言語機能や、それらを利用するためのプロジェクトの正しい設定方法、想定される既知の問題についてご紹介します。 19 20 21 22 23</p> 24 25<p>これらの機能を使うには、Android Studio 2.1 と Android N Preview SDK をダウンロードしてセットアップし、Jack ツールチェーンと最新の Gradle 用の Android Plugin を準備する必要があります。 26 27Android N Preview SDK をインストールしていない場合は、<a href="{@docRoot}preview/setup-sdk.html">Android N 向けの開発準備</a>をご覧ください。 28</p> 29 30 31 32<p class="note"> 33 <strong>注:</strong>Android N プラットフォーム向けのアプリを開発する際は、必ずしも Java 8 の新言語機能を使う必要はありません。 34Java 8 の言語機能を使用せずにコーディングしたい場合は、プロジェクトのソースを保持して、ターゲットの互換性の指定を Java 7 にしておくこともできます。ただし、Android N プラットフォームでビルドするときは、必ず JDK 8 を使用してコンパイルしてください。 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">ラムダ式</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 でラムダ式とメソッド参照をテストするには、{@code build.gradle} ファイルに移動し、{@code compileSdkVersion} と {@code targetSdkVersion} を 23 以前に設定します。 74 75 76これらの Java 8 機能を使用するには、<a href="#configuration">Jack ツールチェーンを有効にする</a>必要があります。 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"> 89 {@code java.lang.FunctionalInterface}</a> 90 </li> 91 92 <li> 93 <a class="external-link" href="https://docs.oracle.com/javase/8/docs/api/java/lang/annotation/Repeatable.html"> 94 {@code java.lang.annotation.Repeatable}</a> 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--"> 99 {@code java.lang.reflect.Method.isDefault()}</a> 100 </li> 101 102 <li>以下のような反復アノテーション関連のリフレクション API 103 <a class="external-link" href="https://docs.oracle.com/javase/8/docs/api/java/lang/reflect/AnnotatedElement.html#getAnnotationsByType-java.lang.Class-"> 104 {@code AnnotatedElement.getAnnotationsByType(Class)}</a> 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"> 113 {@code java.util.function}</a> 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"> 118 {@code java.util.stream}</a> 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>も必要です。 130この新しい Android ツールチェーンは、Java 言語のソースを Android で判別可能な dex バイトコードにコンパイルします。さらにこのツールには独自の {@code .jack} ライブラリ フォーマットがあり、再パッケージ化、縮小、難読化、Multidex など、ほとんどのツールチェーン機能に対応しています。 131 132 133 134 135</p> 136 137<p>以下は、Android の DEX ファイルのビルドに使用する 2 つのツールチェーンの比較です。</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 Detector 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>