iOS ॲप्लिकेशन तयार करणे आणि वितरित करण्याची वैशिष्ट्ये

या लेखात, आम्ही वापरकर्त्यांना iOS ऍप्लिकेशन्स असेंबलिंग आणि वितरित करण्याचा अनुभव सामायिक करतो, जो प्लारियम क्रॅस्नोडार स्टुडिओने CI/CD डीबग करण्याच्या प्रक्रियेत जमा केला आहे.

प्रशिक्षण

ऍपल डिव्हाइसेससाठी ऍप्लिकेशन्सच्या विकासामध्ये एक किंवा दुसर्या प्रकारे गुंतलेल्या प्रत्येक व्यक्तीने आधीच पायाभूत सुविधांच्या विवादास्पद सोयीची प्रशंसा केली आहे. सर्वत्र अडचणी आढळतात: विकसक प्रोफाइल मेनूपासून डीबग आणि बिल्ड टूल्सपर्यंत.

इंटरनेटवर "मूलभूत" बद्दल भरपूर लेख आहेत, म्हणून आम्ही मुख्य गोष्ट हायलाइट करण्याचा प्रयत्न करू. तुमचा अर्ज यशस्वीरित्या तयार करण्यासाठी तुम्हाला काय आवश्यक आहे ते येथे आहे:

• विकसक खाते;
• बिल्ड सर्व्हर म्हणून काम करणारे macOS-आधारित डिव्हाइस;
• व्युत्पन्न विकसक प्रमाणपत्र, जे पुढे अर्जावर स्वाक्षरी करण्यासाठी वापरले जाईल;
• अद्वितीय सह अनुप्रयोग तयार केला ID (बंडल आयडेंटिफायरचे महत्त्व लक्षात घेतले पाहिजे, कारण वाइल्डकार्ड आयडी वापरल्याने अनुप्रयोगाची अनेक कार्ये वापरणे अशक्य होते, उदाहरणार्थ: संबद्ध डोमेन, पुश सूचना, ऍपल साइन इन आणि इतर);
• प्रोफाइल अर्ज सह्या.

विकासक प्रमाणपत्र कोणत्याही macOS डिव्हाइसवर कीचेनद्वारे व्युत्पन्न केले जाणे आवश्यक आहे. प्रमाणपत्राचा प्रकार खूप महत्त्वाचा आहे. ॲप्लिकेशनच्या वातावरणावर (देव, क्यूए, स्टेजिंग, उत्पादन) ते वेगळे असेल (विकास किंवा वितरण), जसे की ॲप्लिकेशन स्वाक्षरी प्रोफाइलचा प्रकार असेल.

प्रोफाइलचे मुख्य प्रकार:

• विकास - विकास कार्यसंघाच्या अर्जावर स्वाक्षरी करण्याच्या उद्देशाने, विकास प्रमाणपत्र वापरले जाते (आयफोन विकसकाचे नाव: XXXXX);
• तदर्थ - चाचणी अर्जावर स्वाक्षरी करण्यासाठी आणि QA विभागाद्वारे अंतर्गत पडताळणीसाठी, विकसकाचे वितरण प्रमाणपत्र वापरले जाते (प्रकार नाव iPhone वितरण: XXXXX);
• ॲप स्टोअर - टेस्टफ्लाइटद्वारे बाह्य चाचणीसाठी रिलीज बिल्ड आणि ॲप स्टोअरवर अपलोड करण्यासाठी, विकसकाचे वितरण प्रमाणपत्र वापरले जाते.

विकास आणि तदर्थ प्रोफाइल तयार करताना, हे देखील सूचित केले जाते डिव्हाइस सूची, ज्यावर तुम्ही बिल्ड स्थापित करू शकता, जे तुम्हाला वापरकर्त्यांसाठी प्रवेश प्रतिबंधित करण्यास अनुमती देते. ॲप स्टोअर प्रोफाइलमध्ये उपकरणांची कोणतीही सूची नाही, कारण बंद बीटा चाचणी दरम्यान प्रवेश नियंत्रण TestFlight द्वारे हाताळले जाते, ज्याची नंतर चर्चा केली जाईल.

