iOS अनुप्रयोगहरू निर्माण र वितरण गर्ने सुविधाहरू

यस लेखमा, हामी प्रयोगकर्ताहरूलाई iOS अनुप्रयोगहरू जम्मा गर्ने र डेलिभर गर्ने अनुभव साझा गर्छौं, जुन प्लारियम क्रास्नोडार स्टुडियोले CI/CD डिबग गर्ने प्रक्रियामा जम्मा गरेको छ।

प्रशिक्षण

प्रत्येक व्यक्ति जो एक तरिका वा अर्कोमा एप्पल उपकरणहरूको लागि अनुप्रयोगहरूको विकासमा संलग्न छ, पहिले नै पूर्वाधारको विवादास्पद सुविधाको प्रशंसा गरेको छ। कठिनाइहरू जताततै भेटिन्छन्: विकासकर्ता प्रोफाइल मेनुदेखि डिबग र निर्माण उपकरणहरू।

इन्टरनेटमा "आधारभूत" बारे धेरै लेखहरू छन्, त्यसैले हामी मुख्य कुरा हाइलाइट गर्ने प्रयास गर्नेछौं। तपाइँलाई तपाइँको आवेदन सफलतापूर्वक निर्माण गर्न को लागी आवश्यक छ यहाँ छ:

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

एक विकासकर्ता प्रमाणपत्र कुनै पनि macOS उपकरणमा कीचेन मार्फत उत्पन्न हुनुपर्छ। प्रमाणपत्र को प्रकार धेरै महत्त्वपूर्ण छ। आवेदन वातावरण (देव, QA, स्टेजिङ, उत्पादन) मा निर्भर गर्दछ, यो फरक हुनेछ (विकास वा वितरण), जस्तै आवेदन हस्ताक्षर प्रोफाइल को प्रकार हुनेछ।

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

• विकास - विकास टोलीको आवेदनमा हस्ताक्षर गर्नको लागि, विकास प्रमाणपत्र प्रयोग गरिन्छ (प्रकार नाम आईफोन विकासकर्ता: XXXXX);
• Ad Hoc - QA विभागद्वारा परीक्षण आवेदन र आन्तरिक प्रमाणीकरणमा हस्ताक्षर गर्नको लागि, विकासकर्ताको वितरण प्रमाणपत्र प्रयोग गरिन्छ (प्रकार नाम iPhone वितरण: XXXXX);
• एप स्टोर - टेस्टफ्लाइट मार्फत बाह्य परीक्षणको लागि रिलीज निर्माण र एप स्टोरमा अपलोड गर्न, विकासकर्ताको वितरण प्रमाणपत्र प्रयोग गरिन्छ।

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

स्पष्टताको लागि, तपाइँ तलको तालिकाको रूपमा विकासकर्ताको प्रोफाइल प्रस्तुत गर्न सक्नुहुन्छ। यसले हामीलाई एसेम्बलीका लागि कुन प्यारामिटरहरू चाहिन्छ र कहाँबाट प्राप्त गर्ने भनेर बुझ्न सजिलो बनाउँछ।

विधानसभा

यसलाई परियोजना र वातावरण द्वारा विभाजन गर्न सजिलो बनाउनको लागि, हामी प्रोफाइल नामहरू प्रयोग गर्दछौं ${ProjectName}_${Instance}, त्यो हो, परियोजना नाम + उदाहरण (अनुप्रयोग वातावरणमा निर्भर गर्दछ: Dev, QA, GD, स्टेजिङ, लाइभ, र यस्तै)।

बिल्ड सर्भरमा आयात गर्दा, प्रोफाइलले आफ्नो नामलाई अद्वितीय ID मा परिवर्तन गर्छ र फोल्डरमा सारिन्छ /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"

यद्यपि, यो विधि एप्पलको दृष्टिकोणबाट अप्रचलित मानिन्छ। यो अनुप्रयोग अभिलेखबाट निर्यात गरेर *.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 - एप्लिकेसन आईडी, जुन एप्लिकेसन सेटिङहरूमा निर्दिष्ट गरिएको छ। तपाइँ आदेश संग जाँच गर्न सक्नुहुन्छ:

defaults read $ProjectDir/Info CFBundleIdentifier

$DevAccName и $ProfileId - विकासकर्ताको नाम र हस्ताक्षर प्रोफाइल आईडी सेटिङहरू जुन पहिले प्रयोग गरिएको थियो र निर्यात सेटिङहरूमा मानहरू मिल्नुपर्छ।

$TeamID — विकासकर्ताको नाम पछि कोष्ठकमा दस-अङ्कको ID, उदाहरण: iPhone विकासकर्ता: …… (XXXXXXXXXX); Keychain मा जाँच गर्न सकिन्छ।

अर्को, निर्यात आदेश प्रयोग गरेर, हामी आवश्यक *.ipa फाइल प्राप्त गर्छौं:

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

Доставка

