Task 'wrapper' not found in project ':app' の解決方法

Android Studio や Gradle を使用している際に「Task 'wrapper' not found in project ':app'」というエラーが発生することがあります。このエラーはプロジェクトの構造や設定の問題によって発生します。

問題の概要

このエラーは通常、以下のような状況で発生します：

app: failed At 9/30/2021 2:47 PM with 1 error
   Task 'wrapper' not found in project ':app'.

Task 'wrapper' not found in project ':app'

* Try:
Run gradle tasks to get a list of available tasks.
Run with --stacktrace option to get the stack

注意

このエラーは Gradle ラッパータスクが見つからないことを示していますが、実際にはプロジェクトの開き方や設定の問題であることが多いです。

主な解決方法

1. 正しいプロジェクトディレクトリを開く

最も一般的な原因は、間違ったディレクトリでプロジェクトを開いていることです。

プロジェクト構造が以下のようになっている場合：

yourProjectDir/
├── app/
│   └── build.gradle
├── otherModule1/
├── otherModule2/
└── build.gradle  # ルートのbuild.gradle

正しい方法：ルートディレクトリの build.gradle がある階層でプロジェクトを開く

間違った方法：app ディレクトリ内の build.gradle でプロジェクトを開く

TIP

プロジェクトを開く際は、gradlew と gradlew.bat ファイルが存在するルートディレクトリを選択してください。

2. 不要な Gradle プロジェクトのリンクを解除

Android Studio が複数のプロジェクトルートを認識している場合、このエラーが発生することがあります。

解決手順：

1. Android Studio の右側の Gradle パネルを開く
2. 不要なプロジェクト（通常は :app）を右クリック
3. 「Unlink Gradle Project」を選択

3. .idea ディレクトリのクリーンアップ

場合によっては、IDE の設定ファイルに問題がある可能性があります。

# プロジェクトのルートディレクトリで実行
rm -rf .idea

その後、Android Studio でプロジェクトを再度開きなおしてください。

注意

.idea ディレクトリを削除すると、プロジェクト固有のIDE設定がリセットされます。必要に応じてバックアップを取ってから実行してください。

4. 手動での設定ファイル修正

unlink オプションが表示されない場合、手動で設定ファイルを編集します。

手順：

1. ルートディレクトリの .idea/gradle.xml ファイルを開く
2. 不要なプロジェクトのエントリを削除する

高度な解決策：Wrapper タスクの明示的定義

稀に、実際に Wrapper タスクが定義されていない場合があります。その場合は、ルートの build.gradle ファイルに明示的にタスクを追加します。

Groovy DSL

// build.gradle (ルートディレクトリ)
task wrapper(type: Wrapper) {
    gradleVersion = '7.2'
}

Kotlin DSL

// build.gradle.kts (ルートディレクトリ)
tasks.register<Wrapper>("wrapper") {
    gradleVersion = "7.2"
}

その後、ターミナルで以下のコマンドを実行します：

./gradlew wrapper

INFO

Gradle バージョンはプロジェクトに適したものを指定してください。現在推奨されているバージョンは Gradle公式サイト で確認できます。

予防策

1. プロジェクト構造の理解：マルチモジュールプロジェクトの構造を正しく理解する
2. IDEのクリーンな状態：定期的に .idea ディレクトリやキャッシュをクリーンアップする
3. Gradleバージョンの管理：プロジェクト全体で一貫したGradleバージョンを使用する

まとめ

「Task 'wrapper' not found in project ':app'」エラーは、主に以下のいずれかが原因です：

• 誤ったディレクトリでプロジェクトを開いている
• IDEが複数のプロジェクトルートを認識している
• 設定ファイルの問題

最初に試すべきは、正しいルートディレクトリでプロジェクトを開き直すことです。それでも解決しない場合、Gradleプロジェクトのリンク解除や設定ファイルの修正を試してください。