आईओएस एप्लिकेशन बनाने और वितरित करने की विशेषताएं

इस लेख में, हम iOS एप्लिकेशन को असेंबल करने और उपयोगकर्ताओं तक पहुंचाने का अनुभव साझा करते हैं, जिसे प्लेरियम क्रास्नोडार स्टूडियो ने सीआई/सीडी डिबग करने की प्रक्रिया में जमा किया है।

ट्रेनिंग

प्रत्येक व्यक्ति जो किसी न किसी तरह से Apple उपकरणों के लिए एप्लिकेशन के विकास में शामिल है, उसने पहले से ही बुनियादी ढांचे की विवादास्पद सुविधा की सराहना की है। कठिनाइयाँ हर जगह पाई जाती हैं: डेवलपर प्रोफ़ाइल मेनू से लेकर डिबग और बिल्ड टूल तक।

इंटरनेट पर "बुनियादी बातों" के बारे में बहुत सारे लेख हैं, इसलिए हम मुख्य बात पर प्रकाश डालने का प्रयास करेंगे। यहां बताया गया है कि आपको अपना एप्लिकेशन सफलतापूर्वक बनाने के लिए क्या चाहिए:

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

किसी भी macOS डिवाइस पर किचेन के माध्यम से एक डेवलपर प्रमाणपत्र तैयार किया जाना चाहिए। प्रमाणपत्र का प्रकार बहुत महत्वपूर्ण है. एप्लिकेशन वातावरण (डेवलपमेंट, क्यूए, स्टेजिंग, प्रोडक्शन) के आधार पर यह भिन्न होगा (विकास या वितरण), जैसा कि एप्लिकेशन हस्ताक्षर प्रोफ़ाइल का प्रकार होगा।

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

• विकास - विकास टीम के आवेदन पर हस्ताक्षर करने के लिए, एक विकास प्रमाणपत्र का उपयोग किया जाता है (प्रकार का नाम iPhone डेवलपर: XXXXX);
• एड हॉक - एक परीक्षण आवेदन पर हस्ताक्षर करने और क्यूए विभाग द्वारा आंतरिक सत्यापन के लिए, डेवलपर के वितरण प्रमाणपत्र का उपयोग किया जाता है (प्रकार का नाम iPhone वितरण: XXXXX);
• ऐप स्टोर - टेस्टफ़्लाइट के माध्यम से बाहरी परीक्षण के लिए रिलीज़ बिल्ड और ऐप स्टोर पर अपलोड करने पर, डेवलपर के वितरण प्रमाणपत्र का उपयोग किया जाता है।

विकास और तदर्थ प्रोफ़ाइल बनाते समय, इसका भी संकेत दिया जाता है उपकरण सूची, जिस पर आप एक बिल्ड स्थापित कर सकते हैं, जो आपको उपयोगकर्ताओं के लिए पहुंच को और अधिक प्रतिबंधित करने की अनुमति देता है। ऐप स्टोर प्रोफ़ाइल में उपकरणों की कोई सूची नहीं है, क्योंकि बंद बीटा परीक्षण के दौरान पहुंच नियंत्रण TestFlight द्वारा नियंत्रित किया जाता है, जिस पर बाद में चर्चा की जाएगी।

स्पष्टता के लिए, आप डेवलपर की प्रोफ़ाइल को नीचे दी गई तालिका के रूप में प्रस्तुत कर सकते हैं। इससे यह समझना आसान हो जाता है कि असेंबली के लिए हमें किन मापदंडों की आवश्यकता है और उन्हें कहां से प्राप्त करना है।

सभा

असेंबली को प्रोजेक्ट और परिवेश के आधार पर अलग करना आसान बनाने के लिए, हम प्रोफ़ाइल नामों का उपयोग करते हैं जैसे ${ProjectName}_${Instance}, अर्थात, प्रोजेक्ट का नाम + उदाहरण (एप्लिकेशन वातावरण पर निर्भर करता है: डेव, क्यूए, जीडी, स्टेजिंग, लाइव, और इसी तरह)।

