この記事は2021年に書いたものを、2026年11月に今のやり方に合わせて書き直しました(2026年11月21日時点の情報。公式ドキュメントで確かめています)。
アプリをストアに出すには、そのアプリを見分けるための ID が要ります。Android では「アプリケーションID(applicationId)」、iOS では「バンドルID(Bundle Identifier)」です。
ID の頭には、自分のドメイン名を逆にしたもの(例:「minpro.net」なら「net.minpro」)を付けるのが慣習です。
ところが、そのドメイン名にハイフン(-)が入っている場合(例:「min-pro.net」)、Android だけにちょっとしたトラップがあります。
答えは、Android のアプリケーションIDの中のハイフン(-)を、アンダースコア(_)に変えることです。
今の Flutter のプロジェクトなら、android/app/build.gradle.kts の applicationId を次のように書きます。
applicationId = "net.min_pro.sample_pt"以下、何が起きるのかと、直し方の手順を順に見ていきます。
もくじ
トラップの流れ:作るときは通るのに、あとでつまずく
ハイフン入りのドメイン名を使ったときに起きることは、次の3段です。
- Flutter のプロジェクトを作るときは、ハイフン入りの名前を入れてもエラーにならない
- でも、Android のアプリケーションIDからは、ハイフンが勝手に消えている(iOS のバンドルIDには残っている)
- 消えたハイフンを手で入れ直すと、アプリを動かした段階でエラーになる
1と2:Android の ID だけ、ハイフンが消える
Android Studio で Flutter の新しいプロジェクトを作るとき、「Organization」の欄にドメイン名を逆にしたもの(例:net.min-pro)を入れます。Flutter の公式ドキュメントにも、この値はアプリ名と合わせて、Android のパッケージ名と iOS のバンドルIDに使われ、公開したあとは変えられない、と書かれています。
(「Organization」の欄に何を入れるかは、こちらの記事でも書いていますので、よろしければご覧ください)
ここにハイフン入りの名前を入れても、エラーにならずにプロジェクトができます。
ところが、できあがった android/app/build.gradle.kts を開いてみると、ハイフンが消えて net.minpro.sample_pt になっているんです。
「え、ハイフンどこ行ったん?」となりますよね。
これは、Flutter のツールが Android 用の ID を作るときに、英数字・アンダースコア・ドット以外の文字を取り除く作りになっているためです(2026年11月21日時点の Flutter のツールのソースで確かめました)。
一方、iOS 用の ID を作るときは、ハイフンを残す作りになっています。Xcode のバンドルIDを見ると、ハイフンはちゃんと残っています(下は2021年の画面です)。
Apple の説明でも、バンドルIDに使えるのは英数字・ハイフン・ピリオドなので、iOS はハイフンのままで問題ありません。
3:手でハイフンを入れると、ビルドでエラーになる
じゃあ、Android のアプリケーションIDにも、手でハイフンを入れればいいのでは、と思いますよね。
applicationId = "net.min-pro.sample_pt"こう書いてアプリを動かすと、ビルドの途中でエラーになります。2021年にこの記事を書いたときに出たエラーは、次のとおりです(フォルダの場所は書き換えています)。
* What went wrong:
Execution failed for task ':app:processDebugResources'.
> A failure occurred while executing com.android.build.gradle.internal.tasks.Workers$ActionFacade
> Android resource linking failed
[プロジェクトのフォルダ]/build/app/intermediates/merged_manifests/debug/AndroidManifest.xml:2: AAPT: error: attribute 'package' in <manifest> tag is not a valid Android package name: 'net.min-pro.sample_pt'.エラーの文は、Android Gradle プラグインの版などの環境によって異なることがあります。
なぜエラーになるのかというと、Android のアプリケーションIDの決まりで、ハイフンが使えないからです。Android Developers の説明では、アプリケーションIDの決まりは次の3つです。
- 2つ以上の区切り(ドットが1つ以上)がある
- 区切りごとに、頭は英字で始まる
- 使える文字は、英数字とアンダースコア(a〜z・A〜Z・0〜9・_)だけ
ビルドすると、アプリケーションIDがマニフェストの package の欄に写されます。そこでハイフンが引っかかって、「package の値が正しくない」と言われるわけなんです。
直し方:ハイフンをアンダースコアに変える
手順は次のとおりです。
- Android Studio で、Flutter のプロジェクトの
android/app/build.gradle.ktsを開く(androidフォルダの直下ではなく、appの中の方です) defaultConfigの中のapplicationIdを探す- ドメイン名の部分のハイフン(-)を、アンダースコア(_)に書き換える
- 保存して、アプリを動かし直す
書き換えたあとの形は、次のようになります。
android {
namespace = "net.minpro.sample_pt"
...
defaultConfig {
applicationId = "net.min_pro.sample_pt"
...
}
}古いプロジェクトで、ファイルが build.gradle(Groovy の書き方)のときは、= のない形で書きます。
applicationId "net.min_pro.sample_pt"namespace は変えなくても動く
今の Flutter のプロジェクトの build.gradle.kts には、applicationId のほかに namespace という行があります。新しく作ったときは、どちらも同じ値(ハイフンが消えた net.minpro.sample_pt)です。
Android Developers の説明では、2つの役割は次のように分かれています。
- applicationId:端末と Google Play ストアがアプリを見分ける ID
- namespace:コードのパッケージ名。自動で作られる
Rクラスなどの置き場に使われる
ストアや端末が見るのは applicationId なので、ハイフンの問題を直すだけなら、書き換えるのは applicationId だけで足ります。namespace は、違う値のままでもビルドできます(ビルドのときに、applicationId がマニフェストに写されるためです)。
Android Developers は、わかりやすさのために2つを同じ値にそろえるのを勧めています。namespace もそろえたいときは、Flutter の公式ドキュメントのとおり、MainActivity.kt(または MainActivity.java)の1行目の package の文を同じ値に直し、ファイルを新しいフォルダの形(例:android/app/src/main/kotlin/net/min_pro/sample_pt/)に移します。ここを忘れると MainActivity が見つからなくなるので、自信がなければ namespace はそのままにしておくのが安全です。
(アプリケーションIDとパッケージ名の関係は、こちらの記事でも書いていますので、よろしければご覧ください)
もう公開しているアプリは、ID を変えない
すでにハイフンの消えた ID(例:net.minpro.sample_pt)で Google Play に出しているアプリは、ID を書き換えないでください。
Android Developers の説明では、公開したあとにアプリケーションIDを変えると、Google Play は別のアプリとして扱います。今のアプリの更新として出せなくなります。
アンダースコアに直すのは、まだ公開していないアプリのときだけです。
アンダースコアなら、ほかの人のドメインとかぶらない
ここで、「アンダースコアに変えたら、ほかの人のドメイン名とかぶるのでは?」と気になるかもしれません。
ドメイン名には、ふつうアンダースコアが使えません。たとえば JP ドメインの規則(JPRS の技術細則)でも、使える文字は英字・数字・ハイフンだけです。ですから、net.min_pro に当たるドメイン名を、ほかの人が持っていることはないわけです。
この直し方は、Java の言語仕様にある、パッケージ名の慣習と同じです。Java の言語仕様には、ドメイン名にハイフンなど、名前に使えない文字が入っているときは、アンダースコアに変える、と書かれています。
逆に、ハイフンが消えたまま(net.minpro)にしておくと、「minpro.net」というドメインを持つ別の人の ID と、かぶるおそれがあります。
ハイフン入りのドメイン名を使うなら、消えたままにせず、アンダースコアに変えておく。
これが、このトラップへのいちばん確かな対処です。
2021年版から変わったところ
古い情報で検索して来た方のために、2021年版との違いをまとめておきます。
| 2021年版 | 2026年11月時点 |
|---|---|
| 新しいプロジェクトの画面の欄は「Package name」 | 欄の名前は「Organization」(ドメイン名を逆にしたもの) |
書き換えるファイルは android/app/build.gradle(applicationId "...") | 新しいプロジェクトは android/app/build.gradle.kts(applicationId = "...")。namespace の行もある |
| ハイフンをアンダースコアに変える | 同じ。公開済みのアプリは ID を変えない |
2021年版の動画と、プロジェクト作成画面・build.gradle の画面の写しは、画面と書き方が今と違うため外しました。
まとめ
参考:Configure the app module(Android Developers、2026年11月21日確認)/Build and release an Android app(Flutter docs、2026年11月21日確認)/Android Studio and IntelliJ(Flutter docs、2026年11月21日確認)/CFBundleIdentifier(Apple Developer Documentation、2026年11月21日確認)/The Java Language Specification 6.1(Oracle、2026年11月21日確認)/汎用JPドメイン名登録等に関する技術細則(JPRS、2026年11月21日確認)
何かのお役に立てれば幸いです。
- ハイフン入りのドメイン名で Flutter のプロジェクトを作ると、Android のアプリケーションIDからだけハイフンが消える(iOS のバンドルIDには残る)
- Android のアプリケーションIDに使えるのは英数字とアンダースコアだけなので、手でハイフンを入れると「AAPT: error: attribute ‘package’ in <manifest> tag is not a valid Android package name」でビルドが止まる
- 直し方は、
android/app/build.gradle.ktsのapplicationIdのハイフンをアンダースコアに変える(例:applicationId = "net.min_pro.sample_pt") - ハイフンの問題を直すだけなら、書き換えるのは applicationId だけでよい。namespace もそろえるなら、MainActivity の package の文とフォルダも直す
- すでに公開したアプリは、アプリケーションIDを変えない(別のアプリとして扱われる)
ビルドエラー解決・動作確認・申請代行まで、現役開発者が対応します。







