Карактеристике изградње и испоруке иОС апликација

У овом чланку делимо искуство склапања и испоруке иОС апликација корисницима, које је студио Плариум Краснодар акумулирао у процесу отклањања грешака ЦИ/ЦД.

Обука

Свака особа која је на овај или онај начин укључена у развој апликација за Аппле уређаје већ је ценила контроверзну погодност инфраструктуре. Потешкоће се налазе свуда: од менија профила програмера до алата за отклањање грешака и прављење.

На Интернету има доста чланака о „основама“, па ћемо покушати да истакнемо оно главно. Ево шта вам је потребно да бисте успешно направили своју апликацију:

• налог програмера;
• уређај заснован на мацОС-у који делује као сервер за изградњу;
• генерисан сертификат програмера, који ће се даље користити за потписивање пријаве;
• креирана апликација са јединственим ID (треба напоменути важност Бундле Идентифиер-а, јер употреба џокер ИД-а онемогућава коришћење многих функција апликације, на пример: Придружени домени, Пусх обавештења, Аппле Сигн Ин и друге);
• профил потписи апликација.

Сертификат програмера мора да се генерише преко Кеицхаин-а на било ком мацОС уређају. Врста сертификата је веома важна. У зависности од окружења апликације (Дев, КА, Стагинг, Продуцтион) оно ће се разликовати (развој или дистрибуција), као и тип профила потписа апликације.

Главне врсте профила:

• Развој – намењен за потписивање апликације развојног тима, користи се Развојни сертификат (назив типа иПхоне Девелопер: КСКСКСКСКС);
• Ад Хоц - намењен за потписивање тест апликације и интерну верификацију од стране КА одељења, користи се сертификат о дистрибуцији програмера (назив типа иПхоне Дистрибутион: КСКСКСКСКС);
• Апп Сторе - верзија за екстерно тестирање преко ТестФлигхт-а и отпремање у Апп Сторе, користи се сертификат о дистрибуцији програмера.

Приликом генерисања развојних и ад хоц профила, то је такође назначено листа уређаја, на који можете инсталирати буилд, што вам омогућава да додатно ограничите приступ корисницима. Не постоји листа уређаја у Апп Сторе профилу, пошто контролу приступа током затвореног бета тестирања обавља ТестФлигхт, о чему ће бити речи касније.

Ради јасноће, можете представити профил програмера у облику табеле испод. Тако је лакше разумети који су нам параметри потребни за монтажу и одакле да их набавимо.

Скупштина

Да бисмо олакшали одвајање склопова по пројекту и окружењу, користимо имена профила као што су ${ProjectName}_${Instance}, односно назив пројекта + инстанца (зависи од окружења апликације: Дев, КА, ГД, Стагинг, Ливе, итд.).

Када се увезе на сервер за изградњу, профил мења своје име у јединствени ИД и премешта се у фасциклу /Users/$Username/Library/MobileDevice/Provisioning Profiles (Где $Username одговара имену корисничког налога сервера за изградњу).

Постоје два начина за прављење *.ипа датотеке – старија (ПацкагеАпплицатион) и модерна (преко КсцАцхиве креирања и извоза). Први метод се сматра застарелим, пошто је од верзије 8.3 модул за паковање датотека апликације уклоњен из Ксцоде дистрибуције. Да бисте га користили, потребно је да копирате модул из старог Ксцоде-а (верзија 8.2 и раније) у фасциклу:
/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/usr/bin/

А затим покрените команду:

