[android-studio] Rename package in Android Studio

How do you rename packages in the new IDE Android Studio, based on IntelliJ IDEA?

Is there an automatic refactoring included?

I want to make bulk refactoring, but I don't know how. I worked two years with Eclipse and in Eclipse it's a one-click operation.

The approach used by me for renaming the package name is simple as follows:-

Step 1 : Select the Project option from left menu of Android Studio

Step 2 : Right click on java and add a new package and set the desired package name

Step 3 : Enter you new packagename

Step 4 :Copy all the files from your old package and paste in the new package

Step 5 :Rename the package name in manifest file

Step 6 :Rename the package name in build.gradle file

Step 7 :Then right click the old package and delete it with all its data, and delete that directory as well

Step 8 :Then Rebuild your project

Step 9 :Then you will find some errors of old import packagename in your project Select the old package name in any file and press CTRL + Shift + R , and enter you new package name in replace box, then press find

Step 10 :Then a popup appears like below and select All files option from it

Step 11 :Rebuild your project again, bingo your project packagename has been changed :)

Quick and easy way:

1- open MainActivity.java or any available java file.

At the top there is the package declaration such as:

package com.example.myapp;

select the package portion that you want to change and press Shift+F6. I personally want to change the example.

In the warning dialog, select Rename package and then insert the desired package name.

2- Open AndroidManifest.xml and inside <manifest> tag change the package to the desired package name.

3- open build.gradle(Module: app) and change the applicationId to the desired package name.

To rename the package name in Android studio, Click on the setting icon in the project section and untick the Compact empty Middle Packages, after that the package will split into multiple folder names, then right click on the folder you need to change the name, click on refactor-> Rename-> Type the name you want to change in -> Refactor -> Refactor Directory, then import R.java file in the whole project. Working for me.

The best way is to write the new package name and drag from the older package name.

The second way, if you click Refactor then move option then rename the package name, it will rename the package name and then rebuild.

In Build.gradle you have to do manually, if you Refactor then it will not rename in Build.gradle.

The question asked:

Is there an automatic refactoring included?

I want to make bulk refactoring, but I don't know how. I worked two years with Eclipse and in Eclipse it's a one-click operation.

Well, almost one-click with automatic refactoring, but just one small step first, i.e., just the small step to create the new package. Here is the full solution below.

You can rename a package by creating a new package (including the required folder path) and then drag-and-drop over from the old package (and let Android Studio take care of the refactoring of the various references from the old package to the new), as follows:

1. Right click on java under app.
2. Select New and Package
3. Select the location for the new package as ../app/src/main/java
4. Enter the full name of the new package
5. The new package will be created. Now, drag-and-drop over from the old package to the new. Preview the refactoring if you'd like to check that Android Studio is doing it properly. If it all looks good, proceed with the refactoring.

NB: since application ID and package name are decoupled these days, note that the above is only for renaming the package name. For changing the application ID, you can do that in your build.gradle.

I recommend to use the Sublime Text (or Notepad++). Replace com.one.lastname -> com.two.newname and com/one/lastname -> com/two/newname in ...\Projects[MyProject]. and don't forget to rename ...\Projects\MyProject\app\src\main\java\com\one\lastname, ...\Projects\MyProject\app\src\test\java\com\one\lastname and ...\Projects\MyProject\app\src\androidTest\java\com\one\lastname!

That's all:)

I tried the two top-voted solutions but found some issues even though both work to some extent.

• List item: The new package-drag-drop method leaves some unchanged and creates some undesired effects
• List item: The rename package only changes the last part of package name

After some experiments I found the following method works well for me.

If you just need to change the last part of package name, use the method outlined by GreyBeardedGeek, namely

Right-click on the package in the Project pane. Choose Refactor -> Rename from the context menu

If you need to change the whole package name, do the following.

Right-click on the package in the Project pane. Choose Refactor -> Move from the context menu

This will create a new package folder (when necessary) but will keep the last part of your package name as before. If you need to change the last part, do the rename accordingly.

Note also that you may need to modify package names in e.g. build.gradle, manifest, and/or any xml resource files, or even in your code if hardcoded. After all that, do Sync/Clean/Rebuild project as necessary.

