پیش‌نیازها

در ابتدا اطمینان یابید که صفحه معرفی را برای آشنایی کامل با امکانات چابک با دقت مطالعه کرده باشید. برای بکارگیری چابک، شما نیاز به ایجاد حساب کاربری، انجام تنظیمات اولیه پوش‌نوتیفیکیشن دستگاه و دریافت گواهی اپل دارید.


ایجاد حساب چابک

به طور کلی چابک دارای دو نوع حساب آزمایشی (Sandbox) و عملیاتی (Production) است. حساب‌ آزمایشی روی محیط سندباکس قرار گرفته است و دارای محدودیت سقف کاربر می‌باشد. بنابراین برای اپلیکیشن‌های تجاری و اپ‌استور توصیه می‌کنیم از حساب عملیاتی که این سقف را ندارد، استفاده کنید.

برای ایجاد حساب کاربری کافیست در وبسایت چابک وارد صفحه شروع کنید شوید و حساب شخصی خود را بسازید. پس از ایجاد حساب، با مراجعه به بخش تنظیمات پنل پارامترهای اتصال به چابک که در بخش راه‌اندازی چابک مورد نیاز است، در دسترس خواهد بود.

نکته: در صورتی که تمایل دارید حساب خود را از آزمایشی به عملیاتی ارتقا دهید، باید با توجه به جدا بودن داده‌های هر حساب، از اپ خود با تنظیمات جدید چابک بیلد بگیرید و نسخه جدید منتشر کنید. برای درخواست حساب عملیاتی به پنل بخش تنظیمات مراجعه نمایید.


تنظیمات اولیه پوش‌نوتیفیکیشن

ابتدا مطمئن شوید که MobileCoreServices.framework ،SystemConfiguration.framework و CoreData را از Linked Frameworks and Libraries وارد کرده‌اید.

گزینه Push Notifications را در Setting > Capabilities فعال کنید،

و علامت Remote Notificationsها را در Setting > Capabilities > Background Modes بررسی کنید.


ایجاد گواهی اپل

برای ارسال پوش‌نوتیفیکیشن به اپلیکیشن‌های iOS شما نیاز به ایجاد گواهی (certificate) در APNs دارید. این گواهی را شما می‌توانید با یکی از دو روش p8 و PEM ایجاد کنید. با توجه به این که p8 روش جدیدتر اپل برای این کار است و به مراتب کوتاه‌تر و ساده‌تر می‌باشد و همینطور برخی مشکلات روش PEM مانند تطابق کلید ایجاد شده با provisioning profile و منقضی شدن کلیدها را ندارد، توصیه می‌کنیم از همین روش استفاده نمایید.

نکته : توجه داشته باشید هنگامی که گواهی sandbox اپل را در پنل تستی قرار می‌دهید، فقط امکان دریافت Cloud Messaging در حالت debug وجود خواهد داشت. اما اگر گواهی production اپل را در محیط عملیاتی قرار دهید، زمانی Cloud Messaging را دریافت خواهید کرد که اقدام به ساخت ipa از پروژه خود کرده و از طریق TestFlight یا Enterprise اپلیکیشن خود را نصب کنید.

روش p8

روش p8 را می‌توانید با انجام مراحل زیر اجرا کنید:

نکته: دقت داشته باشید که پس از دریافت کلیدها توسط این روش، حتما آن‌ها را در جای مطمئن نگه‌ دارید و همینطور از آن‌ها Backup بگیرید زیرا این کلید‌ها فقط و فقط یکبار ارائه می‌شوند و قابل بازیابی نمی‌باشند.

مرحله اول: ایجاد APNs Auth Key

در ابتدا صفحه APNs Auth Key را در Developer Center خود باز کنید و با کلیک روی + یک APNs Auth Key جدید بسازید.

درصفحه بعد گزینه (Apple Push Notification Authentication Key (Sandbox & Production را انتخاب نمایید و در پایین صفحه continue را بزنید.


عکس مربوطه

مرحله دوم: دریافت و ذخیره APNs Auth Key

پس از آن اپل فایل p8. که حاوی گواهی‌های APNs شماست را ایجاد می‌کند.


عکس مربوطه

فایل p8. را در دستگاه خود دانلود و ذخیره کنید.

در پایان کافیست به بخش تنظیمات پنل چابک بروید و ۴ شناسه زیر را در تنظیمات ارسال نوتیفیکیشن سرور اپل در کارت آی‌اواس قرار دهید:

۱- Bundle Id اپلیکیشنتان

۲- Team ID (مخصوص حساب Apple Developer خودتان)

۳- Key ID فایل p8.

۴- فایل p8. که دانلود کردید


عکس مربوطه


روش PEM

برای استفاده از روش PEM می‌توانید این قسمت را مطالعه نمایید.