【保存版】Flutter「NDK version」エラー完全解決ガイド｜NDK not configured・ndkVersion設定も解説

はじめに：Flutterで「NDK version」エラーが発生する原因とは？

#

No version of NDK matched the requested version
NDK not configured.

このような「NDK version」関連のエラーは、主に Android のネイティブ開発キット（Android NDK）のバージョン不一致や設定漏れが原因です。Flutter プロジェクトでは Dart コードが中心ですが、Android 側で C/C++ を利用するプラグインやネイティブコードがあると、NDK が関わってきます。

本記事では、

• エラーの原因
• 確認方法
• 正しい設定手順
• よくある失敗とその対策
• FAQ（よくある質問）
  といった流れで、初心者〜中級者の方にもわかりやすく「完全解決ガイド」としてまとめました。

FlutterでNDKとは？NDK versionエラーの原因を理解しよう

#

Android NDK の概要と役割

#

Android NDK（Native Development Kit）は、Android アプリ内で C／C++ ネイティブコードを使用できる開発キットです。Flutter 自体は Dart で動作しますが、

• 一部の Flutter プラグインがネイティブライブラリを使っていたり、
• Android 側の SDK 内でネイティブコード参照があったり、
  といったケースで NDK が関係します。

正しく設定されていないと、ビルド時に Android 側で “NDK not configured” や “No version of NDK matched the requested version” といったエラーが出やすくなります。

Flutterプロジェクトにおける NDKの利用場面

#

例えば、次のような場面で NDK が必要になることがあります：

• 画像／音声処理系のプラグイン（例：ffmpeg、tflite 等）
• Android のネイティブ API 呼び出しを Flutter からラップしているプラグイン
• 既存の Android ライブラリを Flutter プロジェクト内で再利用している場合

このため、Flutter アプリをAndroidでリリースしたり、ネイティブライブラリを多用する場合には、NDKのバージョン・設定が重要になります。

FlutterのNDK versionエラー例と原因を徹底解説

#

エラー例①：No version of NDK matched the requested version

#

No version of NDK matched the requested version 21.4.7075529

このエラーは、android/app/build.gradle 内で指定された ndkVersion が、ローカルにインストールされていないバージョンであることが原因です。

エラー例②：NDK not configured. Download it with SDK Manager.

#

NDK not configured. Download it with SDK Manager.

このエラーは、Android SDK Manager で NDK がインストールされていない、または設定が通っていない場合に発生します。

エラー例③：One or more plugins require a higher Android NDK version

#

Your project is configured with Android NDK 26.xxx…, but the following plugin(s) depend on a different Android NDK version:

path_provider_android requires Android NDK 27.0.12077973
Fix this issue by using the highest Android NDK version (they are backward compatible).
Add the following to android/app/build.gradle.kts:
ndkVersion = "27.0.12077973"

このエラーは、プロジェクトの NDK バージョンと使用中プラグインが要求する NDK バージョンが異なっているため発生します。

FlutterでNDK versionを確認・設定する方法

#

Android Studioでの確認方法

#

1. Android Studio を起動
2. メニューから Preferences／Settings → Appearance & Behavior → System Settings → Android SDK を選択
3. 「SDK Tools」タブを開き、「NDK (Side by side)」欄を探す
4. 「Show Package Details」にチェックを入れ、インストール済みの NDK バージョンを確認

この画面で表示されたバージョンが、実際にローカル環境で利用可能な NDK です。

コマンドラインでの確認方法

#

macOS／Linux:

ls ~/Library/Android/sdk/ndk/

Windows:

dir "C:\Users\<ユーザー名>\AppData\Local\Android\Sdk\ndk"

このフォルダ内に複数バージョンがあれば、どの NDK がインストールされているか確認できます。

推奨 NDK バージョン（2025年版）

#

多くの Flutter プロジェクト・プラグインで「NDK 27.0.xxxx」が推奨されており、逆にそれより低いバージョンだとプラグインの要求に応えられない事例が増えています。 community.esri.com

例：Flutter 3.29 以上では NDK 27.0.12077973 が最低でも推奨とする声があります。 このため、プロジェクト側では ndkVersion をこのあたりに合わせておくと、トラブルが少なくなります。

Flutterプロジェクトでの正しい ndkVersion 設定手順

#

build.gradle における指定例

#

android/app/build.gradle の android ブロック内に以下のように記述します（Groovy形式）：

android {
    compileSdkVersion 34

    defaultConfig {
        applicationId "com.example.myapp"
        minSdkVersion 24
        targetSdkVersion 34
        versionCode 1
        versionName "1.0"
    }

    // ここで NDK バージョンを固定する
    ndkVersion "27.0.12077973"
}

Kotlin DSL (build.gradle.kts) を使用している場合は次のようになります：

android {
    compileSdk = 34

    defaultConfig {
        applicationId = "com.example.myapp"
        minSdk = 24
        targetSdk = 34
        versionCode = 1
        versionName = "1.0"
    }

    ndkVersion = "27.0.12077973"
}