IntelliJ IDEA has an option called "Compact Empty Middle Packages". Select the option icon of the Project tab and de/activate this.

See: How can I change top level package name in IntelliJ IDEA?

The accepted answer didn't work for me. Here's a python script to change the package name directly on the source files.

"""
Notes:
1 - This script it for python3
2 - Create a backup first
3 - Place on the root folder of the android project you want to change
4 - run `python change_android_studio_pkg_name.py`
5 - Type the old package name
6 - Type the new package name
7 - Clean and Rebuild on Android Studio
8 - SRC folder names won't be changed but app will work
"""

import os, glob, traceback
from pathlib import Path

def rwf(fp, mode="r", data="" ):
    if mode == "r":
        with open(fp, "r", encoding='utf8') as f:
            return(f.read())
    elif mode == "w":
        with open(fp, "w", encoding='utf8') as f:
            f.write(data)

old_pkg = input("Old PKG\n").strip()
new_pkg = input("New PKG\n").strip()

if not old_pkg or not new_pkg:
    exit("Args Missing")

dirname, filename = os.path.split(os.path.abspath(__file__))
file_types = ['xml', 'txt', 'json', 'gradle', 'java']
_fs =  glob.iglob(f"{dirname}/**", recursive=True)
for file_path in _fs:
    ext = Path(file_path).suffix.replace(".", "").lower()
    if os.path.isfile(file_path) and ext in file_types:
        try:
            content = rwf(file_path)
            new_content = content.replace(old_pkg, new_pkg)
            rwf(file_path, "w", new_content)
        except:
            print(traceback.format_exc())
            pass

python3 gist

How to rename com.example.app to com.android.app:

1. in package com.example.app select example

2. Shift + F6

3. choose rename package

4. rename example to android

5. confirm do refactor

It is very easy to do. Just follow two steps:

1. Right click on root folder and click on open module settings.

2. After this go to flavors tab and change application id as you wish.

For those who are thinking that this will only change the application id in build.gradle file:

It is written by Google that

The final package that is used in your built .apk's manifest, and is the package your app is known as on your device and in the Google Play store, is the "application id".

and

The package that is used in your source code to refer to your R class, and to resolve any relative activity/service registrations, continues to be called the "package".

You can read more on http://tools.android.com/tech-docs/new-build-system/applicationid-vs-packagename

1. Select option

2. Uncheck the Compact Empty Middle Packages option.

3. Select which directory you want to change(I have selected 'crl' shown in step 6).
4. Shift+F6
5. Rename Package

6. Renaming directory crl to crl1

7. Finally click on Do Refactor button marked in image below enter code here

8. After Changes done

Another good method is: First create a new package with the desired name by right clicking on the Java folder ? New ? Package.

Then, select and drag all your classes to the new package. Android Studio will refactor the package name everywhere.

Finally, delete the old package.

Done.

Very important:

You have to manually change AndroidManifest.xml and build.gradle file to the new package if you use this method.

There are many answer given, but still i am giving my trial....

Step 1 : As Show in the fig above select Setting Option...

Step 2: Select Compact Middle Packages option...

Step 3: Now Expand the package as shown

Step 4: After expanding it will look some thing like

Step 5: Select any on the sub package (in or example or googledevsmsverify) and click Shift+f6 button...

I selected middle package example so it will display as above fig simple rename the package and click on the refactor button

Step 6: you will see the following screen after clicking Refactor button, click on the DO Refactor and wait until build the gradle...

Step 7: Goto build.gradle(Mobile:app) and change the package name of applicationID as shown

Step 8: Just check the package in the manifest.xml file...

All Done the package is change...@Ambilpura

go to AndroidManifest.xml There you will find package as the attribute of manifest tag. Just select the part you want to change, right click-> refactor -> rename

Maybe earlier it was hard, but as of today it is not anymore.

You might also want to change the app id in

defaultConfig {
    applicationId 
}

Short & Sweet

THERE ARE TWO THINGS - PACKAGE NAME and APPLICATION ID.

