| page.title=Java 8 の言語機能 |
| page.keywords="android N", "Java 8", "Jack" |
| @jd:body |
| |
| <div id="qv-wrapper"> |
| <div id="qv"> |
| <ol> |
| <li> |
| <a href="#supported-features">サポートされる Java 8 の言語機能と API</a> |
| </li> |
| <li> |
| <a href="#configuration">Java 8 の機能と Jack ツールチェーンの有効化</a> |
| </li> |
| </ol> |
| </div> |
| </div> |
| |
| <p>Android N 向けのアプリを開発する際は、Java 8 の言語機能をご利用いただけます。このページでは Android N Preview でサポートしている Java 8 の新言語機能や、それらを利用するためのプロジェクトの正しい設定方法、想定される既知の問題についてご紹介します。 |
| |
| |
| |
| |
| </p> |
| |
| <p>これらの機能を使うには、Android Studio 2.1 と Android N Preview SDK をダウンロードしてセットアップし、Jack ツールチェーンと最新の Gradle 用の Android Plugin を準備する必要があります。 |
| |
| Android N Preview SDK をインストールしていない場合は、<a href="{@docRoot}preview/setup-sdk.html">Android N 向けの開発準備</a>をご覧ください。 |
| </p> |
| |
| |
| |
| <p class="note"> |
| <strong>注:</strong>Android N プラットフォーム向けのアプリを開発する際は、必ずしも Java 8 の新言語機能を使う必要はありません。 |
| Java 8 の言語機能を使用せずにコーディングしたい場合は、プロジェクトのソースを保持して、ターゲットの互換性の指定を Java 7 にしておくこともできます。ただし、Android N プラットフォームでビルドするときは、必ず JDK 8 を使用してコンパイルしてください。 |
| |
| |
| |
| </p> |
| |
| <h2 id="supported-features"> |
| サポートされる Java 8 の言語機能と API |
| </h2> |
| |
| <p> |
| Android ではまだ Java 8 の全言語機能はサポートしていません。現時点で Android N Preview 向けのアプリを開発する際にご利用いただける機能は、以下のとおりです。 |
| |
| |
| </p> |
| |
| <ul> |
| <li> |
| <a class="external-link" href="https://docs.oracle.com/javase/tutorial/java/IandI/defaultmethods.html">デフォルトおよび静的インターフェースのメソッド</a> |
| |
| </li> |
| |
| <li> |
| <a class="external-link" href="https://docs.oracle.com/javase/tutorial/java/javaOO/lambdaexpressions.html">ラムダ式</a>(API レベル 23 以前でも利用可能) |
| |
| </li> |
| |
| <li> |
| <a class="external-link" href="https://docs.oracle.com/javase/tutorial/java/annotations/repeating.html">反復アノテーション</a> |
| |
| </li> |
| |
| <li> |
| <a class="external-link" href="https://docs.oracle.com/javase/tutorial/java/javaOO/methodreferences.html">メソッド参照</a>(API レベル 23 以前でも利用可能) |
| |
| </li> |
| </ul> |
| |
| <p class="note"> |
| <strong>注:</strong>以前のバージョンの Android でラムダ式とメソッド参照をテストするには、{@code build.gradle} ファイルに移動し、{@code compileSdkVersion} と {@code targetSdkVersion} を 23 以前に設定します。 |
| |
| |
| これらの Java 8 機能を使用するには、<a href="#configuration">Jack ツールチェーンを有効にする</a>必要があります。 |
| |
| </p> |
| |
| <p> |
| さらに以下の Java 8 言語機能の API もご利用いただけます。 |
| </p> |
| |
| <ul> |
| <li>リフレクションおよび言語関連の API |
| <ul> |
| <li> |
| <a class="external-link" href="https://docs.oracle.com/javase/8/docs/api/java/lang/FunctionalInterface.html"> |
| {@code java.lang.FunctionalInterface}</a> |
| </li> |
| |
| <li> |
| <a class="external-link" href="https://docs.oracle.com/javase/8/docs/api/java/lang/annotation/Repeatable.html"> |
| {@code java.lang.annotation.Repeatable}</a> |
| </li> |
| |
| <li> |
| <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> |
| </li> |
| |
| <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> |
| </li> |
| </ul> |
| </li> |
| |
| <li>ユーティリティ API |
| <ul> |
| <li> |
| <a class="external-link" href="https://docs.oracle.com/javase/8/docs/api/java/util/function/package-summary.html"> |
| {@code java.util.function}</a> |
| </li> |
| |
| <li> |
| <a class="external-link" href="https://docs.oracle.com/javase/8/docs/api/java/util/stream/package-summary.html"> |
| {@code java.util.stream}</a> |
| </li> |
| </ul> |
| </li> |
| </ul> |
| |
| <h2 id="configuration"> |
| Java 8 の機能と Jack ツールチェーンの有効化 |
| </h2> |
| |
| <p> |
| Java 8 の新言語機能を使うには、新しい <a class="external-link" href="https://source.android.com/source/jack.html">Jack ツールチェーン</a>も必要です。 |
| この新しい Android ツールチェーンは、Java 言語のソースを Android で判別可能な dex バイトコードにコンパイルします。さらにこのツールには独自の {@code .jack} ライブラリ フォーマットがあり、再パッケージ化、縮小、難読化、Multidex など、ほとんどのツールチェーン機能に対応しています。 |
| |
| |
| |
| |
| </p> |
| |
| <p>以下は、Android の DEX ファイルのビルドに使用する 2 つのツールチェーンの比較です。</p> |
| <ul> |
| <li>以前の javac ツールチェーン<br> |
| <b>javac</b> ({@code .java} --> {@code .class}) --> <b>dx</b> ({@code |
| .class} --> {@code .dex}) |
| </li> |
| |
| <li>新しい Jack ツールチェーン<br> |
| <b>Jack</b> ({@code .java} --> {@code .jack} --> {@code .dex}) |
| </li> |
| </ul> |
| |
| <h3> |
| Gradle の設定 |
| </h3> |
| |
| <p> |
| プロジェクトで Java 8 の言語機能と Jack を有効にするには、モジュール レベルの {@code build.gradle} ファイルに以下の内容を記載します。 |
| |
| </p> |
| |
| <pre> |
| android { |
| ... |
| defaultConfig { |
| ... |
| jackOptions { |
| enabled true |
| } |
| } |
| compileOptions { |
| sourceCompatibility JavaVersion.VERSION_1_8 |
| targetCompatibility JavaVersion.VERSION_1_8 |
| } |
| } |
| </pre> |
| |
| <h3 id="known-issues"> |
| 既知の問題 |
| </h3> |
| |
| <p> |
| <a href="{@docRoot}tools/building/building-studio.html#instant-run">Instant Run</a> は、現段階では Jack と併用できません。そのため新しいツールチェーンの使用中は無効になります。 |
| |
| |
| </p> |
| |
| <p>Jack はアプリのコンパイル中に中間クラスファイルを生成しないため、中間ファイルに依存するツールは現在 Jack と併用できません。 |
| このようなツールの例は以下のとおりです。 |
| </p> |
| |
| <ul> |
| <li>クラスファイルに作用する Lint Detector |
| </li> |
| |
| <li>アプリのクラスファイルを必要とするツールやライブラリ(JaCoCo での計測テストなど) |
| |
| </li> |
| </ul> |
| |
| <p>Jack の使用についてその他の不具合がありましたら、<a href="http://tools.android.com/filing-bugs">バグの報告</a>をお願いします。</p> |