با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
اگر می‌خواهید بیلدهای iOS ad hoc را با استفاده از App Distribution توزیع کنید، باید این راهنما را دنبال کنید تا دستگاه‌های آزمایش‌کنندگان خود را ثبت کنید. یک ساخت موقت، ساختی است که با نمایه سازمانی امضا نشده است. یک دستگاه تنها در صورتی می‌تواند یک ساخت موقت نصب کند که شناسه دستگاه منحصربه‌فرد (UDID) در نمایه تأمین ساخت گنجانده شده باشد.
وقتی آزمایش‌کننده دعوتی را برای آزمایش برنامه‌تان می‌پذیرد، App Distribution اجازه می‌خواهد شناسه دستگاه آزمایش‌کننده را با شما، توسعه‌دهنده، به اشتراک بگذارد. قبل از دانلود یک ساخت موقت، App Distribution از تستر می خواهد که دستگاه خود را ثبت کند. اگر آزمایش‌کننده دستگاه خود را ثبت کند، App Distribution UDID را از دستگاه جمع‌آوری می‌کند و UDID را از طریق ایمیل به شما اطلاع می‌دهد.
وقتی ایمیلی حاوی UDID دریافت می‌کنید، نمایه تدارکات خود را با UDID به‌روزرسانی کنید و یک ساخت جدید را بین آزمایش‌کنندگان خود توزیع کنید. می توانید UDID ها را با استفاده از کنسول Firebase یا Firebase CLI به صورت دستی صادر کنید، یا می توانید UDID ها را با استفاده از fastlane به صورت برنامه نویسی صادر کنید.
UDID ها را به صورت دستی صادر کنید
دستگاه ها را به پورتال توسعه دهنده اپل خود اضافه کنید.
گزینه 1: UDID های دستگاه را به عنوان فایل CSV وارد کنید.
در برگه آزمایش‌کنندگان و گروه‌های داشبورد App Distribution ، همه آزمایش‌کنندگان را انتخاب کنید، سپس روی Export Apple UDIDs کلیک کنید تا یک فایل CSV دانلود شود. سپس، فایل را با استفاده از گزینه Register Multiple Devices به حساب توسعه دهنده اپل خود وارد کنید. برای کسب اطلاعات بیشتر، به توزیع برنامه خود در دستگاه های ثبت شده مراجعه کنید.
توجه داشته باشید که حساب توسعه دهنده اپل شما ممکن است تنها به شما اجازه دهد تعداد محدودی دستگاه را در سال وارد کنید.
گزینه 2: UDID ها را از طریق ایمیل جمع آوری و وارد کنید.
در صفحه Add Devices پورتال توسعه دهندگان اپل، UDID جدید مشخص شده در ایمیل دریافتی خود را ثبت کنید.
نمایه ارائه را دانلود کنید و از آن برای بازسازی برنامه خود استفاده کنید. اگر فقط برای به‌روزرسانی دستگاه‌های ثبت‌شده بازسازی می‌کنید، شماره ساخت یا نسخه را به‌روزرسانی نکنید.
برنامه خود را از کنسول Firebase یا CLI دوباره توزیع کنید. اگر نسخه، شماره ساخت یا کد برنامه خود را تغییر ندهید، App Distribution نسخه جدیدی ایجاد نمی‌کند و آزمایش‌کنندگان را مطلع نمی‌کند. اگر قبلاً ساختنی را با همان شماره ساخت و نسخه توزیع کرده‌اید، فقط کاربران دستگاه‌های تازه ثبت‌نام شده ایمیل‌های اعلان دریافت می‌کنند.
به صورت برنامه‌ریزی UDIDها را با استفاده از fastlane صادر کنید
همه UDID های دستگاه آزمایشگر خود را به عنوان یک فایل CSV از fastlane صادر کنید. به عنوان مثال، یک download_udids lane جدید ایجاد و اجرا کنید:
lane:download_udidsdofirebase_app_distribution_get_udids(app:"<your Firebase app ID>",output_file:"<path to output file>",)end
با استفاده از گزینه Register Multiple Devices، UDID(ها) را به حساب توسعه دهنده اپل خود وارد کنید. برای کسب اطلاعات بیشتر، به مستندات اپل مراجعه کنید. توجه داشته باشید که حساب توسعه دهنده اپل شما ممکن است تنها به شما اجازه دهد تعداد محدودی دستگاه را در سال وارد کنید.
نمایه ارائه را دانلود کنید و از آن برای بازسازی برنامه خود استفاده کنید. اگر فقط برای به‌روزرسانی دستگاه‌های ثبت‌شده بازسازی می‌کنید، شماره ساخت یا نسخه را به‌روزرسانی نکنید.
برنامه خود را مجدداً توزیع کنید . اگر نسخه، شماره ساخت یا کد برنامه خود را تغییر ندهید، App Distribution نسخه جدیدی ایجاد نمی‌کند و آزمایش‌کنندگان را مطلع نمی‌کند. اگر قبلاً ساختنی را با همان شماره ساخت و نسخه توزیع کرده‌اید، فقط کاربران دستگاه‌های تازه ثبت‌نام شده ایمیل‌های اعلان دریافت می‌کنند.
دریافت هشدار
دریافت هشدارهای پیش فرض
به‌طور پیش‌فرض، Firebase می‌تواند هشدارهای App Distribution را برای ثبت‌نام دستگاه‌های iOS جدید از طریق ایمیل ارسال کند.
برای دریافت هشدارهای App Distribution از طریق این مکانیسم پیش‌فرض، باید مجوز firebase.projects.update را داشته باشید. نقش‌های زیر به‌طور پیش‌فرض شامل این مجوز مورد نیاز است: مدیر Firebase یا مالک پروژه یا ویرایشگر .
به‌طور پیش‌فرض، هر عضو پروژه (که مجوزهای لازم برای دریافت هشدارها را دارد) زمانی که یک دستگاه iOS جدید ثبت شود، یک ایمیل دریافت می‌کند.
هشدارها را برای حساب شخصی خود روشن/خاموش کنید
برای حساب شخصی خود، می‌توانید هشدارهای App Distribution را بدون تأثیرگذاری بر دیگر اعضای پروژه روشن/خاموش کنید. توجه داشته باشید که برای دریافت هشدارها همچنان به مجوزهای لازم نیاز دارید.
برای روشن یا خاموش کردن هشدارهای App Distribution ، این مراحل را دنبال کنید:
در کنسول Firebase ، در گوشه بالا سمت راست، بهnotificationsهشدارهای Firebase .
سپس، بهsettingsتنظیمات و اولویت حساب خود را برای هشدارهای App Distribution تنظیم کنید.
هشدار پیشرفته را برای خدمات شخص ثالث تنظیم کنید
همچنین می‌توانید با استفاده از Cloud Functions for Firebase هشدارهای App Distribution را به کانال اعلان ترجیحی تیم خود ارسال کنید. برای مثال، می‌توانید تابعی بنویسید که یک رویداد هشدار را برای ثبت یک دستگاه iOS جدید ضبط می‌کند و اطلاعات هشدار را به یک سرویس شخص ثالث، مانند Discord، Slack یا Jira ارسال می‌کند.
برای خودکارسازی کامل آزمایش‌کننده‌های جدید iOS، می‌توانید تابعی بنویسید که UDID یک دستگاه iOS جدید را به نمایه تأمین برنامه شما اضافه می‌کند، برنامه را بازسازی می‌کند و برنامه را با نمایه تأمین به‌روز شده توزیع می‌کند.
برای راه‌اندازی قابلیت‌های هشدار پیشرفته با استفاده از Cloud Functions for Firebase ، این مراحل را دنبال کنید:
با استفاده از Firebase CLI Cloud Functions for Firebase راه اندازی کنید.
تابعی را بنویسید و مستقر کنید که یک رویداد هشدار را از App Distribution ضبط می کند و بار رویداد را مدیریت می کند (به عنوان مثال، اطلاعات هشدار را در پیامی در Discord پست می کند).
برای اطلاع از همه رویدادهای هشداری که می‌توانید ثبت کنید، به مستندات مرجع برای هشدارهای App Distribution بروید.
تاریخ آخرین به‌روزرسانی 2025-09-04 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-04 بهوقت ساعت هماهنگ جهانی."],[],[],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)."]]
