Подпись приложений для iOS: от сертификатов до публикации в App Store

Без правильной подписи ваше iOS-приложение не запустится даже на тестовом устройстве — система заблокирует его с ошибкой Failed to verify code signature или App installation failed. Процесс подписи связывает бинарный файл (.ipa) с уникальным идентификатором разработчика (Developer ID), сертификатами и профилями provisioning, которые Apple проверяет при установке. Если вы видите в Xcode предупреждение No signing certificate found или в Organizer красной строкой подсвечивается Missing Provisioning Profile, значит, на одном из этапов подписи произошла ошибка — чаще всего из-за неверно сгенерированного сертификата или несоответствия Bundle ID.

Подпись для iOS отличается от Android тем, что требует обязательной привязки к Apple Developer Account (стоимость — $99/год) и проходит через строгий контроль компании. Даже для тестирования на физическом устройстве (Ad Hoc или Development) нужен действующий сертификат, а для публикации в App Store — отдельный Distribution Certificate и профиль App Store Provisioning Profile. В этой статье разберём все этапы: от генерации сертификатов в Keychain Access до загрузки подписанного .ipa через Transporter или Xcode Organizer.

1. Типы подписи iOS-приложений: когда какой использовать

Apple предлагает четыре основных способа подписи, каждый из которых предназначен для конкретной задачи. Выбор неправильного типа — одна из главных причин ошибок при установке или публикации.

• 🔧 Development — для отладки на подключённых устройствах через Xcode. Требует Development Certificate и профиль с указанием UDID устройств. Срок действия — 1 год.
• 📱 Ad Hoc — для тестирования на ограниченном числе устройств (до 100) без App Store. Использует Distribution Certificate, но профиль привязан к конкретным UDID.
• 🌍 App Store — для публикации в магазине. Подпись проходит через Apple’s servers при загрузке .ipa. Требует Distribution Certificate и профиль без привязки к устройствам.
• 🏢 Enterprise — для внутреннего распространения в компаниях (через MDM или прямую установку). Сертификат стоит $299/год и позволяет обходить App Store.

Например, если вы пытаетесь загрузить приложение в TestFlight с профилем Ad Hoc, получите ошибку Invalid Provisioning Profile. А при использовании Development Certificate для архивации в Xcode с целью публикации в App Store — предупреждение No suitable application records were found.

2. Шаг 1: Создание сертификатов в Apple Developer Account

Сертификаты — основа подписи. Они подтверждают, что приложение создано доверенным разработчиком. Без действующего сертификата Xcode не сможет скомпилировать проект для устройства.

1. Генерация CSR-файла
   

   Откройте Keychain Access на Mac → Certificate Assistant → Request a Certificate from a Certificate Authority. Укажите email (должен совпадать с Apple ID) и сохраните .certSigningRequest файл.

2. Загрузка CSR в Developer Account
   

   Перейдите в Apple Developer Account → Certificates, Identifiers & Profiles → Certificates → нажмите +. Выберите тип сертификата (Apple Development или Apple Distribution) и загрузите .certSigningRequest.

3. Установка сертификата
   

   После генерации скачайте .cer-файл и дважды кликните для установки в Keychain Access. Проверьте, что сертификат отображается в разделе My Certificates.

Ошибка No valid signing identities found в Xcode означает, что сертификат не установлен или просрочен. Чтобы исправить, удалите старый сертификат из Keychain и повторите процедуру. Срок действия сертификатов — 1 год, после чего их нужно обновлять.

Сертификат отображается в Keychain Access|Срок действия не истёк (проверьте в "Get Info")|Email в CSR совпадает с Apple ID|Тип сертификата соответствует цели (Development/Distribution)-->

3. Шаг 2: Регистрация App ID и настройка Bundle ID

App ID (или Bundle ID) — уникальный идентификатор приложения в экосистеме Apple. Он должен совпадать в трех местах: в Xcode (поле Bundle Identifier в Info.plist), в Developer Account и в профиле provisioning. Расхождение приведёт к ошибке Bundle Identifier does not match.

• 📝 Формат Bundle ID: обычно используется обратная DNS-запись, например com.yourcompany.appname. Изменить его после публикации в App Store нельзя.
• 🔗 Wildcard App ID: можно использовать (например, com.yourcompany.) для тестирования, но для App Store требуется явный Bundle ID.
• 🔄 Explicit App ID: нужен для Push-уведомлений, Game Center и других сервисов Apple. Регистрируется вручную в Developer Account.

Чтобы зарегистрировать App ID:

