Android Studioでアプリパッケージ名を変更する正しい手順

Andrdoi Studioで次のようなことがしたい

▼ 現在のアプリパッケージ名

com.myapp.hogehoge

1	com.myapp.hogehoge

▼ これを別のアプリパッケージに変更

com.myapp.fugafuga

1	com.myapp.fugafuga

プロジェクト作成したばかりだったり、アプリリリース前に唐突にアプリパッケージ名を変えたくなったり……そういう場面は多くはないけど存在します。

そこでAndroidStudioでアプリパッケージ名変更、
この手順を自分へのメモも兼ねて覚え書きしておきます。

このページの目次

０．パッケージ名変更の前に注意すべきこと
１．ソース上でのアプリパッケージ名を変更
２．ソース上で新パッケージ名の反映を確認
３．build.gradleでアプリケーションIDを変更
４．必要ならsettings.graldeでプロジェクト名も変更
パッケージ名変更手順のまとめ

０．パッケージ名変更の前に注意すべきこと

試す前に大事なことがあります。

それは次の場合はパッケージ名変更できないってこと

GooglePlayにアプリをリリース済み
過去に1回以上アップデートしている

当たり前ですが、既にGooglePlayで公開・更新されているアプリパッケージ名の変更はできません。仮にそうするなら新しくアプリプロジェクト作成した方がいいです。

今回紹介する方法は次のケースで役立ちます。

まだプロジェクトを作成したばかりの場合
アプリ初リリース直前に変えたくなった場合

アプリを公開していないという前堤でのやり方です。

初めにこの点をよく確認しておきましょう。

１．ソース上でのアプリパッケージ名を変更

初めにJava/Kotlinソース上での変更が必要

AndroidStudioのプロジェクトツリーを開き、
その中の [app] => [java] => [パッケージ名] を見つけます。

▼ この画像で赤枠で囲ったやつ

そして右クリックしてメニューを開き、[Refactor] => [Rename] をクリックしてください。あるいは Shift+F6 でも同じことができます。

▼ このような確認ダイアログが表示される

これは androidTest とか test などのディレクトリでもパッケージ名を変更するかと聞かれているので、特別な事情がなければ [Rename package] を押せばOKです。

▼ パッケージ名の変更ダイアログが出てくる

あとは好きなパッケージ名を設定してください。

この例では com.myapp.hogehoge => com.myapp.fugafuga に変更したいので、hogehoge => fugafuga と入力して [Refactor] を押すことになります。

▼ 以下の Refactoring Preview が表示される

上記画像のようなリファクタープレビューが表示されるので、確認したら [Do Refactor] を押せばJava/Kotlinソース・AndroidManifest.xmlに対してパッケージ名変更が実行されます。

２．ソース上で新パッケージ名の反映を確認

Java／KotlinソースとかAndroidManifest.xmlを開いてみます。

▼ java／kotlinだったらパッケージ名が変更されてる

/// 変更されたパッケージ名
package com.myapp.fugafuga

import ...

class MainActivity : AppCompatActivity(){
    ...
}

/// 変更されたパッケージ名

package com.myapp.fugafuga

import ...

class MainActivity : AppCompatActivity(){

...

}

▼ AndroidManifest.xmlも修正される

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.myapp.fugafuga">
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/Theme.MyApp">
        <activity
            android:name="com.myapp.fugafuga.MainActivity"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

<manifest xmlns:android="http://schemas.android.com/apk/res/android"

package="com.myapp.fugafuga">

<application

android:allowBackup="true"

android:icon="@mipmap/ic_launcher"

android:label="@string/app_name"

android:roundIcon="@mipmap/ic_launcher_round"

android:supportsRtl="true"

android:theme="@style/Theme.MyApp">

<activity

android:name="com.myapp.fugafuga.MainActivity"

android:exported="true">

<intent-filter>

</intent-filter>

</activity>

</application>

</manifest>

これでソース的なパッケージ名変更は完了

３．build.gradleでアプリケーションIDを変更

次にパッケージ名に合わせてアプリID変更です。

まずモジュールレベルのbuild.gradleを開きます。

▼ build.gradle (Module:...) を開く

そしてapplicationIdの設定を探します。

▼ android => defaultConfigの中にある

android {
    compileSdkVersion 33
    buildToolsVersion "30.0.3"

    defaultConfig {
        /// ▼ アプリケーションID
        applicationId "com.myapp.hogehoge"
        
        minSdkVersion 24
        targetSdkVersion 33
        versionCode 1
        versionName "1.0.0"

        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }
...
}

android {

compileSdkVersion 33

buildToolsVersion "30.0.3"

defaultConfig {

/// ▼ アプリケーションID

applicationId "com.myapp.hogehoge"

minSdkVersion 24

targetSdkVersion 33

versionCode 1

versionName "1.0.0"

testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"

}

...

}

▼ 新しいアプリパッケージ名に変更する

android {
    compileSdkVersion 33
    buildToolsVersion "30.0.3"

    defaultConfig {
        /// ▼ 新しいアプリケーションID
        applicationId "com.myapp.fugafuga"
        
        minSdkVersion 24
        targetSdkVersion 33
        versionCode 1
        versionName "1.0.0"

        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }
...
}

android {

compileSdkVersion 33

buildToolsVersion "30.0.3"

defaultConfig {

/// ▼ 新しいアプリケーションID

applicationId "com.myapp.fugafuga"

minSdkVersion 24

targetSdkVersion 33

versionCode 1

versionName "1.0.0"

testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"

}

...

}

あとは [Sync Now] を押せば完了です。

４．必要ならsettings.graldeでプロジェクト名も変更

あとパッケージ名以外にアプリ名も変更する場合…

古いプロジェクト名だと紛らわしいこともあります。

そういう時はプロジェクト名も変更しておきましょう。

▼ settings.gradleというファイルを開く

▼ rootProject.name を新しい名前に修正

rootProject.name = "New MyApp"
include ':app'

1 2	rootProject.name = "New MyApp" include ':app'

上記はビルド作業とかにも影響しません。

だから本当に任意の名前をつけて問題ないです。

パッケージ名変更手順のまとめ

ここまでの手順を箇条書き

ソース上でのアプリパッケージ名を変更
ソース上で新パッケージ名の反映を確認
build.gradleでアプリケーションIDを変更
settings.graldeでプロジェクト名も変更

以上、Android Studioでのパッケージ名変更でした。

こういった手順を踏んでいけば確実です。

Android Studioでアプリパッケージ名を変更する正しい手順

０．パッケージ名変更の前に注意すべきこと

１．ソース上でのアプリパッケージ名を変更

２．ソース上で新パッケージ名の反映を確認

３．build.gradleでアプリケーションIDを変更

４．必要ならsettings.graldeでプロジェクト名も変更

パッケージ名変更手順のまとめ

関連記事

プロフィール

人気記事

検索してみる