ndkVersion を固定する利点と注意点

#

利点：

• チーム開発でビルド環境を統一しやすくなる

• CI/CD 環境でビルドが安定する

• プラグイン側が要求する NDK バージョンとずれた時のエラーを未然に防げる

インストール済みでないバージョンを指定すると、逆に「バージョンが見つからない」エラーが出るため、必ずローカルにそのバージョンが存在していることを確認してください。

Android Studioで NDK をインストール・更新する手順

#

手順概要

#

Android Studio を起動

メニューから Tools → SDK Manager を選択

「SDK Tools」タブをクリック

「NDK (Side by side)」にチェックを入れ、必要に応じて「Show Package Details」でバージョンを選択・インストール

「Apply」→「OK」でインストールを実行

インストール完了後、ターミナルから flutter doctor -v を実行して異常がないか確認

この手順で最新・必要な NDK バージョンを導入できます。

Flutter NDK versionエラーが直らない時のチェックリスト

#

エラー：Flutter が古い NDK を参照している

#

現象： flutter.ndkVersion を使っていて、プロジェクトが古いバージョンを参照してしまっている。例えば ndkVersion flutter.ndkVersion のまま、プラグインが要求するバージョンに至っていない。

対策： android/app/build.gradle 内で明示的にバージョンを指定する（例：ndkVersion “27.0.12077973”）ことで解決します。

エラー：「NDK not found」

#

現象： NDK がインストールされていない、または SDK のパス設定が正しくない。 対策： Android Studio の SDK Tools から NDK をインストールした後、local.properties に ndk.dir を指定する例もありますが、一般的には SDK Manager からインストールして build.gradle で ndkVersion を明示しておくことが有効です。

エラー：「NDK version mismatch」

#

現象： プラグインが要求する NDK バージョンと、プロジェクトで使用しているバージョンが異なっており、ビルドが失敗する。

対策： プラグインが要求しているバージョンを確認し、それ以上のバージョンを ndkVersion に指定し、プロジェクト全体で統一しておくのがベストです。

最終手段：これでも直らない時のチェックリスト

#

まずはflutter clean を実行し、キャッシュをクリアします。

flutter clean
flutter pub get

上記コマンドを実行後、Android Studio を再起動してください。

その後、Android SDK / NDK の状態を下記flutter doctorコマンドで確認します。

flutter doctor -v

android/local.properties や android/gradle.properties に誤ったndk.dir設定が残っていないか確認

他のモジュール（サブプロジェクト）でndkVersionが異なって指定されていないか確認してください。

必要なら afterEvaluate ブロックで強制統一も可能です。

Flutter NDK versionに関するFAQ（よくある質問）

#

Q1. Flutterで「NDK version」エラーが出る主な原因は？

#

A. 主な原因は、Flutterのビルド設定で指定されたNDKバージョンと、実際にAndroid SDKにインストールされているNDKのバージョンが一致していないことです。

Q2. ndkVersionはどこで設定すればいいですか？

#

A. android/app/build.gradle の android ブロック内に指定します。推奨は ndkVersion "27.0.12077973" など明示的なバージョン指定です。

Q3. 「NDK not configured」エラーの解決方法は？

#

A. Android Studioで「NDK (Side by side)」を有効化してNDKをインストールし、再ビルドすることで解決します。

Flutterおすすめ関連記事

#

👉 関連記事もおすすめです

さいごに

ここまでお読みいただきありがとうございました。
私のブログ記事を読んでいる方の中には海外転職・海外移住への興味がある方もいらっしゃるかと思います。

僕はもともと営業職から転職してITエンジニアになり、現在ベトナムで働き始めて7年目になります。

現在は現地のIT企業に勤めながら、個人でアプリ開発およびブログ執筆を続けております。

ご興味があれば、ぜひ私が開発している個人アプリもチェックしてみてください。
語学学習や日常生活に役立つアプリを中心に、Google Play ストアで無料公開しています。

また、YouTubeチャンネルでは海外生活やアプリ開発に関する情報を発信しています。
海外就職のリアルな体験談やエンジニアとしてのキャリア形成についても触れていますので、
興味のある方はぜひチャンネル登録していただけると嬉しいです。

今後もブログ・アプリ・動画を通じて、海外挑戦を目指す方に役立つ情報をお届けしていきます。

開発アプリ一覧

個人でAndroidアプリ開発を行なっており、下記がこれまで開発・リリースしたアプリ一覧です。

ゼロから始めるベトナム語学習 | ベトナム語類音語クイズ

「ベトナム語類音語発音クイズ」は、日本人学習者のために設計された、効率的に語彙力と発音を強化できる無料学習アプリです。

特徴

• 日常会話でよく使うベトナム語を中心に収録
• 四択クイズ形式で、視覚＋聴覚から効果的に学習
• 日本語の漢字の意味をヒントに正しい読み方を選べる、日本人特化の設計
• 音声付きでネイティブ発音を繰り返し聞ける
• 初心者の発音基礎から、中級者の語彙強化まで幅広く対応

