קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
אם רוצים להפיץ גרסאות ad hoc של iOS באמצעות App Distribution, צריך לפעול לפי ההוראות במדריך הזה כדי לרשום את המכשירים של הבודקים. גרסת Ad hoc
היא גרסה שלא נחתמה באמצעות פרופיל ארגוני. אפשר להתקין במכשיר גרסת ad hoc רק אם המזהה הייחודי של המכשיר (UDID) כלול בפרופיל ההקצאה של הגרסה.
כשבודק מאשר הזמנה לבדיקת האפליקציה שלכם, App Distribution מבקש רשות לשתף איתכם, המפתחים, את מזהה המכשיר של הבודק.
לפני הורדת גרסת ה-build האד-הוק, מערכת App Distribution מבקשת מהבודק לרשום את המכשיר שלו. אם הבודק רושם את המכשיר שלו, App Distribution אוסף את ה-UDID מהמכשיר ושולח לכם הודעה באימייל עם ה-UDID.
כשמקבלים אימייל עם UDID, צריך לעדכן את פרופיל ההקצאה עם ה-UDID ולהפיץ גרסה חדשה לבודקים. אפשר לייצא UDID באופן ידני באמצעות מסוף Firebase או Firebase CLI, או לייצא UDID באופן פרוגרמטי באמצעות fastlane.
ייצוא ידני של מזהי מכשירים ייחודיים
מוסיפים את המכשירים לפורטל המפתחים של אפל.
אפשרות 1: לייבא את מספרי ה-UDID של המכשירים כקובץ CSV.
בכרטיסייה Testers & Groups (בודקים וקבוצות) בלוח הבקרה App Distribution, בוחרים באפשרות All testers (כל הבודקים) ולוחצים על Export Apple UDIDs (ייצוא של מספרי UDID של אפל) כדי להוריד קובץ CSV. לאחר מכן, מייבאים את הקובץ אל חשבון הפיתוח של Apple באמצעות האפשרות Register Multiple Devices (רישום של כמה מכשירים). מידע נוסף זמין במאמר בנושא הפצת האפליקציה למכשירים רשומים.
שימו לב: יכול להיות שחשבון הפיתוח שלכם ב-Apple מאפשר ייבוא של מספר מוגבל של מכשירים בשנה.
אפשרות 2: איסוף ומילוי של מספרי ה-UDID באימייל.
בדף Add Devices בפורטל המפתחים של Apple, רושמים את ה-UDID החדש שצוין באימייל שקיבלתם.
מורידים את פרופיל ההקצאה ומשתמשים בו כדי לבנות מחדש את האפליקציה. אם אתם בונים מחדש רק כדי לעדכן את המכשירים הרשומים, אל תעדכנו את מספר הבנייה או הגרסה.
מפיצים מחדש את האפליקציה מ-Firebase Console או מ-CLI.
אם לא משנים את הגרסה, את מספר ה-build או את הקוד של האפליקציה,
App Distribution לא יוצר גרסה חדשה ולא שולח הודעה לבוחנים. אם כבר הפצתם גרסת build עם אותו מספר גרסת build ואותה גרסה, רק משתמשים במכשירים שנרשמו לאחרונה יקבלו התראות באימייל.
ייצוא של מספרי UDID באופן פרוגרמטי באמצעות fastlane
מייצאים את כל מספרי ה-UDID של מכשירי הבדיקה כקובץ CSV מ-fastlane. לדוגמה, יוצרים ומריצים נתיב חדש download_udids:
lane:download_udidsdofirebase_app_distribution_get_udids(app:"<your Firebase app ID>",output_file:"<path to output file>",)end
מייבאים את מספרי ה-UDID אל חשבון המפתחים של Apple באמצעות האפשרות Register Multiple Devices(רישום של כמה מכשירים). מידע נוסף זמין במסמכי התיעוד של Apple.
שימו לב: יכול להיות שחשבון הפיתוח שלכם ב-Apple מאפשר לייבא רק מספר מוגבל של מכשירים בשנה.
מורידים את פרופיל ההקצאה ומשתמשים בו כדי לבנות מחדש את האפליקציה. אם אתם בונים מחדש רק כדי לעדכן את המכשירים הרשומים, אל תעדכנו את מספר הבנייה או הגרסה.
להפיץ מחדש את האפליקציה. אם לא משנים את הגרסה, את מספר ה-build או את הקוד של האפליקציה, App Distribution לא יוצר גרסה חדשה ולא שולח הודעה לבוחנים. אם כבר הפצתם גרסת build עם אותו מספר גרסת build וגרסה, רק משתמשים במכשירים שנרשמו לאחרונה יקבלו התראות באימייל.
קבלת התראות
קבלת התראות ברירת מחדל
כברירת מחדל, Firebase יכול לשלוח App Distributionהתראות על רישום מכשירי iOS חדשיםApp Distribution באימייל.
כדי לקבל התראות לגבי App Distribution באמצעות מנגנון ברירת המחדל הזה, צריך לקבל את ההרשאה firebase.projects.update. ההרשאה הנדרשת הזו כלולה כברירת מחדל בתפקידים הבאים: אדמין ב-Firebase או בעלים או עריכה של הפרויקט.
כברירת מחדל, כל חברי הפרויקט (שיש להם את ההרשאות הנדרשות לקבלת התראות) יקבלו אימייל כשמכשיר iOS חדש יירשם.
הפעלה או השבתה של התראות בחשבון שלכם
אתם יכולים להפעיל או להשבית את ההתראות בחשבון שלכם בלי שזה ישפיע על שאר חברי הפרויקט.App Distribution חשוב לזכור שעדיין צריך את ההרשאות הנדרשות כדי לקבל התראות.
כדי להפעיל או להשבית את ההתראות של App Distribution:
בפינה השמאלית העליונה של Firebase console, עוברים אל notificationsFirebase
alerts.
אחר כך עוברים אל settingsהגדרות ומגדירים את ההעדפה של החשבון לגבי App Distributionהתראות.
הגדרת התראות מתקדמות לשירותי צד שלישי
אפשר גם לשלוח התראות לצוות באמצעות Cloud Functions for Firebase, לערוץ ההתראות המועדף של הצוות.App Distribution לדוגמה, אפשר לכתוב פונקציה שתתעד אירוע התראה על רישום של מכשיר iOS חדש ותפרסם את פרטי ההתראה בשירות של צד שלישי, כמו Discord, Slack או Jira.
כדי לאפשר אוטומציה מלאה של צירוף בודקי iOS חדשים, אפשר לכתוב פונקציה שמוסיפה את ה-UDID של מכשיר iOS חדש לפרופיל ההקצאה של האפליקציה, בונה מחדש את האפליקציה ומפיצה מחדש את האפליקציה עם פרופיל ההקצאה המעודכן.
כדי להגדיר יכולות מתקדמות של התראות באמצעות Cloud Functions for Firebase, פועלים לפי השלבים הבאים:
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-09-06 (שעון UTC)."],[],[],null,["\u003cbr /\u003e\n\nIf you want to distribute ad hoc iOS builds using App Distribution, you must follow\nthis guide to register your testers' devices. An [*ad hoc\nbuild*](https://help.apple.com/xcode/mac/current/#/dev31de635e5)\nis a build not signed with an Enterprise profile. A device can only install an\nad hoc build if the device's unique device identifier (UDID) is included in the\nbuild's provisioning profile.\n\nWhen a tester accepts an invitation to test your app, App Distribution requests\npermission to share the tester's device identifier with you, the developer.\nBefore downloading an ad hoc build, App Distribution asks the tester to register\ntheir device. If the tester registers their device, App Distribution collects the\nUDID from the device and notifies you of the UDID by email.\n\nWhen you receive an email containing a UDID, update your provisioning profile\nwith the UDID and distribute a new build to your testers. You can manually\nexport UDIDs using the [Firebase console or Firebase\nCLI](#manual-export-udids), or you can programmatically export UDIDs using\n[fastlane](#programmatic-export-udids).\n\nManually export UDIDs\n\n1. Add the devices to your Apple developer portal.\n - *Option 1:* Import the device UDIDs as a CSV file.\n\n In the **Testers \\& Groups** tab of the App Distribution dashboard, select\n **All testers** , then click **Export Apple UDIDs**\n to download a CSV file. Next, import the file into your\n [Apple developer account](https://developer.apple.com/account/resources/devices/add)\n using the **Register Multiple Devices** option. To learn more, see\n [Distributing your app to registered devices](https://developer.apple.com/documentation/xcode/distributing_your_app_to_registered_devices).\n\n Note that your Apple developer account may only allow you to import a limited number of\n devices per year.\n - *Option 2:* Collect and enter the UDIDs by email.\n\n On the [Add Devices](https://developer.apple.com/account/resources/devices/add)\n page of the Apple developer portal, register the new UDID specified in the\n email you received.\n2. Add the registered devices to your [provisioning profile](https://developer.apple.com/account/resources/profiles/list).\n3. Download the provisioning profile and use it to rebuild your app. If you are rebuilding only to update the registered devices, don't update the build number or version.\n4. Re-distribute your app from the [Firebase console](https://firebase.google.com/docs/app-distribution/ios/distribute-console#distribute) or [CLI](https://firebase.google.com/docs/app-distribution/ios/distribute-cli#distribute). If you don't change your version, build number, or your app's code, App Distribution does not create a new release and won't notify testers. If you already distributed a build with the same build number and version, only users of newly-registered devices receive notification emails.\n\nProgrammatically export UDIDs using fastlane\n\n1. Export all of your tester device UDIDs as a CSV file from fastlane. For\n example, create and run a new `download_udids` lane:\n\n lane :download_udids do\n firebase_app_distribution_get_udids(\n app: \"\u003cyour Firebase app ID\u003e\",\n output_file: \"\u003cpath to output file\u003e\",\n )\n end\n\n | **Note:** To automate releasing a new build with new UDIDs, see [Distribute your\n | pre-release iOS builds faster with App Distribution and\n | fastlane](https://firebase.google.com/codelabs/appdistribution-udid-collection).\n2. Import the UDID(s) into your [Apple developer account](https://developer.apple.com/account/resources/devices/add)\n using the **Register Multiple Devices** option. To learn more, see [Apple's\n documentation](https://developer.apple.com/documentation/xcode/distributing_your_app_to_registered_devices).\n Note that your Apple developer account may only allow you to import a\n limited number of devices per year.\n\n3. Add the registered devices to your [provisioning profile](https://developer.apple.com/account/resources/profiles/list).\n\n4. Download the provisioning profile and use it to rebuild your app. If you are\n rebuilding only for the purposes of updating the registered devices, don't\n update the build number or version.\n\n5. [Re-distribute your\n app](/docs/app-distribution/ios/distribute-fastlane#distribute). If you\n don't change your version, build number, or your app's code,\n App Distribution does not create a new release and won't notify testers. If you\n already distributed a build with the same build number and version, only\n users of newly-registered devices will receive notification emails.\n\nReceive alerts\n\nGet default alerts\n\nBy default, Firebase can send App Distribution alerts for new iOS device\nregistrations via email.\n\nTo receive App Distribution alerts via this default mechanism, you must have the\n`firebase.projects.update` permission. The following roles include this required\npermission by default: [Firebase\nAdmin](/docs/projects/iam/roles-predefined-all-products) or project [Owner or\nEditor](/docs/projects/iam/roles-basic).\n\nBy default, every project member (who has the required permissions to receive\nalerts) will get an email when a new iOS device is registered.\n\nTurn on/off alerts for your own account\n\nFor your own account, you can turn on/off App Distribution alerts without\naffecting other project members. Note that you still need the required\npermissions to receive alerts.\n\nTo turn App Distribution alerts on or off, follow these steps:\n\n1. In the Firebase console, in the top right-corner, go to notifications *Firebase\n alerts*.\n2. Then, go to settings *Settings* and set your account preference for App Distribution alerts.\n\nSet up advanced alerting to third-party services\n\nYou can also send App Distribution alerts to your team's preferred notification\nchannel using Cloud Functions for Firebase. For example, you can write a function\nthat captures an alert event for the registration of a new iOS device and post\nthe alert information to a third-party service, like Discord, Slack, or Jira.\n\nTo fully automate onboarding new iOS testers, you can write a function that adds\na new iOS device's UDID to the provisioning profile of your app, rebuilds the\napp, and redistributes the app with the updated provisioning profile.\n| **Note:** To use advanced alerting capabilities, your Firebase project needs to use the [Blaze pricing plan](/pricing).\n\nTo set up advanced alerting capabilities using Cloud Functions for Firebase, follow these steps:\n\n1. [Set up Cloud Functions for Firebase](/docs/functions/get-started),\n which includes the following tasks:\n\n 1. Set up a development environment for Node.js or Python.\n 2. Install and sign into the Firebase CLI.\n 3. Initialize Cloud Functions for Firebase using the Firebase CLI.\n2. [Write and deploy a function](/docs/functions/alert-events) that\n captures an alert event from App Distribution and handles the event\n payload (for example, posts the alert information in a message on Discord).\n\nTo learn about all of the alert events that you can capture, go to the reference\ndocumentation for [App Distribution\nalerts](/docs/reference/functions/2nd-gen/node/firebase-functions.alerts.appdistribution).\n\nNext steps\n\n- [Import testers from CSV\n files](/docs/app-distribution/import-testers-csv-files).\n\n- To learn how to increase your internal testing base, see [Create invite\n links](/docs/app-distribution/create-invite-links)."]]
