iOS აპლიკაციების შექმნისა და მიწოდების მახასიათებლები

ამ სტატიაში ჩვენ ვიზიარებთ iOS აპლიკაციების მომხმარებლებისთვის აწყობისა და მიწოდების გამოცდილებას, რომელიც Plarium Krasnodar-ის სტუდიამ დააგროვა CI/CD გამართვის პროცესში.

სასწავლო

ყველა ადამიანი, რომელიც ამა თუ იმ გზით არის ჩართული Apple მოწყობილობების აპლიკაციების შემუშავებაში, უკვე აფასებს ინფრასტრუქტურის საკამათო მოხერხებულობას. სირთულეები ყველგან გვხვდება: დეველოპერის პროფილის მენიუდან გამართვისა და კონსტრუქციის ინსტრუმენტებამდე.

ინტერნეტში უამრავი სტატიაა „საფუძვლების“ შესახებ, ამიტომ შევეცდებით გამოვყოთ მთავარი. აი, რა გჭირდებათ თქვენი აპლიკაციის წარმატებით შესაქმნელად:

• დეველოპერის ანგარიში;
• macOS-ზე დაფუძნებული მოწყობილობა, რომელიც მოქმედებს როგორც build სერვერი;
• გენერირებული დეველოპერის სერთიფიკატი, რომელიც შემდგომში გამოყენებული იქნება განაცხადზე ხელმოწერისთვის;
• შექმნილი აპლიკაცია უნიკალურით ID (აღსანიშნავია Bundle Identifier-ის მნიშვნელობა, რადგან wildcard ID-ის გამოყენება შეუძლებელს ხდის აპლიკაციის მრავალი ფუნქციის გამოყენებას, მაგალითად: ასოცირებული დომენები, Push Notifications, Apple Sign In და სხვა);
• პროფილი განაცხადის ხელმოწერები.

დეველოპერის სერთიფიკატი უნდა შეიქმნას Keychain-ის მეშვეობით ნებისმიერ macOS მოწყობილობაზე. სერტიფიკატის ტიპი ძალიან მნიშვნელოვანია. აპლიკაციის გარემოდან გამომდინარე (Dev, QA, Staging, Production) ის განსხვავდება (განვითარება ან განაწილება), ისევე როგორც განაცხადის ხელმოწერის პროფილის ტიპი.

პროფილების ძირითადი ტიპები:

• დეველოპმენტი - განკუთვნილია დეველოპერული გუნდის აპლიკაციაზე ხელმოწერისთვის, გამოიყენება დეველოპმენტის სერტიფიკატი (ტიპის სახელი iPhone Developer: XXXXX);
• Ad Hoc - განკუთვნილია სატესტო განაცხადის ხელმოწერისა და ხარისხის კონტროლის დეპარტამენტის მიერ შიდა გადამოწმებისთვის, გამოიყენება დეველოპერის დისტრიბუციის სერტიფიკატი (ტიპის სახელი iPhone Distribution: XXXXX);
• App Store - გამოშვება გარე ტესტირებისთვის TestFlight-ის საშუალებით და App Store-ში ატვირთვისთვის, გამოიყენება დეველოპერის დისტრიბუციის სერტიფიკატი.

განვითარების და Ad Hoc პროფილების გენერირებისას ასევე მითითებულია მოწყობილობების სია, რომელზედაც შეგიძლიათ დააინსტალიროთ build, რომელიც საშუალებას გაძლევთ კიდევ უფრო შეზღუდოთ წვდომა მომხმარებლებისთვის. App Store-ის პროფილში არ არის მოწყობილობების სია, რადგან დახურული ბეტა ტესტირების დროს წვდომის კონტროლს აკონტროლებს TestFlight, რომელიც მოგვიანებით იქნება განხილული.

სიცხადისთვის, შეგიძლიათ წარმოადგინოთ დეველოპერის პროფილი ქვემოთ მოცემული ცხრილის სახით. ეს აადვილებს იმის გაგებას, თუ რა პარამეტრები გვჭირდება შეკრებისთვის და საიდან მივიღოთ ისინი.

ასამბლეა

იმისათვის, რომ გავაადვილოთ შეკრებების გამოყოფა პროექტისა და გარემოს მიხედვით, ჩვენ ვიყენებთ პროფილის სახელებს, როგორიცაა ${ProjectName}_${Instance}, ანუ პროექტის სახელი + ინსტანცია (დამოკიდებულია აპლიკაციის გარემოზე: Dev, QA, GD, Staging, Live და ა.შ.).

build სერვერზე იმპორტისას, პროფილი იცვლის სახელს უნიკალურ ID-ად და გადადის საქაღალდეში /Users/$Username/Library/MobileDevice/Provisioning Profiles (სად $Username შეესაბამება build სერვერის მომხმარებლის ანგარიშის სახელს).

