1545
votes

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.

30
Please see my answer here. I have successfully managed to rename my project using the steps I have described.Leigh
possible duplicate of Change project name on Android StudioLeigh
Step by Step Process for Changing Package name... stackoverflow.com/a/46945668/6915572Shubhamhackz
The answer by Sheharyar works as expected. i.e 1. Refactor 2. Edit build.gradle. However, you will have to follow it up by changing the app_name attribute in strings.xml file too!Suhas Mallya

30 Answers

3229
votes

In Android Studio, you can do this:

For example, if you want to change com.example.app to my.awesome.game, then:

  1. In your Project pane, click on the little gear icon ( Gears icon )

  2. Uncheck the Compact Empty Middle Packages option

    Compact Empty Middle Packages

  3. Your package directory will now be broken up into individual directories

  4. Individually select each directory you want to rename, and:

  • Right-click it

  • Select Refactor

  • Click on Rename

  • In the pop-up dialog, click on Rename Package instead of Rename Directory

  • Enter the new name and hit Refactor

  • Click Do Refactor in the bottom

  • Allow a minute to let Android Studio update all changes

  • Note: When renaming com in Android Studio, it might give a warning. In such case, select Rename All

    Enter image description here

  1. Now open your Gradle Build File (build.gradle - Usually app or mobile). Update the applicationId in the defaultConfig to your new Package Name and Sync Gradle, if it hasn't already been updated automatically:

    Refactor Directories

  2. You may need to change the package= attribute in your manifest.

  3. Clean and Rebuild.

    Clean and Rebuild

  4. Done! Anyway, Android Studio needs to make this process a little simpler.

592
votes

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

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.

215
votes

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

89
votes

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

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

enter image description here

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

enter image description here

Step 3 : Enter your new package name

enter image description here

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

enter image description here

Step 5 :Rename the package name in the manifest file

enter image description here

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

enter image description here

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

enter image description here

Step 8 :Then Rebuild your project

enter image description here

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 your new package name in replace box, then press find

enter image description here

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

enter image description here

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

62
votes
  1. Go to your AndroidManifest.xml file.

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

    Enter image description here

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

    Enter image description here

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

That's it done.

45
votes

Right-click on the package at the Project Panel.

Choose Refactor -> Rename from the context menu.

29
votes
  1. Open the file:

    app → manifests → AndroidManifest.xml

    Enter image description here

    Highlight each part in the package name that you want to modify (don't highlight the 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.

    Enter image description here

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

    and update the applicationId to your package name

    Enter image description here

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

19
votes

Change the Package Name


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


enter image description here


Right-Click > Refactor > Rename


enter image description here


In the new window press Rename package


enter image description here


Change name and press Refactor


enter image description here


…and press Do Refactor at the bottom.


enter image description here


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 have changed your package name!

17
votes

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 ( Gears icon ) and then select the option: "Compact Empty Middle Packages", to see the folders separated in a tree view.

introducir la descripción de la imagen aquí

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

introducir la descripción de la imagen aquí

You will be advised to refactor the package:

introducir la descripción de la imagen aquí

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

introducir la descripción de la imagen aquí

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

16
votes

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?

16
votes

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

9
votes

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.
7
votes

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.

6
votes

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.

enter image description here

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

enter image description here

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:

enter image description here

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.

6
votes

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.

5
votes

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...

5
votes

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".

5
votes
  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.

4
votes

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.

4
votes

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.

4
votes

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

4
votes

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.

4
votes

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.

4
votes

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 the package name

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

If you just need to change the last part of the 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.

4
votes
  • The first part consists of creating a new package under the java folder and selecting then dragging all your source files from the old package to this new package. After that, you need to rename 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.

4
votes

I recommend to use 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:)

Screenshot

3
votes

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.

3
votes
  1. Select option enter image description here

  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 enter image description here

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

  8. After Changes done enter image description here

3
votes
  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

3
votes

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