iOS એપ્લિકેશન બનાવવા અને પહોંચાડવાની સુવિધાઓ

આ લેખમાં, અમે iOS એપ્લીકેશનને એસેમ્બલ કરવાનો અને વપરાશકર્તાઓને પહોંચાડવાનો અનુભવ શેર કરીએ છીએ, જે પ્લારિયમ ક્રાસ્નોડાર સ્ટુડિયોએ CI/CDને ડિબગ કરવાની પ્રક્રિયામાં સંચિત કર્યો છે.

તાલીમ

દરેક વ્યક્તિ કે જે એક રીતે અથવા અન્ય રીતે એપલ ઉપકરણો માટે એપ્લિકેશનના વિકાસમાં સામેલ છે તેણે પહેલાથી જ ઈન્ફ્રાસ્ટ્રક્ચરની વિવાદાસ્પદ સગવડની પ્રશંસા કરી છે. મુશ્કેલીઓ દરેક જગ્યાએ જોવા મળે છે: વિકાસકર્તા પ્રોફાઇલ મેનૂથી ડીબગ અને બિલ્ડ ટૂલ્સ સુધી.

ઇન્ટરનેટ પર "મૂળભૂત" વિશે પુષ્કળ લેખો છે, તેથી અમે મુખ્ય વસ્તુને પ્રકાશિત કરવાનો પ્રયાસ કરીશું. તમારી એપ્લિકેશન સફળતાપૂર્વક બનાવવા માટે તમારે જે જોઈએ છે તે અહીં છે:

• વિકાસકર્તા ખાતું;
• બિલ્ડ સર્વર તરીકે કામ કરતું macOS-આધારિત ઉપકરણ;
• પેદા વિકાસકર્તા પ્રમાણપત્ર, જેનો ઉપયોગ અરજી પર સહી કરવા માટે વધુ કરવામાં આવશે;
• અનન્ય સાથે એપ્લિકેશન બનાવી ID (બંડલ આઇડેન્ટિફાયરનું મહત્વ નોંધવું જોઈએ, કારણ કે વાઇલ્ડકાર્ડ ID નો ઉપયોગ એપ્લિકેશનના ઘણા કાર્યોનો ઉપયોગ કરવાનું અશક્ય બનાવે છે, ઉદાહરણ તરીકે: સંકળાયેલ ડોમેન્સ, પુશ સૂચનાઓ, Apple સાઇન ઇન અને અન્ય);
• પ્રોફાઇલ અરજી સહીઓ.

વિકાસકર્તા પ્રમાણપત્ર કોઈપણ macOS ઉપકરણ પર કીચેન દ્વારા જનરેટ કરવું આવશ્યક છે. પ્રમાણપત્રનો પ્રકાર ખૂબ જ મહત્વપૂર્ણ છે. એપ્લિકેશન પર્યાવરણ (દેવ, ક્યુએ, સ્ટેજીંગ, ઉત્પાદન) પર આધાર રાખીને તે (વિકાસ અથવા વિતરણ) અલગ હશે, જેમ કે એપ્લિકેશન હસ્તાક્ષર પ્રોફાઇલનો પ્રકાર.

પ્રોફાઇલના મુખ્ય પ્રકારો:

• વિકાસ - વિકાસ ટીમની અરજી પર હસ્તાક્ષર કરવા માટે બનાવાયેલ, વિકાસ પ્રમાણપત્રનો ઉપયોગ કરવામાં આવે છે (પ્રકારનું નામ iPhone ડેવલપર: XXXXX);
• એડ હોક - પરીક્ષણ એપ્લિકેશન પર હસ્તાક્ષર કરવા અને QA વિભાગ દ્વારા આંતરિક ચકાસણી માટે બનાવાયેલ, વિકાસકર્તાના વિતરણ પ્રમાણપત્રનો ઉપયોગ કરવામાં આવે છે (પ્રકારનું નામ iPhone વિતરણ: XXXXX);
• એપ સ્ટોર - ટેસ્ટફ્લાઇટ દ્વારા બાહ્ય પરીક્ષણ માટે રિલીઝ બિલ્ડ અને એપ સ્ટોર પર અપલોડ કરવા માટે, વિકાસકર્તાના વિતરણ પ્રમાણપત્રનો ઉપયોગ કરવામાં આવે છે.

ડેવલપમેન્ટ અને એડ હોક પ્રોફાઇલ્સ જનરેટ કરતી વખતે, તે પણ સૂચવવામાં આવે છે ઉપકરણ યાદી, જેના પર તમે બિલ્ડ ઇન્સ્ટોલ કરી શકો છો, જે તમને વપરાશકર્તાઓ માટે ઍક્સેસને વધુ પ્રતિબંધિત કરવાની મંજૂરી આપે છે. એપ સ્ટોર પ્રોફાઇલમાં ઉપકરણોની કોઈ સૂચિ નથી, કારણ કે બંધ બીટા પરીક્ષણ દરમિયાન ઍક્સેસ નિયંત્રણ ટેસ્ટફ્લાઇટ દ્વારા નિયંત્રિત કરવામાં આવે છે, જેની પછીથી ચર્ચા કરવામાં આવશે.