जब बिल्ड सर्वर पर आयात किया जाता है, तो प्रोफ़ाइल अपना नाम एक अद्वितीय आईडी में बदल देती है और फ़ोल्डर में ले जाया जाता है /Users/$Username/Library/MobileDevice/Provisioning Profiles (जहां $Username बिल्ड सर्वर के उपयोगकर्ता खाते के नाम से मेल खाता है)।

*.ipa फ़ाइल बनाने के दो तरीके हैं - लीगेसी (पैकेजएप्लिकेशन) और आधुनिक (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"

हालाँकि, 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 - वितरण विधि, एप्लिकेशन हस्ताक्षर प्रोफ़ाइल प्रकार से मेल खाती है, अर्थात, विकास के लिए मूल्य विकास होगा, तदर्थ के लिए - तदर्थ, और ऐप स्टोर के लिए - ऐप-स्टोर।

$BundleID — एप्लिकेशन आईडी, जो एप्लिकेशन सेटिंग्स में निर्दिष्ट है। आप कमांड से जांच सकते हैं:

defaults read $ProjectDir/Info CFBundleIdentifier

$DevAccName и $ProfileId - डेवलपर नाम और हस्ताक्षर प्रोफ़ाइल आईडी सेटिंग्स जो पहले उपयोग की गई थीं और निर्यात सेटिंग्स में मानों से मेल खाना चाहिए।

$TeamID — डेवलपर के नाम के बाद कोष्ठक में दस अंकों की आईडी, उदाहरण: iPhone डेवलपर: …… (XXXXXXXXX); किचेन में चेक किया जा सकता है।

अगला, निर्यात कमांड का उपयोग करके, हम आवश्यक *.ipa फ़ाइल प्राप्त करते हैं:

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

वितरण

अब एकत्रित फ़ाइल को अंतिम उपयोगकर्ता तक पहुंचाना होगा, यानी डिवाइस पर इंस्टॉल करना होगा।

डेवलपमेंट और एड हॉक बिल्ड को वितरित करने के लिए कई सेवाएँ हैं, जैसे हॉकीऐप, ऐपब्लेड और अन्य, लेकिन इस लेख में हम अनुप्रयोगों को वितरित करने के लिए एक स्टैंडअलोन सर्वर के बारे में बात करेंगे।

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 फ़ाइल डाउनलोड करने के लिए एक सीधा लिंक शामिल है। आईओएस के सातवें संस्करण से, एप्लिकेशन को HTTPS के माध्यम से इंस्टॉल किया जाना चाहिए। आठवें संस्करण में, मेनिफेस्ट का प्रारूप थोड़ा बदल गया है: जैसे एप्लिकेशन आइकन के लिए सेटिंग्स वाले ब्लॉक

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

इस प्रकार, एप्लिकेशन इंस्टॉल करने के लिए, इस तरह के लिंक वाला एक सरल HTML पृष्ठ पर्याप्त है:

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

विकास और परीक्षण विभागों की जरूरतों के लिए, प्लेरियम ने अपना स्वयं का बिल्ड इंस्टॉलेशन एप्लिकेशन बनाया है, जो हमें देता है:

• स्वायत्तता और स्वतंत्रता,
• "अस्थायी" गतिशील रूप से बनाए गए लिंक के माध्यम से पहुंच नियंत्रण और अनुप्रयोगों की सुरक्षित स्थापना का केंद्रीकरण,
• विस्तार योग्य कार्यक्षमता (अर्थात, यदि आवश्यक हो तो विकास टीम, मौजूदा एप्लिकेशन में लापता कार्यों को एकीकृत कर सकती है)।

परीक्षण

अब हम एप्लिकेशन के प्री-रिलीज़ परीक्षण के बारे में बात करेंगे परीक्षण उड़ान.

डाउनलोड करने के लिए आवश्यक शर्तें ऐप स्टोर हस्ताक्षर प्रोफ़ाइल का प्रकार और जेनरेट की गई एपीआई कुंजियों की उपस्थिति हैं।

एप्लिकेशन डाउनलोड करने के कई तरीके हैं:

• Xcode (आयोजक) के माध्यम से,
• अल्टूल के माध्यम से,
• Xcode (अब ट्रांसपोर्टर) के पुराने संस्करणों के लिए एप्लिकेशन लोडर के माध्यम से।

स्वचालित डाउनलोडिंग के लिए, अल्टूल का उपयोग किया जाता है, जिसमें दो प्राधिकरण विधियाँ भी हैं:

• ऐप-विशिष्ट पासवर्ड,
• एपीआई कुंजी।

एपीआई कुंजी का उपयोग करके एप्लिकेशन डाउनलोड करना बेहतर है।

एपीआई कुंजी प्राप्त करने के लिए, पर जाएँ लिंक और एक कुंजी उत्पन्न करें. *.p8 प्रारूप में कुंजी के अलावा, हमें दो मापदंडों की आवश्यकता होगी: जारीकर्ताआईडी और कीआईडी।

इसके बाद, डाउनलोड की गई कुंजी को बिल्ड सर्वर पर आयात करें:

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 एपीआई कुंजी पीढ़ी पृष्ठ से फ़ील्ड मान हैं।

अगला, सफल सत्यापन पर, हम एप्लिकेशन को कमांड के साथ लोड करते हैं --upload-app समान मापदंडों के साथ.

एप्लिकेशन का परीक्षण एक या दो दिनों के भीतर ऐप्पल द्वारा किया जाएगा और फिर बाहरी परीक्षकों के लिए उपलब्ध हो जाएगा: उन्हें इंस्टॉलेशन के लिए लिंक ईमेल किए जाएंगे।

अल्टूल के माध्यम से किसी एप्लिकेशन को डाउनलोड करने का दूसरा तरीका ऐप-विशिष्ट पासवर्ड का उपयोग करना है।

ऐप-विशिष्ट पासवर्ड प्राप्त करने के लिए आपको यहां जाना होगा लिंक और इसे सुरक्षा अनुभाग में उत्पन्न करें।

इसके बाद, आपको इस पासवर्ड के साथ किचेन में एक बिल्ड सर्वर रिकॉर्ड बनाना चाहिए। Xcode के संस्करण 11 से यह कमांड के साथ किया जा सकता है:

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

कहाँ:

$DeveloperName — Apple सेवाओं में लॉग इन करने के लिए उपयोग किए जाने वाले iOS डेवलपर खाते का नाम।

$AppPswd - ऐप-विशिष्ट पासवर्ड जेनरेट किया गया।

इसके बाद, हम एएससी-प्रदाता पैरामीटर का मान प्राप्त करते हैं और कमांड के साथ पासवर्ड आयात की सफलता की जांच करते हैं:

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

हमें आउटपुट मिलता है:

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

जैसा कि आप देख सकते हैं, आवश्यक संक्षिप्त नाम मान (एएससी-प्रदाता) $TeamID पैरामीटर से मेल खाता है जिसका उपयोग हमने एप्लिकेशन बनाते समय किया था।

एप्लिकेशन को सत्यापित करने और TestFlight में लोड करने के लिए, कमांड का उपयोग करें:

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

एक पैरामीटर मान के रूप में -p आप मूल्य ले सकते हैं $AppPswd अनएन्क्रिप्टेड (स्पष्ट) रूप में।

हालाँकि, जैसा कि पहले ही उल्लेख किया गया है, प्रदर्शन के दृष्टिकोण से, अल्टूल प्राधिकरण के लिए एपीआई कुंजी चुनना बेहतर है, क्योंकि एक्सकोड के विभिन्न संस्करणों में कुछ समस्याएं हैं ("नहीं दिखता" किचेन, अपलोड के दौरान प्राधिकरण त्रुटियां, आदि)।

वास्तव में बस इतना ही। मैं चाहता हूं कि ऐप स्टोर में सभी लोग सफल बिल्ड और परेशानी मुक्त रिलीज में शामिल हों।

स्रोत: www.habr.com