# إعداد macOS

تتلقى تطبيقات macOS إشعارات الدفع من خلال خدمة إشعارات الدفع من Apple (APNs)، وهي نفس قناة التسليم التي يستخدمها iOS. قم بإعداد منصة macOS في Pushwoosh إما باستخدام اتصال مستند إلى شهادة (.p12) أو مستند إلى رمز (.p8) مع APNs.

<Aside type="note">
تأكد من تمكين قدرة إشعارات الدفع (Push Notifications) في تطبيق macOS الخاص بك وتسجيل معرف التطبيق (App ID) في بوابة مطوري Apple (Apple Developer Portal) قبل البدء. اقرأ المزيد في [توثيق مطوري Apple](https://developer.apple.com/documentation/usernotifications/registering_your_app_with_apns).
</Aside>

## الإعداد المستند إلى الشهادة

### إنشاء شهادة .p12

تتطابق خطوات Keychain و Apple Developer Portal والتصدير مع تدفق شهادة iOS. اتبع هذا الدليل واستخدم معرف التطبيق (App ID) الخاص بـ **macOS** عندما تطلب منك Apple اختيار واحد:

1. [إنشاء ملف طلب شهادة](/ar/developer/first-steps/connect-messaging-services/ios-configuration/ios-platform-configuration/#generating-a-certificate-request-file) في **Keychain Access**.
2. [إنشاء شهادة APNs في بوابة مطوري Apple](/ar/developer/first-steps/connect-messaging-services/ios-configuration/ios-platform-configuration/#creating-an-apns-certificate-in-apple-developer-portal). عند تحديد **معرف التطبيق (App ID)**، اختر المعرف الخاص بتطبيق macOS الخاص بك، وليس تطبيق iOS.
3. [تصدير المفتاح الخاص كملف .p12](/ar/developer/first-steps/connect-messaging-services/ios-configuration/ios-platform-configuration/#exporting-the-private-key-p12) من **Keychain Access**.

ستحتاج إلى ملف .p12 وكلمة مرور المفتاح الخاص في القسم التالي.

### إعداد منصة macOS في Pushwoosh

1. في مشروع Pushwoosh الخاص بك، انتقل إلى **الإعدادات → إعداد المنصات (Settings → Configure Platforms)**.
2. انقر على **اتصال (Connect)** بجوار **macOS** في قسم **منصات سطح المكتب (Desktop platforms)**.

<img src="/configure-project-macos-configuration-1.webp" alt="قسم منصات سطح المكتب يظهر صف macOS بحالة غير معدة وزر اتصال"/>

3. في **وضع الإعداد لنظام macOS (Configuration mode for macOS)**، حدد **الإعداد اليدوي المستند إلى الشهادة (Certificate-based manual configuration)**.
4. انقر على **التالي (Next)**.

<img src="/configure-project-macos-configuration-2.webp" alt="وضع الإعداد لنظام macOS مع تحديد الإعداد اليدوي المستند إلى الشهادة"/>

5. في صفحة **الإعداد المستند إلى الشهادة لنظام macOS (Certificate-based configuration for macOS)**، املأ النموذج:
   * **ملف الشهادة (.p12):** قم بتحميل ملف .p12 الذي قمت بتصديره من Keychain Access.
   * **كلمة مرور المفتاح الخاص:** أدخل كلمة المرور التي قمت بتعيينها عند تصدير ملف .p12.
   * **البوابة (Gateway):** حدد **Sandbox** للتطوير أو **Production** للتطبيقات الحية.

<img src="/configure-project-macos-configuration-3.webp" alt="الإعداد المستند إلى الشهادة لنظام macOS مع تحميل p12 وكلمة المرور والبوابة وزر الإعداد"/>

6. انقر على **إعداد (Configure)** لإكمال الإعداد.

## الإعداد المستند إلى الرمز

يمكنك إعداد منصة macOS باستخدام المصادقة المستندة إلى الرمز لتواصل أسرع مع APNs.

<Aside type="note">
لمعرفة المزيد، تحقق من [مستندات مطوري Apple](https://developer.apple.com/documentation/usernotifications/setting_up_a_remote_notification_server/establishing_a_token-based_connection_to_apns).
</Aside>

### الحصول على مفتاح توقيع من Apple

إنشاء مفتاح APNs هو نفسه لنظام iOS. اتبع [الحصول على مفتاح تشفير ومعرف مفتاح من Apple](/ar/developer/first-steps/connect-messaging-services/ios-configuration/ios-token-based-configuration/#obtain-an-encryption-key-and-key-id-from-apple) في دليل iOS المستند إلى الرمز.

ستحتاج إلى **معرف المفتاح (Key ID)** وملف **.p8** في القسم التالي. يمكنك إعادة استخدام نفس مفتاح APNs الذي تستخدمه بالفعل لنظام iOS إذا كان لديك واحد.

### إعداد منصة macOS في Pushwoosh

1. في مشروع Pushwoosh الخاص بك، انتقل إلى **الإعدادات → إعداد المنصات (Settings → Configure Platforms)**.
2. انقر على **اتصال (Connect)** بجوار **macOS** في قسم **منصات سطح المكتب (Desktop platforms)**.

<img src="/configure-project-macos-configuration-1.webp" alt="قسم منصات سطح المكتب يظهر صف macOS بحالة غير معدة وزر اتصال"/>

3. في **وضع الإعداد لنظام macOS (Configuration mode for macOS)**، حدد **الإعداد المستند إلى الرمز (Token-based configuration)**.
4. انقر على **التالي (Next)**.

<img src="/configure-project-macos-configuration-4.webp" alt="وضع الإعداد لنظام macOS مع تحديد الإعداد المستند إلى الرمز وزر التالي"/>

5. في صفحة **الإعداد المستند إلى الرمز لنظام macOS (Token-based configuration for macOS)**، املأ النموذج:
   * **معرف المفتاح (Key ID):** الصق معرف المفتاح المكون من 10 أحرف من Apple.
   * **معرف الفريق (Team ID):** أدخل معرف فريق مطوري Apple (Apple Developer Team ID) الخاص بك من قسم **العضوية (Membership)** في حساب مطوري Apple الخاص بك.
   * **معرف الحزمة (Bundle ID):** أدخل معرف الحزمة لتطبيق macOS الخاص بك من **الشهادات والمعرفات والملفات الشخصية (Certificates, Identifiers & Profiles)**.
   * **مفتاح المصادقة (.p8):** قم بتحميل ملف مفتاح التوقيع .p8 الذي قمت بتنزيله من Apple.
   * **البوابة (Gateway):** حدد **Sandbox** للتطوير أو **Production** للتطبيقات الحية.

<img src="/configure-project-macos-configuration-5.webp" alt="الإعداد المستند إلى الرمز لنظام macOS مع معرف المفتاح ومعرف الفريق ومعرف الحزمة ومفتاح المصادقة والبوابة"/>

6. انقر على **إعداد (Configure)** لإكمال الإعداد.

<Aside type="tip">
للتحقق مما إذا تم إعداد منصة macOS بنجاح، أرسل إشعار دفع تجريبي أو استهدف رسالة إلى جهاز معين. للحصول على إرشادات، راجع صفحة [اختبار تكاملك](/ar/developer/first-steps/test-your-integration).
</Aside>