An easiest and most satisfying way for me is this,

Can you see the highlighting line "vijayjangid", it was "example" before. All I did was renamed example using refractor and the android studio did all the work.

FIRST PART DONE.

Now rename the application id in defaultConfig brackets to same as the name you renamed the example folder. Make sure you rename the package name and id in cloud services like firebase, Aws, realm etc.

That's it you are done, the most upvoted answer is old, we need to update the answers.

Right-click on the package at the Project Panel.

Choose Refactor -> Rename from the context menu.

Packages serve two purposes. One is to uniquely identify your app in the Google Play Store. The other is to name the package for the R.java class which is generated when you build your project. You can think of the first purpose as the external package and the second as the internal package. Assuming you want to change the external package so you can identify in the Play store, there's a convenient way to do this.

In Android Studio,

 choose File -> Project Structure -> Choose your app's module -> Click on the 
 Flavors tab -> change the Application id.

Now, when you build your project, your APK and manifest will use this new package name.

1. Press Ctrl + Shift + R

2. Replace the old package with the new one.

3. Right click on the package name.

4. Refactor > Rename and rename to the new one

If your package starts with mypackageold.something.test then you can't change to mypackagenew.somethingnew.testnew.

In this case, if I follow above accepted answer steps result will be mypackageold.somethingnew.testnew.

Only if your package starts with com.... to New package, above accepted answer will work.

So if you want to change the package from Root Level

1. Change the Required package name inside manifest,
2. Remove the old package and Crate New Package under Android tab,
3. Drag all the Files from old Package to New Package,
4. Inside the Manifest also change the package name for those files,
5. Clean Project,
6. Open build.gradle and update applicationId.

I needed to run File->Invalidate Caches/Restart... to remove remnants of the original package

If your package name is more than two dot separated, say com.hello.world and moreover, you did not put anything in com/ and com/hello/. All of your classes are putting into com/hello/world/, you might DO the following steps to refactoring your package name(s) in Android Studio or IntelliJ:

• [FIRST] Add something under your directories(com/, com/hello/). You can achieve this by first add two files to package com.hello.world, say

   com.hello.world.PackageInfo1.java
   com.hello.world.PackageInfo2.java

then refactor them by moving them to com and com.hello respectively. You will see com and com.hello sitting there at the Project(Alt+1 or Command+1 for shortcut) and rename directories refactoring is waiting there as you expected.

• Refactor to rename one or more of these directories to reach your aim. The only thing you should notice here is you must choose the directories rather than Packages when a dialog ask you.

• If you've got lots of classes in your project, it will take you a while to wait for its auto-scan-and-rename.

• Besides, you need to rename the package name inside the AndroidManifest.xml manually, I guess, such that other names in this file can benefit the prefix.

• [ALSO], it might need you to replace all com.hello.world.R to the new XXX.XXX.XXX.R(Command+Shift+R for short)

• Rebuild and run your project to see whether it work. And use "Find in Path" to find other non-touch names you'd like to rename.

• Enjoy it.

• First u need to go to settings icon which is Appear in left. click on that dropdown and uncheck Compact Empty Middle Packages

Go to Your AndroidManifest.xml

1. Select All of your Package and then Right click there
2. Refactor and then rename that how you want.
3. and then go to your build.gradle and then change Applicationid with packagename that what you have in Android Manifest.

It is worked For Me

it will work fine for me

Change Following.

Step 1: Make sure ApplicationId And PackageName will Same. example :

  android {
  defaultConfig {
                     applicationId "com.example.myapplication"
                 }
       }
 and package name the same. package="com.example.myapplication"

Step 2 delete iml file in my case :

  Go To Project> >C:\Users\ashif\Documents\MyApplication  .iml file // delete 
if you forget Project Path Then Go To android Studio Right Click on app and go to  Show in Explorer you get your Project and remove .iml file

Step 3 Close Project

Step 4 Now Copy Your old Project and Paste Any other Root or copy Project Folder and paste Any other Dir.

 Example C:\Users\ashif\Documents/MyApplication 

Step 5

Now open Android Studio and open Existing Project 
C:\Users\ashif\Documents/MyApplication 

