Package name — это уникальный идентификатор приложения Android, который выглядит как com.company.appname и навсегда закрепляется за приложением при первой публикации в Google Play Console. Именно по нему система Android отличает одно приложение от другого, а магазин формирует URL страницы приложения. Если вы видите в консоли ошибку вида «приложение с таким именем пакета уже существует» или не можете загрузить обновление — проблема почти наверняка связана именно с package name.
Разработчики часто путают имя пакета с названием приложения, которое видит пользователь. Это разные сущности: название можно менять сколько угодно раз, а package name после публикации изменить нельзя — только создать новое приложение с другим идентификатором. Поэтому выбор имени пакета — одно из немногих решений в разработке под Android, которое нельзя откатить.
Что такое package name и зачем он нужен
Имя пакета задаётся в файле сборки проекта: в build.gradle модуля приложения оно указывается как applicationId. Исторически оно также прописывалось в атрибуте package манифеста AndroidManifest.xml, но в современных версиях Gradle основным источником является именно applicationId.
Идентификатор используется сразу в нескольких местах:
- 📦 Установка и обновления. Android считает приложения с одинаковым package name одной и той же программой — обновление возможно только при совпадении идентификатора и подписи.
- 🔗 Ссылка в магазине. URL страницы выглядит как
play.google.com/store/apps/details?id=com.company.appname. - 🔑 API и сервисы. Google Sign-In, Firebase, лицензирование и другие сервисы привязываются к паре «имя пакета + сертификат подписи».
- 🗂 Данные приложения. Система выделяет приложению каталог вида
/data/data/имя.пакета/.
Традиционно имя пакета строится по принципу перевёрнутого домена: если у вас есть домен example.com, пакет называют com.example.myapp. Это не жёсткое требование, а соглашение, которое помогает избежать коллизий с чужими приложениями.
Чем package name отличается от названия приложения
Название приложения — это маркетинговый ярлык, который пользователь видит на иконке и в магазине. Его можно отредактировать в любой момент через Google Play Console, и это не затронет ни установленные копии, ни обновления. Имя пакета — технический идентификатор, который пользователь обычно вообще не видит.
| Параметр | Package name | Название приложения |
|---|---|---|
| Где задаётся | applicationId в build.gradle | Google Play Console, ресурсы приложения |
| Можно изменить после публикации | Нет | Да |
| Кто видит | Разработчики, система Android | Пользователи |
| Уникальность | Уникален в пределах магазина и устройства | Может совпадать у разных приложений |
| Формат | Строгий: строчные буквы, точки, без пробелов | Произвольный текст |
Отсюда практический вывод: если вам нужно «переименовать» приложение для пользователей, трогать package name не нужно — достаточно поменять отображаемое название в консоли и ресурсах.
Правила формирования имени пакета
Формат package name унаследован из соглашений об именовании пакетов Java. Имя состоит из сегментов, разделённых точками, и подчиняется ряду ограничений.
- ✅ Допустимы строчные латинские буквы, цифры и символ подчёркивания.
- ✅ Каждый сегмент должен начинаться с буквы, а не с цифры.
- ✅ Имя должно содержать минимум одну точку, то есть как минимум два сегмента.
- 🚫 Нельзя использовать пробелы, дефисы, заглавные буквы и зарезервированные слова Java в качестве отдельных сегментов.
Примеры корректных имён: com.example.reader, org.mycompany.photoeditor, ru.developer.notes. Примеры некорректных: MyApp, com.my-app.tool, 123.app.test.
⚠️ Внимание: не используйте в package name чужие домены и бренды (например, com.google.*). Помимо очевидных юридических рисков, это может привести к отклонению приложения модерацией Google Play.
Как узнать package name приложения
Способ зависит от того, чьё приложение вас интересует — своё или чужое, установленное на устройстве.
Своё приложение. Откройте файл build.gradle (уровень модуля app) и найдите строку:
android {
defaultConfig {
applicationId "com.example.myapp"
}
}
Если приложение уже опубликовано, имя пакета видно прямо в Google Play Console: оно отображается в списке приложений и в адресной строке браузера при открытии страницы приложения в консоли.
Чужое приложение. Самый простой способ — открыть страницу приложения в Google Play в браузере и посмотреть на параметр id в URL. Всё, что идёт после id=, и есть package name.
Для приложения, уже установленного на устройстве, можно воспользоваться ADB с компьютера:
adb shell pm list packagesКоманда выведет список пакетов всех установленных приложений. Чтобы отфильтровать по фрагменту имени, добавьте его в конец команды, например adb shell pm list packages maps. Использование ADB требует включённой отладки по USB в настройках разработчика — если вы с этим не знакомы, проще ограничиться способом через URL магазина.
Как выбрать и задать имя пакета при создании приложения
При создании нового проекта в Android Studio мастер предложит указать package name — то, что вы введёте на этом шаге, станет основой для applicationId. Поменять его до публикации можно свободно: отредактируйте значение в build.gradle и выполните синхронизацию проекта.
При выборе имени придерживайтесь простой логики:
☑️ Проверка package name перед публикацией
Отдельный нюанс — ребрендинг. Так как пакет изменить нельзя, не стоит «зашивать» в него временное маркетинговое название. Нейтральный идентификатор вида com.yourcompany.product переживёт смену отображаемого названия безболезненно.
Ошибка «имя пакета уже используется» и другие конфликты
Типичная ситуация: при загрузке APK или AAB в Google Play Console появляется сообщение, что приложение с таким именем пакета уже существует. Возможных причин несколько.
Первая — пакет действительно занят другим разработчиком. Имена пакетов уникальны в рамках магазина, и если кто-то опубликовал приложение с таким же идентификатором раньше, вам придётся выбрать другой. Вторая причина — вы ранее сами публиковали приложение с этим именем, возможно, с другого аккаунта или удалили его. Удалённое из каталога приложение не освобождает package name: идентификатор остаётся зарезервированным.
⚠️ Внимание: если вы удалили приложение из Google Play и хотите опубликовать его заново, используйте тот же package name и тот же ключ подписи в существующей записи приложения. Создать «чистую» страницу с тем же пакетом, но другой подписью, не получится.
Ещё одна частая ошибка при обновлении — несовпадение подписи. Сообщение вида «APK подписан другим сертификатом» означает, что package name совпадает, а ключ — нет. Здесь поможет только сборка релиза исходным keystore или использование функции Play App Signing, если она была подключена.
Что делать, если ключ подписи утерян
Если приложение было подключено к Play App Signing, Google хранит ключ подписи релиза, а вы можете сбросить свой upload key через поддержку Play Console. Если приложение подписывалось только локальным ключом и он утерян безвозвратно, обновлять существующее приложение невозможно — останется публиковать заново под новым package name, потеряв накопленные установки и отзывы. Храните keystore в нескольких надёжных резервных копиях.
Можно ли изменить package name после публикации
Короткий ответ — нет. Google Play рассматривает имя пакета как неизменяемый идентификатор на всё время жизни приложения. Это осознанное ограничение: именно оно гарантирует, что обновления приходят именно от того же разработчика, а данные пользователей не попадают в чужие руки.
Если смена идентификатора всё же необходима (например, приложение переходит к другой компании без передачи аккаунта), единственный путь такой:
- 🆕 Соберите приложение с новым package name и опубликуйте его как отдельную запись в консоли.
- 📢 В старом приложении выпустите обновление с уведомлением пользователей о переходе и ссылкой на новую страницу.
- ⏳ Дайте пользователям время на миграцию, прежде чем снимать старую версию с публикации.
Учтите: установки, оценки, отзывы и позиции в поиске магазина на новое приложение не переносятся. Именно поэтому к выбору package name стоит отнестись как к решению, которое принимается один раз и навсегда.
Часто задаваемые вопросы
Где посмотреть package name приложения на телефоне без компьютера?
Откройте страницу приложения в Google Play, нажмите «Поделиться» и скопируйте ссылку — package name содержится в параметре id=. Также идентификатор показывают сторонние утилиты-инспекторы приложений, но для разовой задачи достаточно ссылки из магазина.
Могут ли два приложения иметь одинаковое название, но разные package name?
Да. Отображаемое название не обязано быть уникальным, поэтому в магазине встречаются приложения с одинаковыми именами от разных разработчиков. Уникальным должен быть только package name.
Чем applicationId отличается от package в манифесте?
В современных проектах идентификатором приложения при установке и публикации служит applicationId из build.gradle. Атрибут package в манифесте сейчас используется в основном для определения пространства имён ресурсов и класса R, и в новых версиях инструментов сборки эту роль берёт на себя параметр namespace.
Освободится ли package name, если удалить приложение из Google Play?
Нет. Снятие с публикации или удаление приложения не освобождает имя пакета — оно остаётся зарезервированным за вашим аккаунтом. Передать его другому разработчику можно только вместе с передачей самого приложения через механизм трансфера в Play Console.
Нужно ли владеть доменом, чтобы использовать его в package name?
Формально магазин не проверяет владение доменом, но использование чужого домена — плохая практика: это создаёт риск конфликтов и претензий. Если своего домена нет, допустимо использовать нейтральный префикс, связанный с вашим именем разработчика.