[Flutter]ハイフン(-)の入ったドメイン名をアプリのIDに使うときの注意点|「AAPT: error: attribute ‘package’ in tag is not a valid Android package name」の対処法【2026年版】

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

 

この記事は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段です。

  1. Flutter のプロジェクトを作るときは、ハイフン入りの名前を入れてもエラーにならない
  2. でも、Android のアプリケーションIDからは、ハイフンが勝手に消えている(iOS のバンドルIDには残っている)
  3. 消えたハイフンを手で入れ直すと、アプリを動かした段階でエラーになる

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年の画面です)。

XcodeのBundle Identifierでは、ハイフンがちゃんと残っている

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 の値が正しくない」と言われるわけなんです。

 

直し方:ハイフンをアンダースコアに変える

手順は次のとおりです。

  1. Android Studio で、Flutter のプロジェクトの android/app/build.gradle.kts を開く(android フォルダの直下ではなく、app の中の方です)
  2. defaultConfig の中の applicationId を探す
  3. ドメイン名の部分のハイフン(-)を、アンダースコア(_)に書き換える
  4. 保存して、アプリを動かし直す

書き換えたあとの形は、次のようになります。

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を変えない(別のアプリとして扱われる)

アプリのリリースでお困りですか?
Google Play・App Storeへのリリース支援サービスをご用意しています。
ビルドエラー解決・動作確認・申請代行まで、現役開発者が対応します。

みんプロ式・アプリ開発支援サービス一覧を見る ↗

こんな記事も読まれています

イチオシ

40代から感じるモヤモヤを解消できる 無料動画セミナー

あすコロ式・40代からの人生アップデート【新】戦略

アラフォーでキャリアを失ったバリバリ左脳人間・スピリチュアル耐性ゼロの元金融マンが、人生どん底から立ち上がる過程でたどり着いた「人生再構築メソッド」。40代・50代を過ぎて多くの人が感じる「このままでいいんかな?」「この先どうしたらいいかわからない」というモヤモヤを解消し、人生後半戦をアップデートさせる【新】戦略。

今すぐ無料で動画セミナー(80分)を見る ▶
GAMBO(願望) ✦ 願望実現・目標達成の
17秒 / 68秒ワーク
GAMBO(願望) 引き寄せ難民だったぼくの挫折経験から生まれた誰でもできる願望実現サポートアプリ。かの有名な17秒/68秒ワークを独自の視覚化メソッドで簡単実践。
App Store / Google Play 詳しく見る →
Meiso(瞑想) ◎ 鐘音と自然音で
5分からのマインドフルネス
Meiso(瞑想) 初心者でも“迷わず続けられる”ことにこだわった、完全無料の瞑想アプリ。画面のガイドに従うだけで呼吸のリズムが整い、最短5分から瞑想を実践できます。
App Store / Google Play 詳しく見る →
小学生からの英検®単語 A ふりがな・音声付き
英検単語1日5分トレーニング
小学生からの英検®単語 ありそうでなかった!ふりがな付き英検®単語トレーニングアプリ!1日たった5分!スキマ時間を活用して、英検®頻出単語を効率的に習得。お子様の一人学習にも安心設計。
App Store / Google Play 詳しく見る →
オボエルンジャー ★ レトロゲームで
nバック脳トレ
オボエルンジャー 科学的脳力開発法「Nバック課題」をファミコン風8bitレトロゲームにアレンジした新感覚脳トレアプリ。記憶力・感情コントロール力・集中力の向上に。
App Store / Google Play 詳しく見る →
ゴイコイコイ 語 超高速フラッシュカードで
語彙習得
ゴイコイコイ 日常語1400語を視覚的に学べる、高速読み上げフラッシュカード式の語彙トレーニングアプリ。知育教室で行われるフラッシュカード学習を、家庭で“手軽に・安価に・正確に”再現。
App Store / Google Play 詳しく見る →

TOP