સ્પષ્ટતા માટે, તમે વિકાસકર્તાની પ્રોફાઇલને નીચેના કોષ્ટકના રૂપમાં રજૂ કરી શકો છો. આ એસેમ્બલી માટે આપણને કયા પરિમાણોની જરૂર છે અને તે ક્યાંથી મેળવવી તે સમજવામાં સરળ બનાવે છે.

વિધાનસભા

પ્રોજેક્ટ અને પર્યાવરણ દ્વારા એસેમ્બલીઓને અલગ કરવાનું સરળ બનાવવા માટે, અમે પ્રોફાઇલ નામોનો ઉપયોગ કરીએ છીએ જેમ કે ${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 - એપ્લિકેશન પર સહી કરવા માટે પ્રોફાઇલ ID, જે આદેશ સાથે મેળવી શકાય છે:

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 — એપ્લિકેશન ID, જે એપ્લિકેશન સેટિંગ્સમાં ઉલ્લેખિત છે. તમે આદેશ સાથે તપાસ કરી શકો છો:

defaults read $ProjectDir/Info CFBundleIdentifier

$DevAccName и $ProfileId — વિકાસકર્તાનું નામ અને હસ્તાક્ષર પ્રોફાઇલ ID સેટિંગ્સ કે જે અગાઉ ઉપયોગમાં લેવાતી હતી અને નિકાસ સેટિંગ્સમાંના મૂલ્યો સાથે મેળ ખાતી હોવી જોઈએ.

$TeamID — ડેવલપરના નામ પછી કૌંસમાં દસ-અંકનું ID, ઉદાહરણ: 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

વિકાસ અને પરીક્ષણ વિભાગોની જરૂરિયાતો માટે, પ્લેરિયમે તેની પોતાની બિલ્ડ ઇન્સ્ટોલેશન એપ્લિકેશન બનાવી છે, જે અમને આપે છે:

• સ્વાયત્તતા અને સ્વતંત્રતા,
• એક્સેસ કંટ્રોલનું કેન્દ્રિયકરણ અને "કામચલાઉ" ગતિશીલ રીતે બનાવેલ લિંક્સ દ્વારા એપ્લિકેશનનું સુરક્ષિત ઇન્સ્ટોલેશન,
• વિસ્તૃત કાર્યક્ષમતા (એટલે ​​કે, વિકાસ ટીમ, જો જરૂરી હોય તો, હાલની એપ્લિકેશનમાં ગુમ થયેલ કાર્યોને એકીકૃત કરી શકે છે).

પરીક્ષણ

હવે અમે ઉપયોગ કરીને એપ્લિકેશનના પ્રી-રીલીઝ પરીક્ષણ વિશે વાત કરીશું TestFlight.

ડાઉનલોડ કરવા માટે જરૂરી શરતો એપ સ્ટોર હસ્તાક્ષર પ્રોફાઇલનો પ્રકાર અને જનરેટ કરેલ API કીની હાજરી છે.

એપ્લિકેશન ડાઉનલોડ કરવાની ઘણી રીતો છે:

• Xcode (ઓર્ગેનાઇઝર) દ્વારા,
• અલ્ટૂલ દ્વારા,
• Xcode (હવે ટ્રાન્સપોર્ટર) ના જૂના સંસ્કરણો માટે એપ્લિકેશન લોડર દ્વારા.

સ્વચાલિત ડાઉનલોડિંગ માટે, અલ્ટૂલનો ઉપયોગ થાય છે, જેમાં બે અધિકૃતતા પદ્ધતિઓ પણ છે:

• એપ્લિકેશન-વિશિષ્ટ પાસવર્ડ,
• API કી.

API કીનો ઉપયોગ કરીને એપ્લિકેશન ડાઉનલોડ કરવાનું વધુ સારું છે.

API કી મેળવવા માટે, પર જાઓ કડી અને કી જનરેટ કરો. *.p8 ફોર્મેટમાં કી ઉપરાંત, અમને બે પરિમાણોની જરૂર પડશે: IssuerID અને KeyID.

આગળ, બિલ્ડ સર્વર પર ડાઉનલોડ કરેલ કી આયાત કરો:

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 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-પ્રદાતા) એ $TeamID પરિમાણ સાથે સુસંગત છે જેનો ઉપયોગ અમે એપ્લિકેશન બનાવતી વખતે કર્યો હતો.

ટેસ્ટફ્લાઇટમાં એપ્લિકેશનને માન્ય કરવા અને લોડ કરવા માટે, આદેશનો ઉપયોગ કરો:

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

પરિમાણ મૂલ્ય તરીકે -p તમે મૂલ્ય લઈ શકો છો $AppPswd એનક્રિપ્ટેડ (સ્પષ્ટ) સ્વરૂપમાં.

જો કે, પહેલેથી જ ઉલ્લેખ કર્યો છે તેમ, પ્રદર્શનના દૃષ્ટિકોણથી, અલ્ટૂલ અધિકૃતતા માટે API કી પસંદ કરવાનું વધુ સારું છે, કારણ કે Xcodeના વિવિધ સંસ્કરણોમાં ચોક્કસ સમસ્યાઓ છે (કીચેન "જોતું નથી", અપલોડ દરમિયાન અધિકૃતતા ભૂલો, વગેરે).

તે બધા છે, વાસ્તવમાં. હું ઈચ્છું છું કે એપ સ્ટોરમાં સફળ બિલ્ડ અને મુશ્કેલી-મુક્ત રીલીઝ સામેલ હોય.

સોર્સ: www.habr.com