在 2024 年演示日活动中，观看有关如何使用 Firebase 构建和运行 AI 赋能应用的演示。立即观看。

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

توزيع تطبيقات iOS على المختبِرين باستخدام Fastlane

يمكنك توزيع الإصدارات على المختبِرين باستخدام fastlane، وهو منصة مفتوحة المصدر تعمل على إنشاء تطبيقات iOS وAndroid وإصدارها بشكل آلي. وتتّبع تعليمات بسيطة محدّدة في Fastfile. بعد إعداد fastlane وFastfile، يمكنك دمج App Distribution مع إعدادات fastlane.

الخطوة 1: إعداد fastlane

تثبيت fastlane وإعداده
لإضافة App Distribution إلى إعدادات Fastlane، نفِّذ الأمر التالي من جذر مشروع iOS:
```
fastlane add_plugin firebase_app_distribution
```
إذا طلب منك الأمر اختيار أحد الخيارات، اختَر Option 3: RubyGems.org.

الخطوة 2: المصادقة باستخدام Firebase

لاستخدام المكوّن الإضافي fastlane، عليك أولاً المصادقة باستخدام مشروعك على Firebase بإحدى الطرق التالية. يبحث مكوّن Fastlane الإضافي تلقائيًا عن بيانات الاعتماد من وحدة تحكّم Firebase CLI في حال عدم استخدام طريقة مصادقة أخرى.

استخدام بيانات اعتماد حساب خدمة Firebase

تتيح لك المصادقة باستخدام حساب خدمة استخدام المكوّن الإضافي بمرونة مع نظام الدمج المستمر (CI). هناك طريقتان لتقديم بيانات اعتماد حساب الخدمة:

نقْل ملف مفتاح حساب الخدمة إلى firebase_app_distribution الإجراء. قد تكون هذه الطريقة ملائمة إذا كان لديك ملف مفتاح حساب الخدمة في بيئة الإنشاء.
اضبط متغيّر البيئة GOOGLE_APPLICATION_CREDENTIALS للإشارة إلىملف مفتاح حساب الخدمة. قد تفضّل هذه الطريقة إذا سبق أن تم إعداد بيانات اعتماد تلقائية للتطبيق (ADC) لخدمة أخرى من Google (مثل Google Cloud).

في وحدة تحكّم Google Cloud، اختَر مشروعك وأنشئ حساب خدمة جديدًا.
أضِف دور Firebase App Distribution المشرف.
أنشئ مفتاحًا خاصًا بترميز JSON وانقل المفتاح إلى موقع يمكن لبيئة الإنشاء الوصول إليه. احرص على الاحتفاظ بهذا الملف في مكان آمن، لأنّه يمنح إذن وصول المشرف إلى App Distribution في مشروعك على Firebase.
تخطّ هذه الخطوة إذا أنشأت تطبيقك بعد 20 أيلول (سبتمبر) 2019: في وحدة تحكّم Google APIs، فعِّل واجهة برمجة التطبيقات Firebase App Distribution API. اختَر المشروع الذي يحمل الاسم نفسه لمشروعك على Firebase عند ظهور طلب بذلك.
قدِّم بيانات اعتماد حساب الخدمة أو حدِّد موقعها:
1. لتمرير مفتاح حساب الخدمة إلى firebase_app_distributionالإجراء في مسارك، اضبط المَعلمة service_credentials_file باستخدام المسار إلى ملف JSON للمفتاح الخاص.
2. لتحديد موقع بيانات الاعتماد باستخدام أداة ADC، اضبط متغيّر البيئة GOOGLE_APPLICATION_CREDENTIALS على مسار ملف JSON للمفتاح الخاص. على سبيل المثال:
```
 export GOOGLE_APPLICATION_CREDENTIALS=/absolute/path/to/credentials/file.json
```
  لمزيد من المعلومات عن المصادقة باستخدام ADC، يُرجى الاطّلاع على مقالة تقديم بيانات الاعتماد إلى تطبيقك.

تسجيل الدخول باستخدام وحدة تحكّم Firebase لخط الأوامر

اطّلِع على مقالة تسجيل الدخول باستخدام واجهة برمجة التطبيقات Firebase للحصول على تعليمات حول كيفية مصادقة مشروعك.

الخطوة 3: إعداد Fastfile وتوزيع تطبيقك

في حارة ./fastlane/Fastfile، أضِف مجموعة firebase_app_distribution. استخدِم المَعلمات التالية لمحاولة ضبط التوزيع:

