Querer renombrar el nombre del paquete de un proyecto en Android puede deberse a muchos factores, entre los principales serían que se ha decidido colocar otro nombre a la aplicación y muy posiblemente el nombre de la aplicación forme parte del nombre del paquete.
Sin embargo, esto puede ocasionar problemas si no lo realizamos de la forma adecuada y podríamos inutilizar el proyecto en el proceso; realizar el renombramiento de la manera correcta es muy fácil y consta de muy pocos pasos como veremos a continuación.
Enfoque Moderno: Jetpack Compose y Namespace
En el desarrollo moderno con Jetpack Compose, Android Studio ha separado el concepto de Namespace (donde residen tus clases de recursos generadas como R.java) y el Application ID (el identificador único en la Google Play Store).
Si estás usando una estructura moderna, el cambio es mucho más limpio. Ya no es estrictamente necesario que la estructura de carpetas física coincida con el ID de la aplicación, aunque sigue siendo una buena práctica.
Para cambiar el nombre en un proyecto de Compose, simplemente actualiza estos dos campos en tu build.gradle.kts:
android {
// El namespace controla dónde se generan tus archivos R y la vinculación interna
namespace = "net.desarrollolibre.composeapp"
defaultConfig {
// El applicationId es lo que ve el usuario y la Play Store
applicationId = "net.desarrollolibre.composeapp"
versionCode = 1
versionName = "1.0"
}
}Al usar Compose, recuerda que después de cambiar el namespace, deberás actualizar todos los imports de tu clase R en tus archivos Kotlin si estabas llamando a recursos manualmente. Android Studio suele ofrecer una corrección automática (Alt + Enter) para actualizar estos imports en todo el proyecto de una sola vez.
Finalmente, siempre realiza un Clean Project y Rebuild Project desde el menú Build para asegurar que no queden rastros del nombre anterior en la memoria caché del compilador.
Enfoque Legacy: Proyectos basados en XML y Vistas
Renombrando el nombre del paquete en Android Studio (Dolphin y versiones superiores)
Para renombrar el paquete de forma física en el árbol de archivos, nos vamos a nuestro panel de proyecto. Hacemos clic derecho sobre el icono del engranaje y de-seleccionamos la opción Compact Middle Packages (en versiones anteriores llamada Compact Empty Middle Packages):
Ahora podemos cambiar el nombre de los paquetes de manera independiente. Si el nombre del paquete está dividido en varias partes (ejemplo: com.example.app), debemos renombrar cada una de estas partes: clic derecho sobre la carpeta del paquete, Refactor y luego Rename.
Es importante elegir Rename package cuando el IDE lo pregunte para asegurar que todas las referencias en el AndroidManifest.xml y las clases Java/Kotlin se actualicen. Luego presionamos el botón Do Refactor.
Una vez realizado esto, nos vamos al archivo build.gradle.kts (o build.gradle) de nivel de módulo y actualizamos el applicationId:
// build.gradle.kts
android {
defaultConfig {
applicationId = "net.desarrollolibre.nueva.app"
// ...
}
}