ささいなことではあるのですが
Android Studio でプロジェクト作成後に,
ちょっと気に入らないとか typo を後で発見したという理由で,
プロジェクト全体の名前をリネームしたいときがあるかもしれません.
実際,適当なプロジェクトをつくって
名前を変えたいなと後で思ったのですが,
実際のところ意外と面倒であるということが分かったので,
あまりオススメされないとは思うものの
どんなものかメモとして書き残そうと思います.
まず,そのままリファクタしてみよう
myproject1
というプロジェクトを mysuperproject1
にリネームすることを考えます.
プロジェクトとしてルートモジュールを Refactor
> Rename...
からリネームできそうなので試みるのですが,
実はこれはできないということがわかります:
Can't rename root module
となり,
この方法でルートモジュールはリネームしてくれないのです.
(遊び半分で実行してほしくないのかもしれません)
プロジェクト名をリネーム
絶対リネームできないのかというと,実はそういうわけでもなくて,
いくつかのステップを踏めばリネームはできなくはないということです.
settings.gradle
の rootProject.name
がプロジェクト名になるということで
(https://pleiades.io/help/idea/gradle.html#convert_project_to_gradle)
まずこれを変更します:
その後,Gradle 関連の変更を同期するために Sync Now
します:
そうすると,プロジェクトツリーのルートの表示が変化して,
リネームされたのですよ,という感じになります:
ただし,表示からなんとなくわかるように,
この状態ではディレクトリ名は一致していません.
プロジェクト名を変更したいほどの人であれば
きっとディレクトリもリネームしたいと思いますから,
プロジェクトをクローズして mv
なりでリネームし,
再度リネームされたプロジェクトを開きます.
そうすると,表示がいつもどおりになって一致します:
パッケージをリネーム
ここまでで満足した人はここまでで OK です.
お気づきだと思うのですが,
たいていパッケージ名にも含まれているプロジェクト名はそのままで,
きっとパッケージもリネームしたいと思うでしょう.
その場合は,ツリーからパッケージもリネームします:
ところで,このリネームにはこれくらいの影響があるということがわかりますので,
大丈夫そうであることを十分確認して実行します:
このリファクタを実行すればパッケージはリネームされ,
見えている範囲はおおむね良好になります:
ほかをリネーム
ほかはプロジェクト名を含むリテラルであるとか,
テンプレートから生成されたコードの一部であったりします:
たとえば生成されたテーマが MyAppTheme
とかになっているのが例で,
ひょっとすると ここも変更したいと思うかもしれません.
プロジェクト名が fun
みたいな
よく使われるキーワードだったらヒットしまくって厳しそうですが
Find in Files...
で検索して
必要な箇所を同様にリファクタでリネームします.
build.gradle
の applicationId
は触ってよいのか不安だと思うのですが後述します.
慎重になるべきリネーム
よく認知されているように アプリケーション ID まで変えるのは
「アプリケーション ID を設定する | Android Developers」にあるように,
アプリ自体が別物として扱われるというのが容易に想像できていると思います.
アプリケーション ID を変更すると、Google Play ストアは新しいバージョンのアプリをまったく別のアプリとして扱います。
そのため、アプリを公開したら、絶対にアプリケーション ID を変更しないでください。
サンプルして含まれる Context.packageName
と
ハードコードされた名前を比較するインストゥルメント化テストを実行すると,
当然リネーム後は一致しなくなりますし:
(このためにあったのではないかと思うくらいピッタリなテストですね)
アプリとしても完全に別物になりますね:
(区別できるように android:label
を変更してあります)
なので,ここまでリネームするケースは,
まだ公開していないプロジェクトに限られると思います.
既存の公開済みアプリでこの影響を承知で
すべてを完璧にリネームしたい開発者はいないのではないかと思えます.
ところで一方,AndroidManifest.xml
の package
は変更できて
パッケージと一致していないといけないということです:
プロジェクトのパッケージ名は、デフォルトでアプリケーション ID と一致していますが、変更することもできます。ただし、パッケージ名を変更する場合は、以下の例に示すように(プロジェクトのディレクトリ構造で定義されている)パッケージ名が
AndroidManifest.xml
ファイル内のpackage
属性と常に一致する必要があることにご注意ください。
パッケージ名を完全にリファクタリングする場合は、必ず
package
属性も更新してください。Android Studio のツールを使用してパッケージの名前を変更してリファクタリングすれば、パッケージは自動的に同期が維持されます
このように build.gradle
の applicationId
に限らず,
アプリケーション ID のような箇所は影響を調べて慎重になる必要があるでしょう.
最後に
僕はビルドシステムを理解しているとはいえないですし,
見様見真似でこれで本当にうまくいっているのかも謎なので,
この手順を行う場合は自己責任でお気をつけください.
名前をつけるのは難しいことだと思うのですが,
プロジェクト開始時に時間をかけてでも
気に入る名前やコードネームをつけておけるに越したことはないですね.