مَعلمات firebase_app_distribution
`app`	مطلوبة فقط إذا كان تطبيقك لا يحتوي على ملف إعدادات Firebase (`GoogleService-Info.plist`): رقم تعريف تطبيقك على Firebase. يمكنك العثور على معرّف التطبيق في وحدة تحكّم Firebase، ضمن صفحة "الإعدادات العامة". app: "1:1234567890:ios:0a1b2c3d4e5f67890"
`googleservice_info_plist_path`	مسار ملف `GoogleService-Info.plist`، نسبةً إلى مسار المنتج المؤرشف يتم ضبطه تلقائيًا على `GoogleService-Info.plist`. يُستخدَم الملف للحصول على رقم تعريف تطبيقك على Firebase في حال عدم تحديد المَعلمة `app`.
`firebase_cli_token`	رمز إعادة التنشيط الذي يتم طباعته عند مصادقة بيئة التطوير المتكامل باستخدام واجهة سطر الأوامر Firebase (اطّلِع على استخدام واجهة سطر الأوامر مع أنظمة التطوير المتكامل للحصول على مزيد من المعلومات).
`service_credentials_file`	المسار إلى ملف JSON لحساب الخدمة في Google. اطّلِع على القسم أعلاه لمعرفة كيفية المصادقة باستخدام بيانات اعتماد حساب الخدمة.
`ipa_path`	تم استبداله بـ `apk_path` (تم إيقافه نهائيًا). المسار المطلق لملف IPA الذي تريد تحميله إذا لم يتم تحديده، تحدِّد أداة fastlane موقع الملف من المسار الذي تم إنشاء الملف فيه.
`release_notes` `release_notes_file`	ملاحظات الإصدار لهذا الإصدار يمكنك تحديد ملاحظات الإصدار مباشرةً: release_notes: "Text of release notes" أو حدِّد مسار ملف نص عادي: release_notes_file: "/path/to/release-notes.txt"
`testers` `testers_file`	عناوين البريد الإلكتروني للمختبِرين الذين تريد دعوتهم يمكنك تحديد المختبِرين كقائمة مفصولة بفواصل لعناوين البريد الإلكتروني التالية: testers: "ali@example.com, bri@example.com, cal@example.com" أو يمكنك تحديد مسار ملف نص عادي يحتوي على قائمة مفصولة بفواصل لعناوين البريد الإلكتروني: testers_file: "/path/to/testers.txt"
`groups` `groups_file`	مجموعات المختبِرين التي تريد دعوتها (راجِع إدارة المختبِرين). يتم تحديد المجموعات باستخدام الأسماء البديلة للمجموعات، والتي يمكنك الاطّلاع عليها في وحدة تحكّم Firebase. يمكنك تحديد المجموعات كقائمة مفصولة بفواصل: groups: "qa-team, trusted-testers" أو يمكنك تحديد مسار ملف نصي عادي يحتوي على قائمة مفصولة بفواصل بأسماء المجموعات: groups_file: "/path/to/groups.txt"
`test_devices` `test_devices_file`	تشكّل أنواع التوزيع التالية جزءًا من الميزة التجريبية للمختبِر الآلي. الأجهزة الاختبارية التي تريد توزيع الإصدارات عليها (راجِع الاختبارات المبرمَجة). يمكنك تحديد أجهزة الاختبار كقائمة مفصولة بفواصل منقوطة لأجهزة الاختبار: test_devices: "model=shiba,version=34,locale=en,orientation=portrait;model=b0q,version=33,locale=en,orientation=portrait" يمكنك بدلاً من ذلك تحديد مسار ملف نصي عادي يحتوي على قائمة بالأجهزة الاختبارية مفصولة بفواصل منقوطة: test_devices_file: "/path/to/test-devices.txt"
`test_username`	اسم المستخدم لتسجيل الدخول التلقائي الذي سيتم استخدامه أثناء الاختبارات المبرمَجة.
`test_password` `test_password_file`	كلمة مرور تسجيل الدخول التلقائي التي سيتم استخدامها أثناء الاختبارات المبرمَجة أو يمكنك تحديد مسار ملف نصي عادي يحتوي على كلمة مرور: test_password_file: "/path/to/test-password.txt"
`test_username_resource`	اسم المورد لحقل اسم المستخدم لتسجيل الدخول التلقائي الذي سيتم استخدامه أثناء الاختبارات المبرمَجة.
`test_password_resource`	اسم المورد لحقل كلمة المرور لتسجيل الدخول التلقائي الذي سيتم استخدامه أثناء الاختبارات المبرمَجة.
`test_non_blocking`	تنفيذ الاختبارات المبرمَجة بشكل غير متزامن انتقِل إلى "وحدة تحكُّم Firebase" للاطّلاع على نتائج الاختبار التلقائي.
`debug`	علامة منطقية يمكنك ضبط هذا الخيار على `true` لطباعة معلومات تفصيلية عن تصحيح الأخطاء.

على سبيل المثال:

platform :ios do
    desc "My awesome app"
    lane :distribute do
        build_ios_app(...)
        # build_ios_app is a built-in fastlane action.

        release = firebase_app_distribution(
            app: "1:123456789:ios:abcd1234",
            testers: "tester1@company.com, tester2@company.com",
            release_notes: "Lots of amazing new features to test out!"
        )

    end
end

لإتاحة الإصدار للمختبِرين، شغِّل مسارك:

fastlane <lane>

القيمة المعروضة للإجراء هي تجزئة تمثّل الإصدار الذي تم تحميله. تتوفّر هذه التجزئة أيضًا باستخدام lane_context[SharedValues::FIREBASE_APP_DISTRO_RELEASE]. لمزيد من المعلومات عن الحقول المتاحة في هذه التجزئة، يُرجى الاطّلاع على مستندات REST API.

يعرض المكوّن الإضافي fastlane الروابط التالية بعد تحميل الإصدار. تساعدك هذه الروابط في إدارة الملفات الثنائية والتأكّد من حصول المختبِرين والمطوّرين الآخرين على الإصدار الصحيح:

رابط يؤدي إلى وحدة تحكّم Firebase يعرض إصدارًا واحدًا يمكنك مشاركة هذا الرابط مع مطوّرين آخرين في مؤسستك.
رابط يؤدي إلى الإصدار في تجربة المختبِر (مقطع ويب على نظام التشغيل iOS) يتيح للمختبِرين الاطّلاع على ملاحظات الإصدار وتثبيت التطبيق على أجهزتهم يحتاج المختبِر إلى إذن الوصول إلى الإصدار لاستخدام الرابط.
رابط موقَّع يتيح تنزيل ملف التطبيق الثنائي (ملف IPA) وتنصيبه مباشرةً تنتهي صلاحية الرابط بعد ساعة واحدة.

بعد توزيع الإصدار، يصبح متوفّرًا في لوحة بيانات App Distribution في وحدة تحكّم Firebase لمدة 150 يومًا. عندما يتبقّى 30 يومًا على انتهاء صلاحية الإصدار، يظهر إشعار بانتهاء الصلاحية فيconsole وفي قائمة الإصدارات لدى المختبِر على جهاز الاختبار.

يتلقّى المختبِرون الذين لم تتم دعوتهم سابقًا لاختبار التطبيق دعوات عبر البريد الإلكتروني لبدء الاختبار. يتلقّى المختبِرون الحاليون إشعارات عبر البريد الإلكتروني عند توفّر إصدار جديد للاختبار. للتعرّف على كيفية تثبيت التطبيق الاختباري، اطّلِع على مقالة الإعداد كمختبِر. يمكنك تتبُّع حالة كل مختبِر لمعرفة ما إذا كان قد وافق على الدعوة وما إذا كان قد نزَّل التطبيق في وحدة تحكُّمFirebase.

(اختياري) لزيادة رقم الإصدار تلقائيًا في كل مرة تنشئ فيها إصدارًا جديدًا في "توزيع التطبيقات"، يمكنك استخدام الإجراء firebase_app_distribution_get_latest_release والإجراء increment_build_number. يوفّر الرمز البرمجي التالي مثالاً على كيفية زيادة رقم الإصدار تلقائيًا:

lane :increment_version do
  latest_release = firebase_app_distribution_get_latest_release(
    app: "<your Firebase app ID>"
  )
  increment_build_number({ build_number: latest_release[:buildVersion].to_i + 1 })
end

للاطّلاع على مزيد من المعلومات حول ميزة مكوّن Fastlane الإضافي هذه، يمكنك الاطّلاع على مقالة الحصول على معلومات عن أحدث إصدار من تطبيقك.

الخطوة 4 (اختيارية): إدارة المختبِرين للإصدار

يمكنك إضافة المختبِرين وإزالتهم من مشروعك أو مجموعتك باستخدام ملف Fastfile أو من خلال تنفيذ إجراءات Fastlane مباشرةً. يؤدي تنفيذ الإجراءات مباشرةً إلى إلغاء القيم التي تم ضبطها في Fastfile.

بعد إضافة مختبِر إلى مشروعك على Firebase، يمكنك إضافته إلى إصدارات فردية. لن يعود بإمكان المختبِرين الذين تمت إزالتهم من مشروعك على Firebase الوصول إلى الإصدارات في مشروعك، ولكن قد يحتفظون بإمكانية الوصول إلى إصداراتك لفترة زمنية معيّنة.

إذا كان لديك عدد كبير من المختبِرين، ننصحك باستخدام المجموعات.

استخدام `Fastfile`