chmod +x /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/usr/bin/*

Затим морате прикупити *.апп датотеку апликације:

xcodebuild 
-workspace $ProjectDir/$ProjectName.xcworkspace 
-scheme $SchemeName 
-sdk iphoneos 
build 
-configuration Release 
-derivedDataPath build 
CODE_SIGN_IDENTITY=”$DevAccName”
PROVISIONING_PROFILE=”$ProfileId”
DEPLOYMENT_POSTPROCESSING=YES 
SKIP_INSTALL=YES 
ENABLE_BITCODE=NO

Где је:

-workspace — путања до датотеке пројекта.

-scheme — коришћена шема, наведена у пројекту.

-derivedDataPath — путања за преузимање састављене апликације (*.апп).

CODE_SIGN_IDENTITY — назив налога програмера, који се може верификовати у Кеицхаин-у (иПхоне Девелопер: КСКСКСКС КСКСКСКСКСКСКС, без ТеамИД-а у заградама).

PROVISIONING_PROFILE — ИД профила за потписивање апликације, који се може добити командом:

cd "/Users/$Username/Library/MobileDevice/Provisioning Profiles/" && find *.mobileprovision -type f | xargs grep -li ">${ProjectName}_${Instance}<" | sed -e 's/.mobileprovision//'

Ако апликација користи додатни профил (на пример, за Пусх обавештења), онда уместо PROVISIONING_PROFILE назначити:

APP_PROFILE=”$AppProfile” 
EXTENSION_PROFILE=”$ExtProfile” 

Затим, резултујућу *.апп датотеку треба упаковати у *.ипа. Да бисте то урадили, можете користити команду као што је:

/usr/bin/xcrun --sdk iphoneos PackageApplication 
-v $(find "$ProjectDir/build/Build/Products/Release-iphoneos" -name "*.app") 
-o "$ProjectDir/$ProjectName_$Instance.ipa"

Међутим, овај метод се сматра застарелим са Апплеове тачке гледишта. Важно је да добијете *.ипа извозом из архиве апликације.

Прво морате да прикупите архиву командом:

xcodebuild 
-workspace $ProjectDir/$ProjectName.xcworkspace 
-scheme $SchemeName 
-sdk iphoneos 
-configuration Release 
archive 
-archivePath $ProjectDir/build/$ProjectName.xcarchive 
CODE_SIGN_IDENTITY=”$DevAccName” 
PROVISIONING_PROFILE=”$ProfileId”
ENABLE_BITCODE=NO 
SYNCHRONOUS_SYMBOL_PROCESSING=FALSE

Разлике леже у начину монтаже и опцијама SYNCHRONOUS_SYMBOL_PROCESSING, што онемогућава истовар симбола у време израде.

Затим морамо да генеришемо датотеку са подешавањима извоза:

ExportSettings="$ProjectDir/exportOptions.plist"

cat << EOF > $ExportSettings
<?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>compileBitcode</key>
<false/>
<key>uploadBitcode</key>
<false/>
<key>uploadSymbols</key>
<false/>
<key>method</key>
<string>$Method</string>
<key>provisioningProfiles</key>
<dict>
<key>$BundleID</key>
<string>$ProfileId</string>
</dict>
<key>signingCertificate</key>
<string>$DevAccName</string>
<key>signingStyle</key>
<string>manual</string>
<key>stripSwiftSymbols</key>
<true/>
<key>teamID</key>
<string>$TeamID</string>
<key>thinning</key>
<string><none></string>
</dict>
</plist>
EOF

Где је:

$Method — начин испоруке, одговара типу профила апликације потписа, односно за развој ће вредност бити развој, за Ад Хоц - ад-хоц, а за Апп Сторе - продавница апликација.

$BundleID — ИД апликације, који је наведен у подешавањима апликације. Можете проверити командом:

defaults read $ProjectDir/Info CFBundleIdentifier

$DevAccName и $ProfileId — подешавања имена програмера и профила потписа која су претходно коришћена и морају да одговарају вредностима у подешавањима извоза.

$TeamID — десетоцифрени ИД у заградама иза имена програмера, пример: иПхоне Девелопер: …… (КСКСКСКСКСКСКСКСКСКС); може се проверити у Кеицхаин-у.

Затим, користећи команду за извоз, добијамо неопходну *.ипа датотеку:

xcodebuild 
-exportArchive 
-archivePath $ProjectDir/build/$ProjectName.xcarchive 
-exportPath $ProjectDir 
-exportOptionsPlist $ExportSettings

Испорука

Сада прикупљену датотеку треба доставити крајњем кориснику, односно инсталирати на уређај.

Постоји много сервиса за дистрибуцију Девелопмент и Ад Хоц буилд-ова, као што су ХоцкеиАпп, АппБладе и други, али у овом чланку ћемо говорити о самосталном серверу за дистрибуцију апликација.

Инсталирање апликације за иОС одвија се у 2 фазе:

1. Пријем манифеста за инсталацију апликације преко услуге Итемс.
2. Инсталација *.ипа датотеке у складу са информацијама наведеним у манифесту преко ХТТПС-а.

Дакле, прво морамо да генеришемо инсталациони манифест (тип датотеке *.плист) са командом:

cat << EOF > $manifest
<?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>items</key>
<array>
<dict>
<key>assets</key>
<array>
<dict>
<key>kind</key>
<string>software-package</string>
<key>url</key>
<string>$ipaUrl</string>
</dict>
</array>
<key>metadata</key>
<dict>
<key>bundle-identifier</key>
<string>$BundleID</string>
<key>bundle-version</key>
<string>$AppVersion</string>
<key>kind</key>
<string>software</string>
<key>title</key>
<string>$ProjectName_$Instance</string>
<key>subtitle</key>
<string>$Instance</string>
</dict>
</dict>
</array>
</dict>
</plist>
EOF

Као што видите, манифест садржи скоро све параметре укључене у изградњу апликације.

Верзија апликације ($AppVersion) може се проверити командом:

defaults read $ProjectDir/Info CFBundleVersion

Параметар $ipaUrl садржи директну везу за преузимање *.ипа датотеке. Од седме верзије иОС-а, апликација мора бити инсталирана преко ХТТПС-а. У осмој верзији, формат манифеста је мало промењен: блокови са подешавањима за иконе апликација попут

<images>
   <image>...</image>
</images>

Дакле, за инсталирање апликације довољна је једноставна ХТМЛ страница са оваквом везом:

itms-services://?action=download-manifest&url=https://$ServerUrl/$ProjectName/$Instance/iOS/$AppVersion/manifest.plist

За потребе одељења за развој и тестирање, Плариум је креирао сопствену апликацију за монтажу која нам даје:

• самосталност и независност,
• централизација контроле приступа и безбедно инсталирање апликација преко „привремених“ динамички креираних веза,
• проширива функционалност (то јест, развојни тим, ако је потребно, може интегрисати недостајуће функције у постојећу апликацију).

Тестирање

Сада ћемо причати о тестирању апликације пре пуштања у продају ТестФлигхт.

Неопходни услови за преузимање су тип профила потписа у Апп Сторе-у и присуство генерисаних АПИ кључева.

Постоји неколико начина за преузимање апликације:

• преко Ксцоде-а (Организатор),
• преко алата,
• преко Апплицатион Лоадер-а за старије верзије Ксцоде-а (сада Транспортер).

За аутоматско преузимање се користи алтоол, који такође има два начина ауторизације:

• Посебна лозинка за апликацију,
• АПИ кључ.

Пожељно је да преузмете апликацију користећи АПИ кључ.

Да бисте добили АПИ кључ, идите на веза и генерише кључ. Поред самог кључа у *.п8 формату, биће нам потребна два параметра: ИссуерИД и КеиИД.

Затим увезите преузети кључ на сервер за изградњу:

mkdir -p ~/.appstoreconnect/private_keys
mv ~/Downloads/AuthKey_${KeyID}.p8 ~/.appstoreconnect/private_keys/

Пре него што отпремите апликацију на ТестФлигхт, потребно је да потврдите апликацију, ми то радимо командом:

xcrun altool 
--validate-app 
-t ios 
-f $(find "$ProjectDir" -name "*.ipa") 
--apiKey “$KeyID” 
--apiIssuer “$IssuerID” 

где apiKey и apiIssuer имају вредности поља са странице за генерисање АПИ кључева.

Затим, након успешне валидације, учитавамо апликацију са командом --upload-app са истим параметрима.

Апликацију ће Аппле тестирати у року од једног или два дана, а затим ће постати доступна спољним тестерима: биће им послате везе за инсталацију путем е-поште.

Други начин за преузимање апликације преко алтоол-а је употреба лозинке специфичне за апликацију.

Да бисте добили посебну лозинку за апликацију, морате да одете на веза и генеришите га у одељку Безбедност.

Затим би требало да креирате запис сервера за изградњу у Кеицхаин-у са овом лозинком. Од верзије 11 Ксцоде-а ово се може урадити помоћу команде:

xcrun altool --store-password-in-keychain-item "Altool" -u "$DeveloperName" -p $AppPswd

Где је:

$DeveloperName — назив налога иОС програмера који се користи за пријаву на Аппле услуге.

$AppPswd — генерисана посебна лозинка за апликацију.

Затим добијамо вредност параметра асц-провидер и проверавамо успешност увоза лозинке командом:

xcrun altool --list-providers -u "$DeveloperName" -p "@keychain:Altool"

Добијамо излаз:

Provider listing:
- Long Name - - Short Name -
XXXXXXX        XXXXXXXXX

Као што видите, потребна вредност кратког имена (асц-провидер) поклапа се са параметром $ТеамИД који смо користили приликом израде апликације.

Да бисте потврдили и учитали апликацију у ТестФлигхт, користите наредбу:

xcrun altool 
--(validate|upload)-app   
-f $(find "$ProjectDir" -name "*.ipa") 
-u "$DeveloperName" 
-p "@keychain:Altool" 

Као вредност параметра -p можете узети вредност $AppPswd у нешифрованом (експлицитном) облику.

Међутим, као што је већ поменуто, са становишта перформанси, боље је изабрати АПИ кључ за алтоол ауторизацију, јер различите верзије Ксцоде-а имају одређене проблеме („не види“ Кеицхаин, грешке при ауторизацији током отпремања итд.).

То је све, заправо. Желим свима који су укључени у успешне верзије и издања без проблема у Апп Сторе-у.

Извор: ввв.хабр.цом