[Flutter/Android]「Android resource linking failed」というメッセージでビルドエラーになる場合の対処法

2019.01.12
2024.10.31
Androidアプリ開発ミニ動画講座 Flutterアプリ開発ミニ動画講座(iOS/Android) Flutterトラブルシューティング集

このページには広告が含まれる場合があります。

ビルド時に「Android Resource Linking Failed」なんてエラーが出てきて、困ってしまった方も多いんじゃないでしょうか。

今回は、そんなエラーの原因と具体的な解決法について、手順を追って見ていきましょう。

Android resource linking failed 
Output: D:AndroidStudioProjects0minproSample_kotlin1BasicWhatsYourNameappbuildintermediatesincrementalmergeDebugResourcesmerged.dirvalues-v28values-v28.xml:7: error: resource android:attr/dialogCornerRadius not found. 
D:AndroidStudioProjects0minproSample_kotlin1BasicWhatsYourNameappbuildintermediatesincrementalmergeDebugResourcesmerged.dirvalues-v28values-v28.xml:11: error: resource android:attr/dialogCornerRadius not found. 
D:AndroidStudioProjects0minproSample_kotlin1BasicWhatsYourNameappbuildintermediatesincrementalmergeDebugResourcesmerged.dirvaluesvalues.xml:1256: error: resource android:attr/fontVariationSettings not found. 
D:AndroidStudioProjects0minproSample_kotlin1BasicWhatsYourNameappbuildintermediatesincrementalmergeDebugResourcesmerged.dirvaluesvalues.xml:1257: error: resource android:attr/ttcIndex not found. 
error: failed linking references.

そもそも「Android Resource Linking Failed」って何が原因？

このエラー、名前だけ聞くと何だか難しそうですが、実は設定の不備やSDKバージョンが原因で起きることが多いんです。

Android Studioでアプリをビルドするとき、設定されたSDKやライブラリが見つからないと「リンク失敗」状態になるため、こんなエラーメッセージが表示されます。

具体的には、ライブラリの置き場所やSDKバージョンがずれている可能性があります。

こうした設定を見直すことで、エラーは案外あっさりと解決できます。

解決法：3つのポイントに注目！

1. プロジェクトとアプリの「build.gradle」ファイルを確認

まずは build.gradle ファイルにアクセスします。これには「プロジェクトレベルの build.gradle」と「アプリケーションレベルの build.gradle」があるので、それぞれを確認する必要があります。

プロジェクトレベルの build.gradle は、プロジェクト全体の設定を記載しています。
アプリケーションレベルの build.gradle は、各アプリケーションの依存関係やバージョン設定を行っています。

この2つのファイルを見比べてみて、次のポイントをチェックします。

（注）Androidのネイティブアプリではなく、FlutterアプリのプロジェクトをAndroid Studioで開いている場合は、以下を参考に「android」ウィンドウを開いてください。

2024.09.18

Android Studio用Flutterプラグイン80.xでOpen android module in Android Studio / Open ios module in XCodeが廃止されたことによる対処法

Flutterを作るための道具の１つである「Android Studio」では、「Open android module in A...

2. リポジトリ設定の見直し

プロジェクトレベルの build.gradle ファイルを開いたら、 allprojects ブロックに「Googleのリポジトリ」が追加されているか確認しましょう。

これがないと、最新のライブラリをリンクできなくなってしまいます。

3. SDKバージョンを最新に合わせる

次に、アプリケーションレベルの build.gradle ファイルを確認して、 compileSdkVersion と targetSdkVersion のバージョンを見直します。

一般的に、このバージョンは最新（この記事執筆当初は「28」）かそれに近いものにしておくのが推奨されています。

もし古いバージョンで設定されていた場合、以下のように変更してみましょう。

（注）targetSdkVersion（対象APIレベル）は時間の経過につれて引き上げられていきます。詳細は以下ご参照ください。

Google Play アプリの対象 API レベルに関する要件 - Play Console ヘルプ

2025 年 8 月 31 日以降: 新しいアプリとアプリアップデートを Google Play に送信する場合は、Android 15（API レベル 35）以降を対象にする必要があります。ただし、Wear OS、Android Automotive OS、Android TV アプリは Android 14（API レベル 34）以降を対象にする必要があります。