# Use lanes to add or remove testers from a project.
lane(:add_testers) do
  firebase_app_distribution_add_testers(
    emails: "foo@google.com,bar@google.com"
    # or file: "/path/to/testers.txt"
    group_alias: "qa-team" # (Optional) add testers to this group
  )
end

lane(:remove_testers) do
  firebase_app_distribution_remove_testers(
    emails: "foo@google.com,bar@google.com"
    # or file: "/path/to/testers.txt"
    group_alias: "qa-team" # (Optional) remove testers from this group only
  )
end

# Add or remove testers with the terminal
$ fastlane add_testers
$ fastlane remove_testers

تنفيذ إجراءات Fastlane

fastlane run firebase_app_distribution_create_group display_name:"QA Team" alias:"qa-team"
fastlane run firebase_app_distribution_add_testers group_alias:"qa-team" emails:"foo@google.com,bar@google.com"
fastlane run firebase_app_distribution_remove_testers group_alias:"qa-team" emails:"foo@google.com,bar@google.com"
fastlane run firebase_app_distribution_delete_group alias:"qa-team"

يمكنك أيضًا تحديد المختبِرين باستخدام --file="/path/to/testers.txt بدلاً من --emails.

تقبل المهمتَان firebase_app_distribution_add_testers و firebase_app_distribution_remove_testers أيضًا العبارة التالية:

project_name: رقم مشروعك على Firebase.
group_alias (اختياري): في حال تحديده، تتم إضافة المختبِرين إلى (أو إزالتهم من) المجموعة المحدّدة.
service_credentials_file: مسار ملف بيانات اعتماد خدمة Google
‫firebase_cli_token: رمز التفويض لواجهة سطر أوامر Firebase

service_credentials_file وfirebase_cli_token هما المَعلمتان نفسهما اللتان يستخدمهما إجراء التحميل.

الخطوة 5 (اختيارية): الحصول على معلومات عن أحدث إصدار من تطبيقك

يمكنك استخدام الإجراء firebase_app_distribution_get_latest_release لاسترداد معلومات عن أحدث إصدار من تطبيقك في "توزيع التطبيقات"، بما في ذلك معلومات إصدار التطبيق وملاحظات الإصدار ووقت الإنشاء. تشمل حالات الاستخدام زيادة الإصدار تلقائيًا ونقل ملاحظات الإصدار من الإصدار السابق.

القيمة المعروضة للإجراء هي تجزئة تمثّل أحدث إصدار. تتوفّر هذه التجزئة أيضًا باستخدام lane_context[SharedValues::FIREBASE_APP_DISTRO_LATEST_RELEASE]. لمزيد من المعلومات عن الحقول المتاحة في هذه التجزئة، يُرجى الاطّلاع على مستندات REST API.

المَعلمات

مَعلمات firebase_app_distribution_get_latest_release
`app`	مطلوبة فقط إذا كان تطبيقك لا يحتوي على ملف إعدادات Firebase (`GoogleService-Info.plist`): رقم تعريف تطبيقك على Firebase. يمكنك العثور على معرّف التطبيق في وحدة تحكّم Firebase، ضمن صفحة "الإعدادات العامة". app: "1:1234567890:ios:0a1b2c3d4e5f67890"
`googleservice_info_plist_path`	مسار ملف `GoogleService-Info.plist`، نسبةً إلى مسار المنتج المؤرشف يتم ضبطه تلقائيًا على `GoogleService-Info.plist`. يُستخدَم الملف للحصول على رقم تعريف تطبيقك على Firebase في حال عدم تحديد المَعلمة `app`.
`firebase_cli_token`	رمز إعادة التنشيط الذي يتم طباعته عند مصادقة بيئة التطوير المتكامل باستخدام واجهة سطر الأوامر Firebase (اطّلِع على استخدام واجهة سطر الأوامر مع أنظمة التطوير المتكامل للحصول على مزيد من المعلومات).
`service_credentials_file`	المسار إلى ملف JSON لحساب الخدمة في Google. اطّلِع على المستندات السابقة لمعرفة كيفية المصادقة باستخدام بيانات اعتماد حساب الخدمة.
`service_credentials_json_data`	محتوى ملف json لحساب خدمة Google اطّلِع على المستندات السابقة لمعرفة كيفية المصادقة باستخدام بيانات اعتماد حساب الخدمة.
`debug`	علامة منطقية يمكنك ضبط هذا الخيار على `true` لطباعة معلومات تفصيلية عن تصحيح الأخطاء.

الخطوات التالية

لتسجيل المزيد من الأجهزة يدويًا أو آليًا، يُرجى الاطّلاع على مقالة تسجيل أجهزة iOS إضافية.
تعرَّف على أفضل الممارسات لتوزيع تطبيقات Apple على مختبِري ضمان الجودة باستخدام أدوات CI/CD وFastlane.