Вводная часть

Этот пост для тех, кто также как и я ничего не понимает в настройке ci/cd, но хочет подключить Azure к App Center.

Небольшое отступление

В компании, где я работаю, есть мобильное приложение, написанное на React Native и весь деплой работает напрямую в App Center, но так как App Center не поддерживает Flutter, то остается вариант деплоить android и ios приложения по отдельности.
Все процессы в компании завязаны на azure и было необходимо для сборки приложений и деплоя использовать именно его.

Настройка окружения

Первым делом займемся настройкой наших приложений.

Android

Никаких дополнительных настроек не требуется

IOS

В папке ios вашего проекта необходимо создать файл exportOptions.plist. Здесь мы зададим настройки для экспорта нашего приложения, а главное установим профили.
Вот как должен выглядеть файл

<?xml version="1.0" encoding="UTF-8"?>  
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">  
<plist version="1.0">  
<dict>  
    <key>destination</key>  
    <string>export</string>  
    <key>manageAppVersionAndBuildNumber</key>  
    <true/>  
    <key>method</key>  
    <string>app-store</string>  
    <key>provisioningProfiles</key>  
    <dict>  
        <key>*ru.someName</key>  
        <string>*name provisioning profile*</string>  
        <key>*ru.someNameForNotifications*</key>  
        <string>*name provisioning profile for notifications</string>  
    </dict>  
    <key>signingCertificate</key>  
    <string>Apple Distribution</string>  
    <key>signingStyle</key>  
    <string>manual</string>
    <key>stripSwiftSymbols</key>  
    <true/>  
    <key>teamID</key>  
    <string>*Ваш id*</string>  
    <key>uploadBitcode</key>  
    <false/>  
    <key>uploadSymbols</key>  
    <false/>  
</dict>  
</plist>

Обратите внимание на provisioningProfiles и teamID

provisioningProfiles — это профили, которые вам надо создать на сайте apple. Далее необходимо в key указать Bundle Identifier, а в string имя в строке provisioning profile.
teamID — это id сертификата, его можно увидеть, либо на сайте apple, либо в xcode на вкладке Signing & Capabilities
Profiles
На данном этапе нам необходимо установить профили в xcode.
Для этого вам необходимо открыть xcode перейти в targets/Signing & Capabilities* (предполагается, что профили и сертификат у вас уже есть)
Убрать галочку с автоматической подписи и установить ее вручную. Без этого действия этап установки сертификата в пайплайне просто не мог обнаружить нужный сертификат. А так нужный сертификат автоматически подтягивается при выборе нужного профиля.
Проделайте данную операцию для всех таргетов*( У каждого таргета должен быть свой профайл).

Pipeline

На данном этапе мы создадим пайплайн для сборки наших приложений.

Создаем новый pipeline
Нажимаем на последнюю ссылку
Выбираем Azure Repose Git
Скачиваем плагин Flutter — Visual Studio Marketplace

Android

Так в конечном счете будет выглядеть стек задач для android.

А теперь чуть подробнее про каждую задачу.

Добавляем задачи в pipeline —

Flutter install
- оставляем дефолтные настройки
Flutter Build apk
- Это все стандартные настройки, но все же продублирую
  - Target platform — Android (apk)
  - Path to the project folder — .(ставим точку)
  - Build Flavour — prod
    - Опционально. У меня в проекте используются flavor, так уже если его у вас нет, то можете пропустить этот шаг.
Signing and aligning APK file(s) **/*.apk — Подписка сертификата
- APK files — **/*.apk
- Sign the APK — true
- Keystore file — Здесь вам нужно загрузить ваш сертификат. Дальше идут пункты, касательно этого файла.
  - Keystore password, Alias, Key password — указываете в соответсвии с сертификатом
- apksigner arguments — --verbose
Tag Build
- Type — Build
- Tags — android
Copy Publish Artifact: artifact
- Contents — **/*.apk
- Artifact Name — APK
- Artifact Type — Server

IOS

В том же пайплайне добавляем еще один блок задач(Agent job). Так он будет выглядеть когда мы закончим.

Flutter Install — аналогично с android
Install an Apple provisioning profile — для каждого профиля вам необходимо добавить по одной задаче.
- Provisioning profile location — Secure Files
- Provisioning profile — Указываете сам профайл(его нужно загрузить по клику на шестеренку)
Install an Apple certificate
- Certificate (P12) — по клику на шестеренку загружаете ваш сертификат
- Certificate (P12) password — очевидно, что здесь вам надо вписать пароль от сертификата
- Keychain — должен быть выбран Temporary Keychain
Flutter Build ipa
- Target platform — iOS (IPA)
- Path to the project folder — $(Build.SourcesDirectory)
- Build Flavour — по аналогии с андроидом добавляем только при необходимости
- Export Options Plist path — $(Build.SourcesDirectory)/ios/exportOptions.plist
- Extra command arguments — --release
Tag Build
- Type — Build
- Tags — ios
Copy Publish Artifact
- Copy Root — $(Agent.BuildDirectory)
- Contents — **/ipa/*.ipa
- Artifact Name — IPA
- Artifact Type — Server

На данном этапе у нас должна проходить сборка без ошибок. Если перейти в детали сборки, то там мы должны наблюдать следующую картину

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

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

Релиз в App Center

Для начала нам необходимо создать приложения в App Center отдельно для android и ios.
Далее в настройках приложения нужно создать новый токен(он пригодится нам позже).

На данном этапе с App Center мы закончили, переходим в пайплайн.
Пайплайн для релиза будет выглядеть так

Android

Переходим на вкладку releases и создаем новый пайплайн
Первым делом нам предлагают выбрать шаблон для этапа. Спускаемся в самый низ и выбираем Empty job. На следующем шаге сразу обзовем его Published App Center Android(можете называть как хотите)
После создания пайплайна кликаем на поле Artifact и вставляем в поле Source alias название нашего артефакта. Я его так и назвал — artifact.
Далее переходим на вкладку Tasks
Добавляем таску под названием App Center distribute и прописываем ей следующие настройки
- App Center service connection — здесь вам потребуется создать новое соединение. Нажимаете на кнопку '+New'. Как раз здесь пригодится токен, который вы генерировали для каждого приложения
- App slug — на пометке справа от заголовка указана вся нужная информация
- Binary file path — выбираете из артефактов нашу apk.
- Symbols type — Android

Все что нам осталось, это добавить тригер для этапа. Кликаем по этой кнопке

и устанавливаем следующий тригер, указав нужную нам ветку и тег, который мы прописывали на этапе сборки apk

IOS

Аналогично с android

Создаем новый этап, где также устанавливаем в качестве тригера нужную ветку и в тегах прописываем ios.
В тасках все тоже самое, но подставляем уже значения для ios. Т.к. в App Center у нас два разных приложения, то и в App slug будут различные данные. Тоже касается Binary file path и Symbols type.

Все что нам осталось сделать, это указать тригер для артефакта.

На данном этапе у нас проходит полная сборка приложений и деплой в App Center. При успешном деплое в App Center в вашем приложении на вкладке Distribute/Releases вы увидите ваше приложение.

Останется только в самом App Center подключиться к сторам и отправить приложение на публикацию.

Надеюсь этот пост будет вам полезен и позволит сэкономить пару(десятков) человеко-часов.

Если вдруг что-то упустил или написал непонятно пишите в комментариях, обязательно отвечу.

Flutter — CI/CD Azure + App Center