अब सङ्कलन फाइल अन्तिम प्रयोगकर्तालाई डेलिभर गर्न आवश्यक छ, त्यो उपकरणमा स्थापित छ।

विकास र तदर्थ निर्माणहरू वितरण गर्नका लागि धेरै सेवाहरू छन्, जस्तै HockeyApp, AppBlade र अन्य, तर यस लेखमा हामी अनुप्रयोगहरू वितरणको लागि स्ट्यान्डअलोन सर्भरको बारेमा कुरा गर्नेछौं।

IOS को लागी अनुप्रयोग स्थापना 2 चरणहरूमा हुन्छ:

1. वस्तु सेवा मार्फत आवेदन स्थापना प्रकट प्राप्त गर्दै।
2. HTTPS मार्फत manifest मा निर्दिष्ट जानकारी अनुसार *.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

विकास र परीक्षण विभागहरूको आवश्यकताहरूको लागि, Plarium ले आफ्नै निर्माण स्थापना अनुप्रयोग सिर्जना गरेको छ, जसले हामीलाई दिन्छ:

• स्वायत्तता र स्वतन्त्रता,
• पहुँच नियन्त्रणको केन्द्रीकरण र "अस्थायी" गतिशील रूपमा सिर्जना गरिएका लिङ्कहरू मार्फत अनुप्रयोगहरूको सुरक्षित स्थापना,
• विस्तारयोग्य कार्यक्षमता (अर्थात, विकास टोलीले आवश्यक भएमा अवस्थित अनुप्रयोगमा छुटेका कार्यहरूलाई एकीकृत गर्न सक्छ)।

परीक्षण गर्दै

अब हामी प्रयोग गरेर अनुप्रयोगको पूर्व-रिलीज परीक्षणको बारेमा कुरा गर्नेछौं टेस्टफ्लाइट.

डाउनलोड गर्नका लागि आवश्यक सर्तहरू एप स्टोर हस्ताक्षर प्रोफाइलको प्रकार र उत्पन्न API कुञ्जीहरूको उपस्थिति हो।

त्यहाँ अनुप्रयोग डाउनलोड गर्न धेरै तरिकाहरू छन्:

• Xcode (आयोजक) मार्फत,
• altool मार्फत,
• Xcode (अहिले ट्रान्सपोर्टर) को पुरानो संस्करणहरूको लागि एप्लिकेसन लोडर मार्फत।

स्वचालित डाउनलोडको लागि, altool प्रयोग गरिन्छ, जसमा दुई प्राधिकरण विधिहरू पनि छन्:

• एप-विशिष्ट पासवर्ड,
• 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 समान प्यारामिटरहरू संग।

एप एक वा दुई दिन भित्र Apple द्वारा परीक्षण गरिनेछ र त्यसपछि बाह्य परीक्षकहरूको लागि उपलब्ध हुनेछ: तिनीहरूलाई स्थापनाको लागि लिङ्कहरू इमेल गरिनेछ।

altool मार्फत एप्लिकेसन डाउनलोड गर्ने अर्को तरिका एप-विशिष्ट पासवर्ड प्रयोग गर्नु हो।

एप-विशिष्ट पासवर्ड प्राप्त गर्न तपाईंले जानु पर्छ लिङ्क र यसलाई सुरक्षा खण्डमा उत्पन्न गर्नुहोस्।

अर्को, तपाईंले यो पासवर्डको साथ किचेनमा बिल्ड सर्भर रेकर्ड सिर्जना गर्नुपर्छ। Xcode को संस्करण 11 बाट यो आदेश संग गर्न सकिन्छ:

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

कहां

$DeveloperName - एप्पल सेवाहरूमा लग इन गर्न प्रयोग गरिने आईओएस विकासकर्ता खाताको नाम।

$AppPswd - उत्पन्न एप-विशिष्ट पासवर्ड।

अर्को, हामी asc-प्रदायक प्यारामिटरको मान पाउँछौं र आदेशको साथ पासवर्ड आयातको सफलता जाँच गर्छौं:

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

हामीले आउटपुट पाउँछौं:

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

तपाईले देख्न सक्नुहुन्छ, आवश्यक छोटो नाम मान (asc-प्रदायक) $TeamID प्यारामिटरसँग मेल खान्छ जुन हामीले अनुप्रयोग निर्माण गर्दा प्रयोग गर्यौं।

TestFlight मा अनुप्रयोग प्रमाणित गर्न र लोड गर्न, आदेश प्रयोग गर्नुहोस्:

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

प्यारामिटर मानको रूपमा -p तपाईं मूल्य लिन सक्नुहुन्छ $AppPswd अनइन्क्रिप्टेड (स्पष्ट) फारममा।

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

त्यो सबै हो, वास्तवमा। म एप स्टोरमा सफल निर्माण र समस्या-मुक्त रिलीजहरू समावेश गर्न चाहन्छु।

स्रोत: www.habr.com