Try it will work

I have seen the top voted answers but i found is a little bit different to do this, i try to do the most complete tutorial.

From the Android Studio click over the gear icon ( ) and then select the option: "Compact Empty Middle Packages", to see the folders separated in a tree view.

Now select the folder, click right button to open the contextual menu, select Refactor and then Rename

You will be advised to refactor the package:

Then a window will show the coincidences inside the proyect, select "Do Refactor":

We don´t have to change manually the AndroidManifest.xml or build.gradle files, Refactoring the package will do the job!.

Please try the following steps:

1. Click on setting gear icon and deselect Compact Empty Middle Package
2. Now we can see each package folder is broken into parts
3. Now right click on the first package folder >>> refactor >>> rename
4. Now a warning will be displayed but you go ahead and click Rename Package
5. After that enter your domain name for the package name
6. Click on ‘Do Refactor’
7. Now it has change the package domain name of the App. Now Change the domain extension and App folder name according to your requirement
8. Now open build.gradle (Module: app) in Gradle Scripts. Here change the application id and click Sync Now.

*******Finally it’s done ******

For me , i just changed the directory name instead of package name of the library module and clicked Do refactor at the bottom (example: from com.reg.register -> com.reg1.register).

After that make sure you updated the new directory name in build gradle file and manifest file.

Rebuild the project.

I've found a way easier solution to this problem which also changed the generated imports like com.test.testpackagechange.R and only takes about a minute.

Your first step is to open Android Studio and open the replace all window (Mac: cmd + shift + R, Windows I assume: ctrl + shift + R). Type in your old package name and in the one below your new package name. Click Find. This may take a while because it is also looking through the generated items. If it has over 1000 hits, just click continue.

After you've done that push Replace All to replace your old package name with your new one.

Now close Android Studio and go to Finder on Mac or Windows Explorer on Windows. Change the name of the folders to your new package name, like this:

Now open Android Studio again. Gradle will sync and your package name should be changed to the new one.

I've found this to be the easiest one and the one that covers all areas like generated files.

This I believe what you are looking for is Refactor > Move. You can also press F6.

You will get two popups. Make sure you select rename package on both. After that you will get a pop up to place the new package name.

Please note that if your package name is, for example, com.example.android.projectname then this will let you change com.example.android to something else.

One more thing, this will update the applicationId in your build.gradle as well. Just make sure that the checkboxes for "search in comments and strings" and "search for text occurrences" are both checked for it to work.

Right Click on the Package name -> Refractor ->Rename -> enter the name of the package ->Click “Refractor”. Do not edit any of the build files except “build.gradle” under the “app” folder.

From Renaming android studio project - Vishnu Sivan

There is also a good keyboard shortcut key just click n select the Class / Package which you want to rename and press ALT + two times R or Shift+ F6

which reflect :-> Refactor menu and Rename function in Android Studio. After rename the existing package it shows in bottom side where the effect of this reflection / rename if you click on Refector button it will change the Class name / Package name where is used in whole Project.

That works very well for me, even for changing the occurrences, in all the modules concerned, for the folders names I want to modify in the package but, for me, it works fine only if I follow exactly the following steps :

