Android Dev Summit, October 23-24: two days of technical content, directly from the Android team. Sign-up for livestream updates.

Android Studio のトラブルシューティング

このページでは、Android Studio の一般的な問題と設定に関する問題を解決するためのガイダンスを紹介しています。

高密度ディスプレイ

バージョン 1.5 以降の Android Studio は、すべてのプラットフォームで高密度ディスプレイ(HiDPI モニターや Retina モニター)をサポートしています。

倍率の設定

Android Studio は、ディスプレイ用の倍率を次のように決定します。

Mac
Retina ディスプレイでは、UI 要素は倍率 200% で拡大され、画像は高解像度でレンダリングされます。マルチモニター設定でも、倍率が原因で画像がぼやけることはありません。サポートされる倍率は、100%(Retina 以外のディスプレイ)と 200%(Retina ディスプレイ)のみです。
Windows
Android Studio は、メイン ディスプレイの DPI 設定を使用して、UI 要素の倍率を決定します。画像については、倍率が 150% より小さい場合、通常解像度の画像が拡大されます。倍率が 150% より大きい場合、高解像度の画像が適切に拡大されます。
Linux
Android Studio は、テキストの倍率と XWindow システムの DPI 設定を順に確認して、倍率を決定します。
DPI 設定 96 は倍率 100%(拡大 / 縮小なし)に対応し、DPI 設定 192 は倍率 200%(UI 要素のサイズが 2 倍)に対応します。現時点では、Android Studio は 96(倍率 100%)から 288(倍率 300%)までの DPI 設定に対応しています。 Linux マシンまたは Windows マシンで Android Studio が正しいシステム DPI を検出しない場合は、ide.properties ファイルの hidpi プロパティを編集することにより、手動で設定できます(IDE プロパティのカスタマイズをご覧ください)。このプロパティは Mac マシンには影響しない点に注意してください。このプロパティは次のように機能します。
hidpi=true
DPI を 192(倍率 200%)に設定します。システム設定は無視されます。
hidpi=false
DPI を 96(倍率 100%)に設定します。システム設定は無視されます。

高密度ディスプレイで UI 要素がぼやけるかモザイク状になる

高密度ディスプレイで Android Studio UI の 1 つ以上の要素がぼやけるかモザイク状になる場合、次の問題のいずれかが発生している可能性があります。

  • ほとんどの Android Studio UI は正常に表示されているが、特定の 1 つのアイコンがぼやけるかモザイク状になる場合、または特定の 1 つの UI 要素が間違ったサイズのフォントで表示される場合、その要素はアップデートが不十分で HiDPI をサポートしていない可能性があります。[Help] > [Submit Feedback] をクリックして、バグを報告してください。スクリーンショットに加えて、システム設定に関する情報をできるだけ多くお送りください。
  • Windows マシンまたは Linux マシンを使用していて、ディスプレイを 100% または 200% 以外の倍率に設定している場合、倍率が原因で画像が若干ぼやけることがあります。
  • Windows マシンを使用していて、コントロール パネルで Windows のフォントサイズを変更した場合、画像がぼやけるかモザイク状になることがあります。この問題は、Windows からログアウトしてログインし直すと解決します。
  • Windows 8.1 以上を実行しているマルチモニター設定で、ウィンドウをあるディスプレイから解像度または DPI が異なる別のディスプレイに移動すると、フォントや画像に関する問題が発生することがあります(バグ 186007 をご覧ください)。現時点では、この問題に既知の回避策はありません。
  • JRE 1.8 の古いバージョンには、フォントがぼやける問題がありました(特に JRE 1.8.0_25-b18 amd64: バグ 192316 をご覧ください)。バージョン 2.2 以降の Android Studio には、JDE を含む最新のサポート対象 JDK のバンドル バージョンが組み込まれています。この問題を解決するには、Android Studio をバージョン 2.2 以上にアップデートして、[File] > [Project Structure] > [SDK Location] をクリックし、[Use embedded JDK] チェックボックスをオンにして、バンドルされた JDK を使用するように切り替えます。

高密度ディスプレイで UI 要素が間違ったサイズで表示される

高密度ディスプレイで Android Studio UI が全体的に間違ったサイズになっている場合は、倍率の設定をご覧ください。高密度ディスプレイで Android Studio UI の一部の要素が間違ったサイズで表示されるが、他の要素は適切なサイズで表示される場合、次の問題のいずれかが発生している可能性があります。

  • カスタム エディタ スキームを使用している場合、エディタのフォントの表示が高密度ディスプレイの他の UI 要素と比較して小さすぎるか大きすぎることがあります。この問題を解決するには、[File] > [Settings] をクリックし、次に [Editor] > [Colors and Fonts] > [Font] をクリックして、エディタのフォントサイズを変更します。デフォルトのスキームがアクティブになっていると、エディタのフォントサイズが自動的に変更されることに注意してください(バグ 186920 をご覧ください)。
  • Android Studio UI の一部の要素は適切なサイズで表示されるが、その他の要素が小さすぎるか大きすぎる場合は、問題 186923 が発生している可能性があります。[Help] > [Submit Feedback] をクリックして、バグを報告してください。スクリーンショットに加えて、システム設定に関する情報をできるだけ多くお送りください。

プロジェクトの同期に関する問題

プロジェクトを同期しようとすると、次のようなエラー メッセージが表示されることがあります: インターネットへの接続が拒否されました(アクセス拒否: 接続)。このエラー解決するには、次のようにして、Android Studio の gradle.properties ファイルにシステム プロパティ -Djava.net.preferIPv4Stack=true を追加します。

  1. Android Studio で gradle.properties ファイルを開きます。
  2. 次の行をファイルに追加します。
        org.gradle.jvmargs=-Djava.net.preferIPv4Stack=true
        
    gradle.properties ファイルに他の Gradle JVM 引数がすでに追加されている場合は、次の例のように、このプロパティを同じ行に追加できます。
        org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -Djava.net.preferIPv4Stack=true
        
  3. 変更を反映するために Android Studio を再起動します。
  4. [Sync Project with Gradle Files] をクリックして、プロジェクトを同期します。

Windows で IDE をアップデートする際の問題

Windows では、プロセスで使用されているファイルを削除できません。IDE で組み込みのアップデート メカニズムを使用しようとすると、アップデートのインストールが拒否されて「Can't delete C:\some\path\file」のようなエラー メッセージが表示されることがあります。

この問題を回避するには、タスク マネージャーを開いて、このファイルを使用している可能性があるプロセス(Gradle デーモンなど)を強制終了します。

minSdkVersion に関する問題

Android サポート ライブラリの廃止されたバージョンを使用している場合、次のようなエラー メッセージが表示されることがあります。

:app:processDebugManifest app/src/main/AndroidManifest.xml:0:0 Error:
    uses-sdk:minSdkVersion 19 cannot be smaller than version L declared in library app/build/intermediates/exploded-aar/com.android.support/appcompat-v7/21.0.0-rc1/AndroidManifest.xml
    Suggestion: use tools:overrideLibrary="android.support.v7.appcompat" to force usage

この問題を解決するには、SDK Manager を使用して、最新バージョン(プレビュー バージョン以外)の Android サポート ライブラリにアップデートします。サポート ライブラリのセットアップの詳細については、サポート ライブラリのセットアップをご覧ください。

Android エミュレータに関する問題

Android エミュレータのトラブルシューティングをご覧ください。