स्पष्टतेसाठी, तुम्ही विकासकाचे प्रोफाइल खालील सारणीच्या स्वरूपात सादर करू शकता. हे आपल्याला असेंब्लीसाठी कोणते पॅरामीटर्स आवश्यक आहेत आणि ते कोठून मिळवायचे हे समजून घेणे सोपे करते.

असेंब्ली

प्रकल्प आणि पर्यावरणानुसार असेंब्ली वेगळे करणे सोपे करण्यासाठी, आम्ही प्रोफाइल नावे वापरतो जसे की ${ProjectName}_${Instance}, म्हणजे, प्रकल्पाचे नाव + उदाहरण (अनुप्रयोग वातावरणावर अवलंबून असते: Dev, QA, GD, स्टेजिंग, लाइव्ह, आणि असेच).

बिल्ड सर्व्हरवर आयात केल्यावर, प्रोफाइल त्याचे नाव एका अद्वितीय आयडीमध्ये बदलते आणि फोल्डरमध्ये हलवले जाते /Users/$Username/Library/MobileDevice/Provisioning Profiles (कुठे $Username बिल्ड सर्व्हरच्या वापरकर्ता खात्याच्या नावाशी संबंधित आहे).

*.ipa फाइल तयार करण्याचे दोन मार्ग आहेत - वारसा (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 — विकसक खात्याचे नाव, जे कीचेनमध्ये सत्यापित केले जाऊ शकते (iPhone विकसक: XXXX XXXXXXX, कंसात TeamID शिवाय).

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” 

पुढे, परिणामी *.app फाइल *.ipa मध्ये पॅकेज केली जावी. हे करण्यासाठी, तुम्ही कमांड वापरू शकता जसे:

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

तथापि, ऍपलच्या दृष्टिकोनातून ही पद्धत अप्रचलित मानली जाते. अनुप्रयोग संग्रहणातून निर्यात करून *.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 — डेव्हलपरच्या नावानंतर कंसात दहा-अंकी आयडी, उदाहरणार्थ: iPhone डेव्हलपर: …… (XXXXXXXXXX); कीचेनमध्ये तपासले जाऊ शकते.

पुढे, निर्यात कमांड वापरून, आम्ही आवश्यक *.ipa फाइल मिळवतो:

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

शिपिंग माहिती

आता संकलित केलेली फाइल अंतिम वापरकर्त्याला वितरित करणे आवश्यक आहे, म्हणजेच, डिव्हाइसवर स्थापित केले आहे.

HockeyApp, AppBlade आणि इतर यासारख्या डेव्हलपमेंट आणि ॲड हॉक बिल्ड्सचे वितरण करण्यासाठी अनेक सेवा आहेत, परंतु या लेखात आपण अनुप्रयोग वितरणासाठी स्वतंत्र सर्व्हरबद्दल बोलू.

iOS साठी अनुप्रयोग स्थापित करणे 2 टप्प्यात होते:

1. आयटम सेवेद्वारे ऍप्लिकेशन इंस्टॉलेशन मॅनिफेस्ट प्राप्त करणे.
2. HTTPS द्वारे मॅनिफेस्टमध्ये निर्दिष्ट केलेल्या माहितीनुसार *.ipa फाइलची स्थापना.

अशा प्रकारे, आम्हाला प्रथम कमांडसह इंस्टॉलेशन मॅनिफेस्ट (फाइल प्रकार *.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 ने स्वतःचे बिल्ड इंस्टॉलेशन ऍप्लिकेशन तयार केले आहे, जे आम्हाला देते:

• स्वायत्तता आणि स्वातंत्र्य,
• ऍक्सेस कंट्रोलचे केंद्रीकरण आणि "तात्पुरत्या" डायनॅमिकली तयार केलेल्या लिंक्सद्वारे ऍप्लिकेशन्सची सुरक्षित स्थापना,
• विस्तारयोग्य कार्यक्षमता (म्हणजे, विकास कार्यसंघ, आवश्यक असल्यास, विद्यमान अनुप्रयोगामध्ये गहाळ कार्ये समाकलित करू शकतो).

चाचणी

आता आम्ही वापरून ऍप्लिकेशनच्या प्री-रिलीझ चाचणीबद्दल बोलू टेस्टफ्लाइट.

डाउनलोड करण्यासाठी आवश्यक अटी म्हणजे ॲप स्टोअर स्वाक्षरी प्रोफाइलचा प्रकार आणि व्युत्पन्न केलेल्या API कीची उपस्थिती.

अनुप्रयोग डाउनलोड करण्याचे अनेक मार्ग आहेत:

• Xcode (आयोजक) द्वारे,
• altool द्वारे,
• Xcode च्या जुन्या आवृत्त्यांसाठी ऍप्लिकेशन लोडरद्वारे (आता ट्रान्सपोर्टर).

स्वयंचलित डाउनलोडिंगसाठी, altool वापरला जातो, ज्यामध्ये दोन अधिकृतता पद्धती देखील आहेत:

• ॲप-विशिष्ट पासवर्ड,
• API की.

API की वापरून अनुप्रयोग डाउनलोड करणे अधिक श्रेयस्कर आहे.

API की मिळविण्यासाठी, येथे जा दुवा आणि एक की व्युत्पन्न करा. *.p8 फॉरमॅटमधील की व्यतिरिक्त, आम्हाला दोन पॅरामीटर्सची आवश्यकता असेल: IssuerID आणि KeyID.

पुढे, डाउनलोड केलेली की बिल्ड सर्व्हरवर आयात करा:

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 समान पॅरामीटर्ससह.

ॲपलद्वारे एक किंवा दोन दिवसात अनुप्रयोगाची चाचणी केली जाईल आणि नंतर बाह्य परीक्षकांसाठी उपलब्ध होईल: त्यांना स्थापनेसाठी लिंक ईमेल केल्या जातील.

altool द्वारे अनुप्रयोग डाउनलोड करण्याचा दुसरा मार्ग म्हणजे ॲप-विशिष्ट पासवर्ड वापरणे.

ॲप-विशिष्ट पासवर्ड मिळविण्यासाठी तुम्हाला जावे लागेल दुवा आणि ते सुरक्षा विभागात तयार करा.

पुढे, तुम्ही या पासवर्डसह कीचेनमध्ये एक बिल्ड सर्व्हर रेकॉर्ड तयार केला पाहिजे. Xcode च्या आवृत्ती 11 वरून हे कमांडसह केले जाऊ शकते:

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

कोठे:

$DeveloperName — Apple सेवांमध्ये लॉग इन करण्यासाठी वापरल्या जाणाऱ्या iOS विकसक खात्याचे नाव.

$AppPswd — व्युत्पन्न ॲप-विशिष्ट पासवर्ड.

पुढे, आम्हाला asc-प्रदाता पॅरामीटरचे मूल्य मिळते आणि कमांडसह पासवर्ड इंपोर्टचे यश तपासा:

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

आम्हाला आउटपुट मिळते:

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

जसे तुम्ही बघू शकता, आवश्यक लहान नाव मूल्य (asc-provider) हे $TeamID पॅरामीटरशी जुळते जे आम्ही ॲप्लिकेशन तयार करताना वापरले होते.

टेस्टफ्लाइटमध्ये ॲप्लिकेशन प्रमाणित आणि लोड करण्यासाठी, कमांड वापरा:

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

पॅरामीटर मूल्य म्हणून -p आपण मूल्य घेऊ शकता $AppPswd एनक्रिप्टेड (स्पष्ट) स्वरूपात.

तथापि, आधीच नमूद केल्याप्रमाणे, कार्यप्रदर्शनाच्या दृष्टिकोनातून, altool अधिकृततेसाठी API की निवडणे अधिक चांगले आहे, कारण Xcode च्या विविध आवृत्त्यांमध्ये काही समस्या आहेत (कीचेन “दिसत नाही”, अपलोड दरम्यान अधिकृतता त्रुटी इ.).

ते सर्व आहे, प्रत्यक्षात. App Store मधील यशस्वी बिल्ड आणि समस्या-मुक्त रिलीझमध्ये सहभागी असलेल्या प्रत्येकाला माझी इच्छा आहे.

स्त्रोत: www.habr.com