• A - If you want to change the name of the root folder (in other words the folder's name who is normaly used in the package to contain the principal activity), you can do it before or after the following steps (B to C) by exiting from "Android Studio" and rename manually this root folder. Click after on "Import project..." and then on the new name of your project (this import process will automatically readjust the 'Gradle' files with the project files.)
• B - before the following C step, don't forget to modify manually the folder's names you want to change in the package by changing them in the 3 following files: 'AndroidManifest.xml', 'MainActivity.java' (or the name you eventually choose for your first activity) and the 'build.gradle (Module: app)' file.
• C - Follow the steps 1 to 6 described above ("In your Project pane, click on the little gear icon...") -> https://stackoverflow.com/a/29092698/2001610
• D - Only if you want to change the name of the root folder now, you can follow the 'A' process, as described above.

Be sure to go to Sheharyar's great Answer. There are so many answers and comments that follow it that it would be easy to get confused and give up, but don't. That answer works.

In short, you do three things:

(1) Deselect Compact Empty Middle Packages.

(2) Refactor then Rename each old directory node by choosing Change Package (not Change Directory) to match the new package name. (Be sure to do a preview of changes.)

(3) Edit the build.gradle file and make APPLICATION_ID match the new package name.

• Go to project path > where you located Java files and package
• Create new folders, for example com ? super_package ? activities
• Android Studio will refresh project structure
• Move all Java files to new folders
• Remove old folders
• Menu Edit ? Find ? Replace in path:
• Change old package name to new
• Change also in manifest and build gradle

Done!

Select the package that will be refactored. Refactor ? Move ? "Move xxx to new package".

If your only reason for renaming is to avoid collision with another build (or a system app) with the same package name, then you can instead rename ONLY the applicationId in your app's build.gradle file.

Example: Given that you already have an app installed with the id com.android.phone (which you want to keep) change your app/build.gradle to:

android {
    defaultConfig {
        applicationId "com.android.phone.mymod"

}

I.e. if you already have an app with the package name com.android.phone and don't want/cannot uninstall it (for example because it's a system app and the device is not rooted) then the change above is all that is needed in order to have your app installed side-by-side with the original app. On the device the applicationId is what will be used and not the actual package name. Also your app data will be stored under /data/data/com.android.phone.mymod rather than /data/data/com.android.phone.

^{NB. In certain cases you might also need to rename the names of providers and authorities in your AndroidManifest.xml file.}

Reference:

• https://developer.android.com/studio/build/application-id

When you create a new project in Android Studio, the applicationId exactly matches the Java-style package name you chose during setup. However, the application ID and package name are independent of each other beyond this point. You can change your code's package name (your code namespace) and it will not affect the application ID, and vice versa (though, again, you should not change your application ID once you publish your app). However, changing the package name has other consequences you should be aware of, so see the section about how to change the package name.

Updated answer: May 2015

OK I have been struggling with cloning & renaming projects in Android Studio, but finally I achieved it. Here are the steps to follow:

1. Copy the project folder, rename it & open it with Android Studio
2. Rename module directory from explorer
3. Rename projectName.iml and content
4. Rename idea/.name content
5. In your Project pane, click on the little gear icon -> uncheck "Compact Empty Middle Package"
6. Refactor src directories for new package name (rename package, "not rename directory")
7. In build.gradle rename application id
8. settings.gradle rename module

That's it...

The common mistake that one can make is one cannot rename the package structure i.e. it is not possible to change com.name.android to com.Renamed.android when one tries to modify at the com.name.android level.

In order to have the same desired change go one level up i.e com.name and here when you refactor change it to Renamed. This will work always.

Changing the application ID (which is now independent of the package name) can be done very easily in one step. You don't have to touch AndroidManifest. Instead do the following:

1. right click on the root folder of your project.
2. Click "Open Module Setting".
3. Go to the Flavours tab.
4. Change the applicationID to whatever package name you want. Press OK.

Note this will not change the package name. The decoupling of Package Name and Application ID is explained here: http://tools.android.com/tech-docs/new-build-system/applicationid-vs-packagename

1. Select the package name in the Java folder.
2. Shift+F6
3. Change the package name and click OK.

Your package name will be changed from all the Java files and the manifest file. You have to manually change the package name from build.gradle.

• The first part consists of creating a new package under java folder and selecting then dragging all your source files from the old package to this new package. After that you need to remane the package name in android manifest to the name of the new package.

• In step 2, here is what you need to do.You need to change the old package name in applicationId under the module build.gradle in your android studio in addition to changing the package name in the manifest. So in summary, click on build.gradle which is below the "AndroidManifest.xml" and modify the value of applicationId to your new package name.

• Then, at the very top, under build. clean your project, then rebuild. It should be fine from here.

Change the Package Name

To rename your package name, all you have to do is go to your AndroidManifest.xml file, put your mouse cursor in front of the part of the package name you want to change.

Right-Click > Refactor > Rename

In the new window press Rename package

Change name and press Refactor

…and press Do Refactor at the bottom.

Your package name usually is in format com.domain.appname, in this example we changed the appname part, but you can do the same steps for the domain too.

Done! You changed your package name!

1. Open the file:

   app ? manifests ? AndroidManifest.xml

   

   Highlight each part in the package name that you want to modify (don't highlight entire package name) then:

   • Mouse right click ? Refactor ? Rename ? Rename package
   • type the new name and press (Refactor)

   Do these steps in each part of the package name.

   

2. Open (Gradle Script) >> (build.gradle(Modul:app))

   and update the applicationId to your package name

   

3. Open the menu (build) and choose (Rebuild Project).

ctrl + Shift + R has always worked for me. Simply replace all and choose All Files.

3 Methods to change package name in Android Studio

I think this is a new one. I tried it and it's working. If above doesn't work for you. Try this. The site I mentioned above, there are 2 other methods too with image tutorial. I also checked.

First I am going to talk about changing the Package name. In this example, We will change the package name “com.androidride.myapplication” to “info.xyz.yourapplication”.

1. Right Click on the package name you want to change and select Refactor - > Move.
2. A new dialog appears, Choose Move package “com.androidride.myapplication” to another package and click on Ok.
3. A warning dialog appears, click on yes.
4. Enter new package name in the new dialog. But only “info.xyz” leave yourapplication.
5. Now you will see a warning dialog says Package info.xyz does not exist. Do you want to create it? click on yes.
6. Click on “Do Refactor”. Now your package name changed to info.xyz.myapplication.
7. Right click on info.xyz.myapplication and Refactor -> Rename.
8. Click on Rename package.
9. Rename dialog: change myapplication to yourapplication.
10. Click on Do refactor.
11. Delete old package name directories and change application id in build.gradle, change it into info.xyz.yourapplication.
12. That's all.

Right click on package -> refactor and change the name.

You can also change it in the manifest. Sometimes if you change the package name, but after creating the .apk file it shows a different package name. At that time check "applicationId" in the build.gradle file.

1. Goto your AndroidManifest.xml file.

2. Place your cursor in the package name like shown below. Don't select it, just place it.

   

3. Then press Shift + F6 you will get a popup window as shown below select Rename package.

   

4. Enter your new name and select Refactor. (Note since my cursor is on "something", only something is renamed.)

That's it done.

Create a new package in the java directory and move your project into that package. Like your current project id is com.testapp.user and you want to change it xyz.testapp.user. Then create a package in src/java directory named xyz and move your child package testapp.user into xyz. It works for me. Finally, update build.gradle and manifest project id.

After you follow one of these techniques to get your package renamed, you might start seeing errors.

If / when your R.java is not getting generated properly, you'll get a lot of errors in your project saying error: cannot find symbol class R and also error: package R does not exist.

Remember to check your Application manifest xml. The manifest package name must match the actual package name. It seems the R.java is generated from the Application Manifest and can cause these errors if there's a mismatch.

Remember to check the package attribute matches in your <manifest package="com.yourcompany.coolapp">

for example if you want change package from com.example.a to com.example.b

1)change project style folder from android to package (in project side)

2)right click top of folder and click replace in path

3)select in project button

4)in first input write com.example.a

5)in second input write com.example.b

6)when you see warning select replace all to replace value

after finish replace you can see your package name is com.example.b

I found another way that works or an extra step to some of the answers here especially if you want to change the domain as well. It works in Android Studio 1.4. This is what I did:

1. Open Manifest.xml and change the package name to what you want.
2. Open your app build.gradle file and change the Application Id in defaultConfig to the same name as in manifest and rebuild the project.
3. If still an issue, open a file under the package name, go to the package breadcrumbs (i.e. package declaration at head of file) and set your cursor to the domain you want to change and hit "Shift + F6", it would come out with a dialog with multiple use warnings, click on "Rename packages" and then click on "Do Refactor" it should rename everything including the R.Java files.

So for example if you want to rename "com.example.app" to "com.YourDomain.app", open a file under the package to be renamed, in the package breadcrumbs, set your cursor to "example" part of the domain and hit Shift + F6 and rename package to "YourDomain".