*.ipa ფაილის შექმნის ორი გზა არსებობს - legacy (PackageApplication) და თანამედროვე (XcAchive შექმნისა და ექსპორტის საშუალებით). პირველი მეთოდი ითვლება მოძველებულად, რადგან 8.3 ვერსიიდან აპის ფაილის შეფუთვის მოდული ამოღებულია Xcode დისტრიბუციიდან. მის გამოსაყენებლად, თქვენ უნდა დააკოპიროთ მოდული ძველი Xcode-დან (ვერსია 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/*

შემდეგ თქვენ უნდა შეაგროვოთ აპლიკაციის *.app ფაილი:

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 — აწყობილი აპლიკაციის ჩამოტვირთვის გზა (*.app).

CODE_SIGN_IDENTITY — დეველოპერის ანგარიშის სახელი, რომლის შემოწმებაც შესაძლებელია Keychain-ში (iPhone Developer: XXXX XXXXXXX, TeamID-ის გარეშე ფრჩხილებში).

PROVISIONING_PROFILE — განაცხადის ხელმოწერის პროფილის ID, რომლის მიღებაც შესაძლებელია ბრძანებით:

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

თუ აპლიკაცია იყენებს დამატებით პროფილს (მაგალითად, Push შეტყობინებებისთვის), მაშინ ამის ნაცვლად PROVISIONING_PROFILE მიუთითეთ:

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

შემდეგი, მიღებული *.app ფაილი უნდა შეფუთული იყოს *.ipa-ში. ამისათვის შეგიძლიათ გამოიყენოთ ბრძანება, როგორიცაა:

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

თუმცა ეს მეთოდი Apple-ის თვალსაზრისით მოძველებულად ითვლება. აქტუალურია *.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 — მიწოდების მეთოდი, შეესაბამება აპლიკაციის ხელმოწერის პროფილის ტიპს, ანუ განვითარებისთვის მნიშვნელობა იქნება განვითარება, Ad Hoc - ad-hoc, ხოლო App Store-ისთვის - app-store.

$BundleID — აპლიკაციის ID, რომელიც მითითებულია აპლიკაციის პარამეტრებში. შეგიძლიათ შეამოწმოთ ბრძანებით:

defaults read $ProjectDir/Info CFBundleIdentifier

$DevAccName и $ProfileId — დეველოპერის სახელი და ხელმოწერის პროფილის ID პარამეტრები, რომლებიც ადრე იყო გამოყენებული და უნდა ემთხვეოდეს ექსპორტის პარამეტრებში არსებულ მნიშვნელობებს.

$TeamID — ათნიშნა ID ფრჩხილებში დეველოპერის სახელის შემდეგ, მაგალითად: iPhone დეველოპერი: …… (XXXXXXXXXX); შეიძლება შემოწმდეს Keychain-ში.

შემდეგ, ექსპორტის ბრძანების გამოყენებით, ვიღებთ საჭირო *.ipa ფაილს:

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

Доставка

ახლა შეგროვებული ფაილი უნდა გადაეცეს საბოლოო მომხმარებელს, ანუ დაინსტალირდეს მოწყობილობაზე.

არსებობს მრავალი სერვისი დეველოპმენტისა და Ad Hoc build-ების დისტრიბუციისთვის, როგორიცაა HockeyApp, AppBlade და სხვა, მაგრამ ამ სტატიაში ვისაუბრებთ აპლიკაციების განაწილების დამოუკიდებელ სერვერზე.

iOS-ისთვის აპლიკაციის ინსტალაცია ხდება 2 ეტაპად:

1. აპლიკაციის ინსტალაციის მანიფესტის მიღება Items Service-ის მეშვეობით.
2. *.ipa ფაილის ინსტალაცია მანიფესტში მითითებული ინფორმაციის მიხედვით HTTPS-ის საშუალებით.

ამგვარად, ჩვენ ჯერ უნდა შევქმნათ ინსტალაციის მანიფესტი (ფაილის ტიპი *.plist) ბრძანებით:

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 შეიცავს პირდაპირ ბმულს *.ipa ფაილის გადმოსაწერად. iOS-ის მეშვიდე ვერსიიდან, აპლიკაცია უნდა იყოს დაინსტალირებული HTTPS-ის საშუალებით. მერვე ვერსიაში, მანიფესტის ფორმატი ოდნავ შეიცვალა: ბლოკები აპლიკაციის ხატულების პარამეტრებით, როგორიცაა

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

ამრიგად, აპლიკაციის ინსტალაციისთვის საკმარისია მარტივი HTML გვერდი მსგავსი ბმულით:

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

განვითარებისა და ტესტირების განყოფილებების საჭიროებებისთვის Plarium-მა შექმნა საკუთარი build-ის ინსტალაციის აპლიკაცია, რომელიც გვაძლევს:

• ავტონომია და დამოუკიდებლობა,
• წვდომის კონტროლის ცენტრალიზაცია და აპლიკაციების უსაფრთხო ინსტალაცია „დროებითი“ დინამიურად შექმნილი ბმულების საშუალებით,
• გაფართოებადი ფუნქციონირება (ანუ, განვითარების გუნდს, საჭიროების შემთხვევაში, შეუძლია დაკარგული ფუნქციების ინტეგრირება არსებულ აპლიკაციაში).

ტესტირება

ახლა ჩვენ ვისაუბრებთ აპლიკაციის წინასწარ გამოშვების ტესტირებაზე TestFlight.

ჩამოტვირთვის აუცილებელი პირობებია App Store ხელმოწერის პროფილის ტიპი და გენერირებული API კლავიშების არსებობა.

აპლიკაციის ჩამოტვირთვის რამდენიმე გზა არსებობს:

• Xcode-ის (ორგანიზატორი) საშუალებით,
• ინსტრუმენტის საშუალებით,
• Application Loader-ის მეშვეობით Xcode-ის ძველი ვერსიებისთვის (ახლა Transporter).

ავტომატური გადმოტვირთვისთვის გამოიყენება altool, რომელსაც ასევე აქვს ავტორიზაციის ორი მეთოდი:

• აპლიკაციის სპეციფიკური პაროლი,
• API გასაღები.

სასურველია აპლიკაციის ჩამოტვირთვა API გასაღების გამოყენებით.

API გასაღების მისაღებად გადადით ლინკები და შექმენით გასაღები. გარდა თავად გასაღებისა *.p8 ფორმატში, დაგვჭირდება ორი პარამეტრი: IssuerID და KeyID.

შემდეგი, გადმოწერილი გასაღების იმპორტი build სერვერზე:

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

აპლიკაციის TestFlight-ზე ატვირთვამდე, თქვენ უნდა დაადასტუროთ აპლიკაცია, ჩვენ ამას ვაკეთებთ ბრძანებით:

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

Где apiKey и apiIssuer აქვს ველის მნიშვნელობები API გასაღების გენერირების გვერდიდან.

შემდეგი, წარმატებული ვალიდაციის შემდეგ, ჩვენ ვტვირთავთ აპლიკაციას ბრძანებით --upload-app იგივე პარამეტრებით.

აპლიკაცია Apple-ის მიერ ერთი ან ორი დღის განმავლობაში შემოწმდება და შემდეგ ხელმისაწვდომი გახდება გარე ტესტერებისთვის: მათ ეგზავნებათ ლინკები ინსტალაციისთვის.

აპლიკაციის altool-ის საშუალებით ჩამოტვირთვის კიდევ ერთი გზაა აპის სპეციფიკური პაროლის გამოყენება.

აპლიკაციის სპეციფიკური პაროლის მისაღებად თქვენ უნდა შეხვიდეთ ლინკები და გენერირება უსაფრთხოების განყოფილებაში.

შემდეგი, თქვენ უნდა შექმნათ build სერვერის ჩანაწერი Keychain-ში ამ პაროლით. Xcode-ის 11 ვერსიიდან ეს შეიძლება გაკეთდეს ბრძანებით:

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

სად:

$DeveloperName — iOS დეველოპერის ანგარიშის სახელი, რომელიც გამოიყენება Apple სერვისებში შესასვლელად.

$AppPswd - გენერირებული აპისთვის სპეციფიკური პაროლი.

შემდეგი, ჩვენ ვიღებთ asc-provider პარამეტრის მნიშვნელობას და ვამოწმებთ პაროლის იმპორტის წარმატებას ბრძანებით:

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

ჩვენ ვიღებთ გამოსავალს:

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

როგორც ხედავთ, საჭირო Short Name მნიშვნელობა (asc-provider) ემთხვევა $TeamID პარამეტრს, რომელიც გამოვიყენეთ აპლიკაციის შექმნისას.

აპლიკაციის ტესტირება და ჩასატვირთად TestFlight-ში გამოიყენეთ ბრძანება:

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

როგორც პარამეტრის მნიშვნელობა -p შეგიძლიათ აიღოთ ღირებულება $AppPswd დაუშიფრავი (გამოკვეთილი) ფორმით.

თუმცა, როგორც უკვე აღვნიშნეთ, შესრულების თვალსაზრისით, უმჯობესია აირჩიოთ API Key altool ავტორიზაციისთვის, რადგან Xcode-ის სხვადასხვა ვერსიას აქვს გარკვეული პრობლემები („ვერ ხედავს“ Keychain, ავტორიზაციის შეცდომებს ატვირთვისას და ა.შ.).

ეს ყველაფერი, ფაქტობრივად. ყველა მონაწილეს ვუსურვებ წარმატებულ აშენებებს და უპრობლემოდ გამოშვებას App Store-ში.

წყარო: www.habr.com