פרסום אפליקציות iOS ל-App Store עם GitLab ו-fastlane

כיצד GitLab עם fastlane אוספת, חותמת ומפרסמת יישומי iOS ל-App Store.

היה לנו לאחרונה פוסט על איך לבנות ולהפעיל במהירות אפליקציית אנדרואיד עם GitLab ו מסלול מהיר. כאן נראה כיצד לבנות ולהפעיל אפליקציית iOS ולפרסם אותה ב-TestFlight. תראה כמה זה מגניב אני מבצע שינוי ב-iPad Pro עם GitLab Web IDE, אני לוקח את המכלול ומקבל עדכון לגרסת הבדיקה של האפליקציה באותו iPad Pro שבו פיתחתי אותה.

כאן ניקח אפליקציית iOS פשוטה ב- Swift, שאיתו הקלטתי את הסרטון.

כמה מילים על תצורת Apple Store

נצטרך אפליקציית App Store, אישורי הפצה ופרופיל אספקה ​​כדי לקשר הכל יחד.

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

האפליקציות שלי

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

פרופיל אתחול

בנוסף להגדרת האפליקציה, אתה צריך מפתחות הפצה ופיתוח של iOS שנוצרו בקטע אישורים, מזהים ופרופילים של מסוף המפתחים של Apple. ניתן לשלב את כל האישורים הללו לפרופיל הקצאה.

משתמשים שיאומתו צריכים להיות מסוגלים ליצור אישורים, אחרת השלבים תעודה ואנחה תראה שגיאה.

אפשרויות אחרות

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

בדוגמה זו אני משתמש בגישה תעודה ואנחה, אבל לשימוש אמיתי זה כנראה מתאים יותר להתאים.

הכנת GitLab ו-fastlane

הכנת CI Runner

לאחר שאספנו את כל הנתונים הללו, אנו עוברים לתצורה של הרץ GitLab במכשיר ה-MacOS. למרבה הצער, אתה יכול ליצור אפליקציות iOS רק ב-MacOS. אבל הכל יכול להשתנות, ואם אתם מצפים להתקדמות בתחום הזה, שימו עין על פרויקטים כמו xcbuild и סִימָן, והמשימה הפנימית שלנו gitlab-ce#57576.

הגדרת הרץ היא פשוטה מאוד. עקוב אחר הנוכחי הוראות להגדרת GitLab Runner ב-macOS.

הערה. הרץ חייב להשתמש בתוכנת הפעלה shell. זה נדרש כדי לבנות iOS ב-macOS לעבוד ישירות כמשתמש ולא דרך קונטיינרים. אם אתה משתמש shell, בנייה ובדיקות מבוצעות כמשתמש הרץ, ישירות על מארח הבנייה. זה לא בטוח כמו מכולות, אז עדיף לגלוש תיעוד בטיחותאז אתה לא מפספס שום דבר.

sudo curl --output /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-darwin-amd64
sudo chmod +x /usr/local/bin/gitlab-runner
cd ~
gitlab-runner install
gitlab-runner start

Apple Keychain חייב להיות מוגדר במארח זה עם גישה למפתחות ש-Xcode צריך לבנות. הדרך הקלה ביותר לבדוק זאת היא להיכנס בתור המשתמש שיריץ את ה-build ולנסות לבנות אותו באופן ידני. אם המערכת מבקשת גישה למחזיק מפתחות, בחר Always Allow for CI to work. אולי שווה להיכנס ולצפות בשני הצינורות הראשונים כדי לוודא שהם לא מבקשים יותר את מחזיק המפתחות. הצרה היא שאפל לא מקלה עלינו להשתמש במצב אוטומטי, אבל ברגע שתתחיל, הכל יהיה בסדר.

init מהיר

כדי להשתמש ב-fastlane בפרויקט, הפעל fastlane init. רק תעקוב הוראות להתקנה והרצה של Fastlane, במיוחד בקטע על קובץ Gem, כי אנחנו צריכים השקה מהירה וצפויה דרך צינור CI אוטומטי.

בספריית הפרויקט שלך, הפעל את הפקודות הבאות:

xcode-select --install
sudo gem install fastlane -NV
# Alternatively using Homebrew
# brew cask install fastlane
fastlane init

fastlane יבקש תצורה בסיסית ולאחר מכן תיצור תיקיית fastlane בפרויקט עם שלושה קבצים:

1. fastlane/Appfile

