Распространение App Store и TestFlight

Это важно

Центр приложений Visual Studio был прекращен 31 марта 2025 г., за исключением функций аналитики и диагностики, которые будут поддерживаться до 30 июня 2026 г. Подробнее.

Публикация обновлений приложений iOS в App Store и TestFlight с помощью Fastlane в Центре приложений.

Предпосылки

• Первая версия приложения iOS должна быть опубликована на портале App Store Connect.
• Скомпилируйте приложение с помощью профиля распределения App Store и сертификата производства.
• Приложение должно быть готово к отправке и удовлетворять требованиям App Store.
• Активная учетная запись в программе разработчика Apple или добавление вашего идентификатора Apple ID в качестве администратора в учетную запись App Store Connect вашей команды.
• Подключенная учетная запись должна иметь разрешения диспетчера приложений для публикации приложения.

Дополнительные сведения см. в руководстве по распространению приложений Apple.

Настройка подключения между Центром приложений и App Store Connect

Замечание

Вы можете подключиться к App Store Connect с помощью учетных данных Apple или ключа API App Store Connect. Мы рекомендуем использовать ключ API Connect для повышения стабильности и настроить уровни доступа для ключей на портале разработчика Apple. Кроме того, вам больше не придется обновлять подключение каждые 30 дней, так как вы будете использовать учетные данные, 2FA и определенные пароли приложений.

1. Выберите "Магазины " в разделе "Распространение".

2. В середине страницы нажмите кнопку "Подключиться к магазину ".

3. Выберите тип магазина как App Store Connect на открываемой панели.

4. Нажмите кнопку "Далее" в правом нижнем углу.

5. Войдите с помощью ключа API Подключения к App Store или с помощью учетной записи разработчика Apple (однократное действие) и нажмите кнопку "Подключить".

6. При успешном входе в систему, если учетная запись Apple входит в состав нескольких команд, будет доступна возможность выбрать команду для связывания сборок. Если учетная запись Apple является участником только одной команды, то выбор автоматически падает на единственный доступный вариант.

7. Теперь список приложений для выбранной команды будет доступен для выбора.

8. Выберите приложение для обновления.

9. Автоматическая настройка и сохранение подключений для выбранного приложения будут выполнены автоматически.

   • Подключение App Store с именем Production.
   • Подключение TestFlight для внутренних тестировщиков под названием App Store Connect Users.
   • Внешний тестировщик группирует подключения на основе внешних групп, созданных в консоли App Store Connect.

10. Настройка этого подключения — это однократный процесс для приложения в App Center.

Выбор назначения в раскрывающемся меню для инструкций по отправке

• App Store
• Внутренние тестировщики TestFlight
• Внешние тестировщики TestFlight

Замечание

При отправке файла доставки в App Store Connect центр приложений по умолчанию использует следующие значения:

 add_id_info_uses_idfa: false
 export_compliance_uses_encryption: false
 export_compliance_encryption_updated: false

Добавление двухфакторной проверки подлинности

Если у вашей учетной записи Apple включена двухфакторная проверка подлинности, App Store Connect требует пароль для конкретного приложения в качестве безопасности. Вы можете добавить пароль для конкретного приложения в параметрах учетной записи > учетные записи разработчика.

Подсказка

Только App Store и TestFlight требуют пароля для конкретного приложения. Только идентификаторы Apple с поддержкой двухфакторной проверки подлинности могут выбрать пароль для конкретного приложения.

1. Наведите указатель мыши на элемент в списке учетных записей .
2. Щелкните три вертикальные точки в правой части списка
3. Выберите "Обновить пароль для конкретного приложения".
4. Создайте пароль для конкретного приложения с помощью портала Apple ID.
   • Имя предназначено для запоминания того, какая служба или приложение использует пароль для конкретного приложения.
5. Скопируйте созданный пароль для конкретного приложения и вставьте его в диалог.
6. Сохраните, нажав кнопку "Обновить".

Публикация с помощью интерфейса командной строки

Предупреждение

Для использования этой функции вам потребуется App Center CLI версии 2.7 или более новой.

Используйте CLI в качестве простого способа интеграции подключения к хранилищу Центра приложений в рамках настройки CI/CD, например Jenkins или Go CI.

Прежде чем использовать интерфейс командной строки, необходимо установить подключение к App Store и скомпилировать совместимый двоичный файл.

Вы можете вывести список магазинов с помощью команды списка следующим образом:

appcenter distribute stores list \
--app {app_owner}/{app_name} \
--output json

Вы получите результат следующим образом:

[["Production","apple","production"],["App Store Connect Users","apple","testflight-internal"]]

И это столбец Store, который мы будем использовать на последнем шаге.

Последний шаг — опубликовать приложение, выполнив следующую команду:

appcenter distribute stores publish \
--file /path/to/file.ipa \
--store Production \
--app {app_owner}/{app_name} \
--release-notes "Some note."

Вам потребуется заполнить пустые поля, как если бы вы использовали команду списка. Вместо того чтобы иметь статическую заметку о выпуске, можно использовать --release-notes-file вместо этого. Файл заметки о выпуске — это обычный текстовый файл, закодированный с помощью UTF-8.

Почему для Apple ID требуется роль администратора

Apple требует по крайней мере роль администратора для создания приложений, отправки версий и загрузки сборок. См. эту таблицу, которая уточняет разрешения.

Отладка неудачного релиза

При сбое публикации выпуска можно скачать детализированные журналы Fastlane. Эти журналы можно найти на подробной странице выпуска, кликнув по тексту Состояние> Загрузить журналы Fastlane.

Сбой повторной проверки подлинности

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