旅行や留学の準備、語学試験対策にも最適。スキマ時間に楽しく学べます。

今すぐ「ベトナム語類音語発音クイズ」をダウンロードして、発音と語彙力を同時にレベルアップしましょう！

ベトナム語類音語クイズ

ベトナム語発音がスッと身につく！類音語クイズで楽しく単語を覚える新感覚学習アプリ

ダウンロードはこちら

Viloで学ぶベトナム語動詞｜毎日5分で語彙力UP

Vilo｜ベトナム語動詞学習アプリは、日常会話に欠かせないベトナム語の動詞を、効率的に楽しく習得できる無料学習アプリです。

特徴

• 日常会話でよく使う動詞を効率的に学習
• 四択クイズ形式で、ゲーム感覚でテンポよく学習
• 音声読み上げ機能付きで、正しい発音も同時に練習
• CEFRレベル対応で、初級～中級まで段階的に学べる
• ランダム出題で繰り返し復習しやすく、記憶に定着

スキマ時間を活用して、短時間でベトナム語の動詞をマスター。留学や旅行、検定試験対策にも最適です。

今すぐ「Vilo」をダウンロードして、毎日の5分でベトナム語動詞の語彙力を伸ばしましょう！

Viloで学ぶベトナム語動詞

ベトナム語動詞を効率的に学べる無料アプリ。日常会話で頻出する動詞を中心に収録し、音声付きで発音も練習可能。初心者から中級者まで、毎日のベトナム語学習に最適！

ダウンロードはこちら

------

Viloで学ぶベトナム語名詞｜毎日5分で語彙力UP

Vilo｜ベトナム語名詞学習アプリ は、日常会話に必須のベトナム語の名詞単語を効率よく習得できる無料学習ツールです。

特徴

• 日常会話で頻出するベトナム語の名詞を効率的に習得
• 四択クイズ形式でゲーム感覚で名詞を学習
• 音声読み上げ機能で正しい発音を確認しながら学習可能
• CEFRレベル対応で初心者～中級者までベトナム語名詞学習が可能

これからベトナム語の名詞を基礎から学びたい方、検定試験対策や留学準備をしたい方に特におすすめです。

今すぐ「Vilo」をダウンロードして、楽しみながらベトナム語名詞の語彙力を伸ばしましょう！

Viloで学ぶベトナム語名詞

ベトナム語名詞学習に特化した無料アプリ。頻出名詞を効率的に覚えられ、音声付きで発音も確認可能。初心者から上級者まで、毎日のベトナム語学習をサポート！

ダウンロードはこちら

------ ------

Viloで学ぶベトナム語形容詞｜毎日5分で語彙力UP

Vilo｜ベトナム語形容詞学習アプリ は、日常会話に必須のベトナム語の形容詞単語を効率よく習得できる無料学習ツールです。

特徴

• 日常会話で頻出するベトナム語の形容詞を効率的に習得
• 四択クイズ形式でゲーム感覚で形容詞を学習
• 音声読み上げ機能で正しい発音を確認しながら学習可能
• CEFRレベル対応で初心者～中級者までベトナム語形容詞学習が可能

これからベトナム語の形容詞を基礎から学びたい方、検定試験対策や留学準備をしたい方に特におすすめです。

今すぐ「Vilo」をダウンロードして、楽しみながらベトナム語形容詞の語彙力を伸ばしましょう！

Viloで学ぶベトナム語形容詞

ベトナム語形容詞学習に特化した無料アプリ。頻出形容詞を効率的に覚えられ、音声付きで発音も確認可能。初心者から上級者まで、毎日のベトナム語学習をサポート！

ダウンロードはこちら

------

Vocaboost｜無料＆聞き流し対応の自分で作る単語帳アプリ

「Vocaboost」は、無料で使える＆自分で作れる単語帳アプリです。さらに聞き流し学習や発音読み上げ機能も搭載し、効率的に語彙を定着させることができます。

覚えたい単語やフレーズを自由に追加し、自分だけのオリジナル単語帳を作成可能。英語・ベトナム語・中国語など、あらゆる語学や資格試験に活用できます。

フラッシュカード形式で繰り返し学習ができるうえ、耳から覚える「聞き流し」機能により、通勤・通学やスキマ時間でも学習が可能。シンプルで直感的な操作性で、初心者から上級者まで幅広く対応します。

「単語帳＋聞き流し＋自分で作る＋無料」をすべて実現した学習アプリ。今すぐ「Vocaboost」で自分専用の語学トレーニングを始めましょう！

Vocaboost

Vocaboostは「無料・聞き流し・自作対応」の単語帳アプリ。英語やベトナム語などの語学学習に最適で、発音読み上げや暗記サポート機能も充実。毎日の勉強を効率化！

ダウンロードはこちら