אין כאן שום דבר מסובך. רק ודא שה-Apple ID ומזהה האפליקציה שלך נכונים.

app_identifier("com.vontrance.flappybird") # The bundle identifier of your app
apple_id("[email protected]") # Your Apple email address

2. fastlane/Fastfile

Fastfile מגדיר את שלבי הבנייה. אנו משתמשים בהרבה תכונות מובנות של fastlane, כך שהכל ברור גם כאן. אנחנו יוצרים שורה אחת שמקבלת אישורים, מבצעת את ההרכבה ומעלה אותה ל-TestFlight. ניתן לחלק את התהליך הזה למשימות שונות במידת הצורך. כל הפעולות האלה (get_certificates, get_provisioning_profile, gym и upload_to_testflight) כבר כלולים ב-fastlane.

פעילות get_certificates и get_provisioning_profile קשור לגישת החתימה תעודה ואנחה. אם אתה משתמש להתאים או מה שלא יהיה, בצע שינויים.

default_platform(:ios)

platform :ios do
  desc "Build the application"
  lane :flappybuild do
    get_certificates
    get_provisioning_profile
    gym
    upload_to_testflight
  end
end

3. fastlane/Gymfile

זהו קובץ אופציונלי, אבל יצרתי אותו באופן ידני כדי לשנות את ספריית הפלט המוגדרת כברירת מחדל ולמקם את הפלט בתיקייה הנוכחית. זה מפשט את CI. אם אתה מעוניין, קרא על gym והפרמטרים שלו ב תיעוד.

https://docs.fastlane.tools/actions/gym/

שלנו .gitlab-ci.yml

אז יש לנו רץ CI לפרויקט, ואנחנו מוכנים לבדוק את הצינור. בוא נראה מה יש לנו .gitlab-ci.yml:

stages:
  - build

variables:
  LC_ALL: "en_US.UTF-8"
  LANG: "en_US.UTF-8"
  GIT_STRATEGY: clone

build:
  stage: build
  script:
    - bundle install
    - bundle exec fastlane flappybuild
  artifacts:
    paths:
    - ./FlappyBird.ipa

Все отлично! הגדרנו את הפורמט ל-UTF-8 עבור fastlane לפי הצורך, השתמש באסטרטגיה clone עם תוכנית הפעלה shell, כדי שיהיה לנו מקום עבודה נקי לכל הרכבה, ופשוט מתקשרים flappybuild fastlane, כפי שניתן לראות לעיל. כתוצאה מכך, אנו מקבלים את ההרכבה, החתימה והפריסה של ההרכבה העדכנית ביותר ב-TestFlight.

אנחנו גם מקבלים את החפץ ושומרים אותו עם ההרכבה. שימו לב שהפורמט .ipa הוא קובץ הפעלה חתום של ARM שאינו פועל בסימולטור. אם אתה רוצה פלט עבור הסימולטור, פשוט הוסף את יעד הבנייה שמייצר אותו, ולאחר מכן כלול אותו בנתיב החפץ.

משתני סביבה אחרים

יש כאן כמה משתני סביבה שגורמים להכל לעבוד.

FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD и FASTLANE_SESSION

נדרש אימות עבור fastlane כדי לבצע אימות ב-App Store ולהעלות ל-TestFlight. לשם כך, צור סיסמה עבור האפליקציה שתשמש ב-CI. פרטים כאן.

אם יש לך אימות דו-גורמי, צור משתנה FASTLANE_SESSION (הוראות שם).

FASTLANE_USER и FASTLANE_PASSWORD

כי תעודה ואנחה הנקרא פרופיל האתחול ואישורים לפי בקשה, עליך להגדיר את המשתנים FASTLANE_USER и FASTLANE_PASSWORD. פרטים כאן. זה לא הכרחי אם אתה משתמש בשיטת חתימה אחרת.

לסיכום

אתה יכול לראות איך הכל עובד בדוגמה הפשוטה שלי.

אני מקווה שזה היה מועיל ונתן לך השראה לעבוד עם בניית iOS בפרויקט GitLab. הנה עוד אחד עצות CI עבור fastlane, ליתר ביטחון. אולי תרצה להשתמש CI_BUILD_ID (עבור בנייה מצטברת) ל הגדלה אוטומטית של גרסה.

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

ספר לנו בתגובות על החוויה שלך ושתף את הרעיונות שלך לשיפור GitLab לפיתוח אפליקציות ל-iOS.

מקור: www.habr.com