Как изменить название iOS-приложения в Xcode?
Я начал проект для iPhone с временным кодовым названием разработки, и теперь, когда проект почти завершен, мне нужно его переименовать. Каковы шаги по изменению названия приложения в Xcode?
Чтобы изменить имя приложения iOS в Xcode, необходимо изменить несколько компонентов, включая отображаемое имя пакета (то, что появляется под значком приложения), имя проекта, настройки цели и идентификатор пакета. Этот процесс включает обновление файла info.plist, настроек проекта и, возможно, ссылок в исходном коде для обеспечения согласованности во всей среде разработки.
Содержание
- Понимание различных типов имен приложений в Xcode
- Пошаговое руководство по изменению имени вашего iOS-приложения
- Изменение отображаемого имени пакета (имени на главном экране)
- Переименование проекта Xcode
- Обновление настроек цели и схемы
- Изменение идентификатора пакета
- Полное переименование проекта (включая файлы и код)
- Распространенные проблемы и устранение неполадок
- Лучшие практики для переименования приложения
Понимание различных типов имен приложений в Xcode
В Xcode есть несколько различных “имен”, связанных с вашим iOS-приложением, которые служат разным целям:
Отображаемое имя пакета (Bundle Display Name) - Это самое важное имя для конечных пользователей, так как это текст, который появляется под значком приложения на главном экране iOS-устройств. Именно это большинство людей считают “именем приложения”.
Имя проекта (Project Name) - Имя самого проекта Xcode, видимое в навигаторе проектов и в файле .xcodeproj.
Имя цели (Target Name) - Конфигурация сборки в Xcode, которая определяет, как ваше приложение компилируется и связывается.
Имя схемы (Scheme Name) - Конфигурация, используемая для сборки, запуска и отладки вашего приложения.
Идентификатор пакета (Bundle Identifier) - Уникальный идентификатор в формате обратного DNS (например, com.yourcompany.appname), который отличает ваше приложение от других в App Store и на устройствах.
Понимание этих различий имеет решающее значение, поскольку полный процесс переименования приложения требует обновления всех этих компонентов для поддержания согласованности и избежания ошибок сборки.
Пошаговое руководство по изменению имени вашего iOS-приложения
Вот комплексный подход к переименованию вашего iOS-приложения в Xcode:
-
Сначала решите, что вы хотите изменить:
- Только отображаемое имя на главном экране?
- Весь проект, включая все файлы и код?
- Или что-то среднее?
-
Начните с отображаемого имени пакета - Это самый безопасный и простой способ изменения.
-
Если вы переименовываете весь проект:
- Закройте Xcode
- Сделайте резервную копию вашего проекта
- Следуйте полному процессу переименования
- Тщательно протестируйте перед фиксацией изменений
-
Протестируйте изменения как в симуляторе, так и на физическом устройстве, прежде чем переходить к более сложному переименованию.
Изменение отображаемого имени пакета (имени на главном экране)
Отображаемое имя пакета - это текст, который появляется под значком вашего приложения на iOS-устройствах. Именно это большинство пользователей считают “именем приложения”.
Шаги для изменения отображаемого имени пакета:
- В навигаторе проектов Xcode выберите файл вашего проекта
- В центральном редакторе выберите цель вашего приложения в разделе “TARGETS”
- Перейдите на вкладку Info
- Найдите Отображаемое имя пакета (Bundle display name) в разделе “Пользовательские свойства целевого объекта iOS”
- Измените значение на желаемое имя вашего приложения
- Альтернативно, вы можете напрямую редактировать файл
Info.plistи изменить ключ “Отображаемое имя пакета”
Важно: Изменение только отображаемого имени пакета не повлияет на структуру вашего проекта или существующие установки. Это самый безопасный способ переименования приложения, если вам нужно изменить только то, что пользователи видят на своих главных экранах.
Согласно Техническому вопросу и ответу QA1823 от Apple, вы должны искать “Отображаемое имя пакета” (Bundle display name) в списке свойств, чтобы найти эту настройку.
Переименование проекта Xcode
Чтобы переименовать сам проект Xcode:
- Выберите ваш проект в навигаторе проектов (верхний элемент синего цвета)
- Откройте Инспектор файлов (View → Utilities → Show File Inspector)
- В разделе Идентификация и тип найдите поле Имя проекта
- Дважды щелкните текущее имя и введите новое имя проекта
- Нажмите Return для подтверждения изменения
- Появится диалоговое окно со списком всех элементов, которые можно переименовать - внимательно просмотрите и нажмите Переименовать
Этот метод, описанный в документации Apple QA1625, является официальным способом переименования вашего проекта Xcode с сохранением правильных ссылок.
Обновление настроек цели и схемы
После переименования вашего проекта вам нужно будет обновить цель и схему:
Имя цели:
- Выберите ваш проект в навигаторе
- Нажмите на цель вашего приложения в разделе “TARGETS”
- Имя цели должно быть доступно для редактирования - дважды щелкните, чтобы переименовать
- Убедитесь, что имя продукта соответствует желаемому имени вашего приложения
Имя схемы:
- Нажмите кнопку схемы (рядом с кнопкой Stop на панели инструментов)
- Выберите Управление схемами…
- Найдите ваше старое имя схемы, щелкните правой кнопкой мыши и выберите Переименовать
- Введите новое имя схемы
- Нажмите Закрыть
Как отмечено на Форуме разработчиков Apple, эти шаги необходимы для правильной работы конфигураций сборки после переименования.
Изменение идентификатора пакета
Идентификатор пакета важен для распространения и обновлений приложения:
- Выберите ваш проект и цель
- Перейдите на вкладку General
- Найдите Идентификатор пакета (Bundle Identifier) в разделе “Identity”
- Обновите его в соответствии с форматом обратного DNS (например,
com.yourcompany.newappname)
Предупреждение: Если ваше приложение уже в App Store или установлено на устройствах, изменение идентификатора пакета создаст совершенно отдельное приложение. Пользователям потребуется отдельно скачать новую версию.
Согласно уроку Джона Кодеоса, будьте очень осторожны с изменениями идентификатора пакета в производственных средах.
Полное переименование проекта (включая файлы и код)
Для полного переименования проекта, включая все файлы и ссылки в коде:
- Закройте Xcode и создайте резервную копию проекта
- Переименуйте основной файл проекта (.xcodeproj) в Finder
- Откройте проект в Xcode и переименуйте его с помощью метода Инспектора файлов
- Обновите все ссылки на файлы:
- Проверьте вкладку Build Phases на наличие ссылок на старые имена
- Обновите Podfile, если вы используете CocoaPods
- Проверьте Info.plist на наличие жестко закодированных путей или имен
- Рефакторинг ссылок в коде:
- Щелкните правой кнопкой мыши по именам классов/структур и используйте Refactor → Rename
- Обновите все storyboard или xib файлы, ссылающиеся на старые имена
- Очистите и пересоберите ваш проект (Product → Clean Build Folder)
Для более систематического подхода Create with Swift рекомендует использовать встроенные инструменты рефакторинга Xcode для обеспечения последовательного обновления всех ссылок в коде.
Распространенные проблемы и устранение неполадок
Ошибки сборки после переименования:
- Очистите папку сборки (Product → Clean Build Folder)
- Проверьте наличие отсутствующих ссылок на файлы в Build Phases
- Убедитесь, что все соединения в storyboard/xib остаются корректными
Проблемы при отправке в App Store:
- Идентификатор пакета должен соответствовать тому, что зарегистрировано в App Store Connect
- Отображаемое имя должно соответствовать Руководству по обзору App Store
- Тщательно протестируйте на разных размерах устройств и ориентациях
Проблемы с установкой на устройствах:
- При изменении идентификатора пакета пользователи увидят его как отдельное приложение
- Рассмотрите возможность использования функции переноса приложения в App Store для опубликованных приложений
Согласно обсуждениям на Stack Overflow, многие разработчики сталкиваются с проблемами, когда не обновляют все необходимые компоненты последовательно.
Лучшие практики для переименования приложения
Перед переименованием:
- Создайте полную резервную копию проекта
- Убедитесь, что ваше приложение собирается и запускается успешно
- Проверьте наличие внешних зависимостей или интеграций
Во время переименования:
- Обновляйте все компоненты систематически (не пропускайте шаги)
- Используйте инструменты рефакторинга Xcode для изменений в коде
- Проверяйте каждое изменение перед переходом к следующему
После переименования:
- Тщательно протестируйте на нескольких устройствах и версиях iOS
- Обновите документацию и файлы README
- Согласуйте действия с членами команды, если работаете в группе
Производственные соображения:
- Если ваше приложение уже опубликовано, ознакомьтесь с руководящими принципами Apple по изменению имен приложений
- Учитывайте влияние на существующих пользователей и отзывы
- Планируйте правильную миграцию при изменении идентификатора пакета
Как подчеркивает руководство Repeato, систематическое тестирование после каждого шага переименования имеет решающее значение для предотвращения разочаровывающих ошибок сборки и проблем времени выполнения.
Источники
- Как изменить имя iOS-приложения в Xcode? - Stack Overflow
- Технический вопрос и ответ QA1625: Как переименовать мое приложение в Xcode? - Apple Developer
- Технический вопрос и ответ QA1823: Обновление отображаемого имени вашего приложения - Apple Developer
- Как изменить имя iOS-приложения в Xcode - Repeato
- Безопасное переименование вашего проекта Xcode - Create with Swift
- Как изменить имя проекта и идентификатор пакета в Xcode - John Codeos
- Как изменить имя приложения? - Форум разработчиков Apple
- Полное руководство по переименованию iOS-приложения - Photone
- Как переименовать проект Xcode (включая все файлы и папки) - GitHub
- iphone - Как изменить имя проекта Xcode - Stack Overflow
Заключение
Переименование iOS-приложения в Xcode требует тщательного внимания к нескольким компонентам, но это управляемый процесс, если подходить к нему систематически. Начните с отображаемого имени пакета, если вам нужно изменить только то, что пользователи видят на своих главных экранах, или следуйте полному процессу переименования для полной переработки проекта. Помните, что создание резервных копий перед внесением изменений, тщательное тестирование после каждого модификации и особое внимание к идентификатору пакета, если ваше приложение уже опубликовано или установлено на устройствах.
Для большинства разработчиков ключевые шаги - это обновление отображаемого имени пакета в настройках цели, переименование проекта через Инспектор файлов и обновление имени схемы. Тщательное следование этим шагам гарантирует, что ваше приложение сохранит свою функциональность, но при этом будет иметь новое имя на всех платформах и устройствах.