תכונות של בנייה ואספקה ​​של יישומי iOS

במאמר זה, אנו חולקים את החוויה של הרכבה ואספקה ​​של יישומי iOS למשתמשים, אשר צבר הסטודיו של Plarium Krasnodar בתהליך של איתור באגים CI/CD.

הדרכה

כל אדם שעוסק בדרך זו או אחרת בפיתוח אפליקציות למכשירי אפל כבר העריך את הנוחות השנויה במחלוקת של התשתית. קשיים נמצאים בכל מקום: מתפריט פרופיל המפתח ועד לכלי ניפוי ובנייה.

יש הרבה מאמרים על ה"יסודות" באינטרנט, אז ננסה להדגיש את העיקר. הנה מה שאתה צריך כדי לבנות את היישום שלך בהצלחה:

• חשבון מפתח;
• מכשיר מבוסס macOS הפועל כשרת build;
• נוצר תעודת מפתח, אשר ישמש עוד לחתימה על הבקשה;
• נוצר יישום עם ייחודי ID (יש לציין את החשיבות של מזהה החבילה, מכיוון שהשימוש במזהה כללי לא מאפשר להשתמש בפונקציות רבות של האפליקציה, למשל: דומיינים משויכים, הודעות דחיפה, Apple Sign In ואחרות);
• פרופיל חתימות אפליקציה.

יש להפיק אישור מפתח באמצעות מחזיק מפתחות בכל מכשיר macOS. סוג התעודה חשוב מאוד. בהתאם לסביבת האפליקציה (Dev, QA, Staging, Production) זה יהיה שונה (פיתוח או הפצה), וכך גם סוג פרופיל חתימת האפליקציה.

סוגי פרופילים עיקריים:

• פיתוח - מיועד לחתימה על האפליקציה של צוות הפיתוח, נעשה שימוש בתעודת פיתוח (שם סוג אייפון מפתח: XXXXX);
• אד הוק - מיועד לחתימה על אפליקציית בדיקה ואימות פנימי על ידי מחלקת QA, נעשה שימוש בתעודת הפצה של המפתח (שם סוג iPhone Distribution: XXXXX);
• App Store - שחרור build לבדיקה חיצונית באמצעות TestFlight והעלאה ל-App Store, נעשה שימוש בתעודת ההפצה של המפתח.

בעת יצירת פרופילי פיתוח ואד הוק, זה גם מצוין רשימת המכשירים, שבו אתה יכול להתקין build, המאפשר לך להגביל עוד יותר את הגישה למשתמשים. אין רשימה של מכשירים בפרופיל App Store, שכן בקרת הגישה במהלך בדיקות בטא סגורות מטופלת על ידי TestFlight, עליה נדון בהמשך.

לשם הבהירות, אתה יכול להציג את פרופיל המפתח בצורה של טבלה למטה. כך קל יותר להבין אילו פרמטרים אנו צריכים להרכבה ומאיפה להשיג אותם.

העצרת

כדי להקל על הפרדת מכלולים לפי פרויקט וסביבה, אנו משתמשים בשמות פרופילים כמו ${ProjectName}_${Instance}, כלומר, שם הפרויקט + מופע (תלוי בסביבת האפליקציה: Dev, QA, GD, Staging, Live וכן הלאה).

כאשר מיובא לשרת ה-build, הפרופיל משנה את שמו למזהה ייחודי ומועבר לתיקיה /Users/$Username/Library/MobileDevice/Provisioning Profiles (איפה $Username מתאים לשם חשבון המשתמש של שרת ה-build).

ישנן שתי דרכים לבנות קובץ *.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 - שם חשבון המפתח, שניתן לאמת במחזיק מפתחות (מפתח אייפון: 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//'

אם האפליקציה משתמשת בפרופיל נוסף (לדוגמה, עבור הודעות 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"

עם זאת, שיטה זו נחשבת למיושנת מנקודת מבטה של ​​אפל. רלוונטי להשיג *.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 - אד-הוק, ועבור App Store - חנות אפליקציות.

$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 מתבצעת בשני שלבים:

1. קבלת מניפסט התקנת האפליקציה דרך שירות הפריטים.
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

לצרכי מחלקות הפיתוח והבדיקה, פלריום יצרה יישום התקנת בנייה משלה, המעניק לנו:

• אוטונומיה ועצמאות,
• ריכוז בקרת גישה והתקנה מאובטחת של יישומים באמצעות קישורים "זמניים" שנוצרו באופן דינמי,
• פונקציונליות הניתנת להרחבה (כלומר, צוות הפיתוח, במידת הצורך, יכול לשלב פונקציות חסרות באפליקציה קיימת).

בדיקה

כעת נדבר על בדיקות טרום שחרור של האפליקציה באמצעות TestFlight.

התנאים הנדרשים להורדה הם סוג פרופיל החתימה של App Store והנוכחות של מפתחות API שנוצרו.

ישנן מספר דרכים להוריד את האפליקציה:

• באמצעות Xcode (מארגן),
• דרך altool,
• באמצעות 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 עם אותם פרמטרים.

האפליקציה תיבדק על ידי אפל תוך יום או יומיים ולאחר מכן תהפוך לזמינה לבודקים חיצוניים: הם יקבלו קישורים בדוא"ל להתקנה.

דרך נוספת להוריד אפליקציה דרך altool היא להשתמש בסיסמה ספציפית לאפליקציה.

כדי לקבל את הסיסמה הספציפית לאפליקציה עליך לעבור אל קשר והפק אותו בסעיף אבטחה.

לאחר מכן, עליך ליצור רשומת שרת לבנות במחזיק מפתחות עם סיסמה זו. מגרסה 11 של Xcode ניתן לעשות זאת עם הפקודה:

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