Androidアプリの開発中、Android Studioで「R.javaが見つからない」「Rが赤文字(シンボルが解決できない)になってビルドが通らない」という現象に遭遇することがあります。
この記事では、ビルドエラーで躓いた時にまず試すべき標準的な解決手順をまとめました。以前の手法よりも安全で確実な方法をご紹介します。
なぜR.javaのエラーが起きるのか?
R.javaは、リソースファイル(レイアウトXMLや画像など)をプログラムから参照するためのIDを管理する自動生成ファイルです。XMLファイルの記述ミスや、Android Studioのキャッシュの不整合が原因で、この自動生成が止まってしまうことがあります。
解決ステップ1:プロジェクトの「Clean」と「Rebuild」
まずは、Android Studioの標準機能を使って、中間生成ファイルを一度クリアして作り直すのが最も安全な正攻法です。
- 上部メニューの Build をクリックします。
- Clean Project を選択します。(一旦古い生成ファイルが削除されます)
- 完了後、再び Build > Rebuild Project を実行します。
多くの場合は、これで正しいR.javaが再生成され、エラーが解消されます。
解決ステップ2:不整合がある場合は「Invalidate Caches」
ステップ1で解決しない場合、Android Studioが持っている内部キャッシュが壊れている可能性があります。
- File > Invalidate Caches… を選択します。
- チェックボックスを確認し、Invalidate and Restart をクリックします。
- Android Studioが再起動し、インデックスの再作成が始まります。少し時間がかかりますが、これで解決することが多いです。
解決ステップ3:物理的にbuildディレクトリを削除(最終手段)
上記の手順でも解決しない場合、手動でビルドフォルダをリセットします。
- プロジェクト構造の
buildディレクトリを(Finderやエクスプローラー上で)削除します。 - Android Studioに戻り、Build > Make Project を実行します。
※物理削除を行う際は、作業中のファイルを保存し、念のためバックアップをとってから行ってください。
注意点:XMLにエラーがないか確認
もし上記を試しても解決しない場合は、そもそもレイアウトXMLやリソースファイル(strings.xmlなど)に構文エラーがある可能性が高いです。XMLが正しく解析できないとR.javaは生成されません。エラーログ(Build Output)を再度見直してみましょう。