1. Перейдите в Identifiers → нажмите + → выберите App IDs.
2. Укажите описание (например, "MyApp Production") и Bundle ID (explicit или wildcard).
3. Выберите нужные App Services (например, Push Notifications) и сохраните.

4. Шаг 3: Создание Provisioning Profile

Профиль provisioning связывает сертификаты, App ID и устройства (для Development/Ad Hoc). Без него Xcode не сможет подписать приложение. Ошибка Provisioning profile 'X' doesn't include the currently selected device означает, что UDID устройства не добавлен в профиль.

Чтобы создать профиль:

1. В Developer Account перейдите в Profiles → нажмите +.
2. Выберите тип профиля (App Store, Ad Hoc и т.д.).
3. Укажите App ID, сертификаты и устройства (для Development/Ad Hoc).
4. Скачайте профиль (.mobileprovision) и перетащите его в Xcode или установите через двойной клик.

5. Шаг 4: Настройка подписи в Xcode

После подготовки сертификатов и профилей нужно привязать их к проекту в Xcode. Если конфигурация неверна, при архивации появится ошибка No profiles for 'com.your.bundle' were found.

Инструкция:

1. Откройте проект в Xcode → выберите цель (Target) → вкладка Signing & Capabilities.
2. В поле Team выберите ваш Apple Developer Account.
3. В Bundle Identifier укажите зарегистрированный App ID.
4. В разделе Signing Certificate выберите Automatically manage signing (рекомендуется) или вручную укажите профиль (Provisioning Profile).

Если Xcode не видит профили, обновите их через Preferences → Accounts → выберите аккаунт → Download All Profiles. Для ручной подписи используйте команду в Terminal:

security find-identity -v -p codesigning

Эта команда покажет все установленные сертификаты. Если список пуст — сертификаты не установлены.

6. Шаг 5: Архивация и экспорт приложения

После успешной настройки подписи можно архивировать проект для распространения. В зависимости от цели выберите один из форматов экспорта:

• 📦 Development — для отладки на устройствах через Xcode (не создаёт .ipa).
• 📱 Ad Hoc — генерирует .ipa для установки на зарегистрированные устройства (например, через TestFlight или Diawi).
• 🌍 App Store — создаёт .ipa для загрузки в App Store Connect.
• 🏢 Enterprise — для внутреннего распространения (требует Enterprise Account).

Чтобы архивировать проект:

1. В Xcode выберите схему (Scheme) → Generic iOS Device.
2. Нажмите Product → Archive. Если появится ошибка No signing certificate found, вернитесь к шагу 4.
3. После архивации откройте Organizer → выберите архив → Distribute App.
4. Укажите метод распространения (App Store Connect, Ad Hoc и т.д.) и следуйте инструкциям.

Для загрузки в App Store используйте Transporter (утилита от Apple) или загрузите .ipa через App Store Connect. Перед отправкой проверьте подпись командой:

codesign -dv --verbose=4 /путь/к/вашему.app

В выводе должен быть ваш Team Identifier и статус valid on disk.

7. Распространённые ошибки подписи и их решения

Даже опытные разработчики сталкиваются с проблемами подписи. Вот самые частотные ошибки и способы их исправления:

Критическая ошибка: если вы видите errSecInternalComponent при попытке подписать приложение, это означает системный сбой в Keychain Access. Решение:

1. Удалите все сертификаты и профили из Keychain и Xcode.
2. Перезагрузите Mac.
3. Повторно установите сертификаты и профили.

codesign -d --entitlements - /путь/к/вашему.app

8. Альтернативные способы подписи: без Mac и Xcode

Если у вас нет доступа к Mac или Xcode, можно подписать приложение альтернативными методами, но с ограничениями:

• 🖥️ Online-сервисы (например, AppCenter, Bitrise): позволяют собирать и подписывать проекты в облаке, но требуют загрузки исходников и конфигурации сертификатов.
• 🐍 Fastlane: инструмент для автоматизации (включает gym для сборки и pilot для загрузки в TestFlight). Требует предварительной настройки fastlane и Ruby.
• 📦 Ручная подпись через командную строку:

  xcrun altool --upload-app -f app.ipa -u apple_id -p password

  (устарело с 2020 года, заменено на notarytool для нотаризации).

Для нотаризации приложений (обязательно с macOS Catalina и новее) используйте:

xcrun notarytool submit app.zip --apple-id apple_id --password app-specific-password --team-id TEAM_ID

FAQ: Частые вопросы о подписи iOS-приложений

Если после прочтения статьи остались вопросы по конкретной ошибке подписи — уточните текст ошибки из Xcode или Terminal, а также версию macOS и Xcode. Это поможет точнее диагностировать проблему.