راه‌اندازی سریع ری‌اکت‌نیتیو

پیش‌نیاز

قبل از شروع کار موارد زیر را بررسی و از درستی آنها اطمینان حاصل نمایید.

Android

• برای گذر از تحریم سرور‌های Jcenter از ابزار گذرازتحریم یا ... استفاده کنید.
• MinSDKVersion >= 14
• اپلیکیشن باید در کنسول ثبت‌شود. Pushe console
• توکن مانیفست از کنسول برداشته‌شود.
• دستگاه تست باید دارای گوگل‌پلی‌سرویس بوده و اینترنت آن فعال‌باشد.

iOS

• اپلیکیشن باید در کنسول ثبت‌شود. Pushe console
• توکن مانیفست از کنسول برداشته‌شود.
• اینترنت دستگاه فعال باشد

اضافه کردن کتابخانه

اضافه کردن کتابخانه در نسخه قبل از ۶۰ ری‌اکت‌نیتیو و بعد از آن کمی متفاوت می‌باشد که در زیر هر دو حالت را می‌توانید مشاهده کنید.

نسخه‌ی 0.60 و بالاتر

با استفاده از دستور زیر کتابخانه ی پوشه را به پروژه خود اضافه کنید.

npm i -P pushe-react-native

نسخه‌ی زیر 0.60

با استفاده از دستور زیر کتابخانه ی پوشه را به پروژه خود اضافه کنید.

npm i -P pushe-react-native

سپس باید آن‌ را به پروژه‌ی خود لینک کنید:

react-native link pushe-react-native

دستور باید در کامندلاین وارد شود و در صورتی که npm در کامندلاین دستور معتبری نیست بایستی به داکیومنت ReactNative برای حل مشکل مراجعه کنید.

در صورتی که نسخه ری‌اکت‌نیتو‌ی که استفاده می کنید 0.60.0 و به بعد می‌باشد دیگر نیازی به لینک‌کردن کتابخانه نیست.

Android

اضافه‌کردن محتوای مانیفست

محتوای مانیفست را از کنسول (اطلاعات بیشتر) کپی‌ کنید و آ‌ن را به فایل AndroidManifest.xml در پروژه‌ی خود اضافه‌کنید. محتوا باید شبیه خط زیر باشد:

AndroidManifest.xml

<manifest ...>

<application ...>

<meta-data android:name="pushe_token" android:value="{PUSHE_TOKEN}" />

</application>

</manifest>

‌ فایل مانیفست برنامه در آدرس زیر در پروژه قابل دسترسی‌ست: android/src/main/AndroidManifest.xml

تست و ثبت دستگاه در پوشه

پس از اجرای برنامه، باید در Android logcat لاگ‌های زیر را ببینید (ممکن است به دلیل ارتباط با سرور این پروسه چند ثانیه طول بکشد):

می‌توانید از دستور react-native log-android و یا react-native log-ios برای مشاهده‌ی لاگ‌های خروجی از اپلیکیشن استفاده کنید.

// Android logcat:

Pushe: Starting Pushe initialization

Pushe: Pushe initialization complete

Pushe: Registration is required, performing registration

Pushe: Registration successful

iOS

نصب podهای لازم

وارد فولدر ios شوید و دستور زیر را اجرا کنید.

pod install --repo-update

پس از اجرای این دستور می‌توانید با بازکردن فایل YourProjectName.xcworkspace برنامه ios خود را اجرا کنید.

اضافه کردن کلید‌های موردنیاز

در فایل Info.plist متناظر با Target اصلی برنامه، کلید‌ها و مقادیر زیر را وارد کنید.

<plist version="1.0">

<dict>

...

<key>FirebaseAppDelegateProxyEnabled</key>

<false/>

<key>Pushe</key>

<dict>

<key>AppGroupsId</key>

<string>Enter your App-Groups id</string>

<key>ManifestKey</key>

<string>Enter your Menifest-Key from console.pushe.co</string>

</dict>

</dict>

</plist>

برای نمونه:

<plist version="1.0">

<dict>

<key>FirebaseAppDelegateProxyEnabled</key>

<false/>

<key>Pushe</key>

<dict>

<key>AppGroupsId</key>

<string>group.my.uri.myApp.shared</string>

<key>ManifestKey</key>

<string>cWQyMzR3bTlsOxBUcjQ0ZUBJaxZAOTA4NDU35Tk1MDcy</string>

</dict>

</dict>

</plist>

همچنین در فایل Info.plist متناظر با Notification Service Extension، کلیدها و مقادیر زیر را وارد کنید.

<plist version="1.0">

<dict>

<key>Pushe</key>

<dict>

<key>AppGroupsId</key>

<string>Enter your App-Groups id</string>

</dict>

</dict>

</plist>

• برای راهنمایی در مورد نحوه ایجاد App-Groups به لینک زیر مراجعه کنید.
  • نحوه اضافه کردن App-Groups

اضافه‌کردن کد‌های موردنیاز

و در Target مربوط به NotificationServiceExtension:

Swift

// NotificationService.swift file

import UserNotifications

import Pushe

class NotificationService: UNNotificationServiceExtension {

var contentHandler: ((UNNotificationContent) -> Void)?

var bestAttemptContent: UNMutableNotificationContent?

override func didReceive(_ request: UNNotificationRequest, withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void) {

self.contentHandler = contentHandler

self.bestAttemptContent = (request.content.mutableCopy() as? UNMutableNotificationContent)

if let bestAttemptContent = self.bestAttemptContent {

PusheClient.shared.didReceiveNotificationExtensionRequest(mutableContent: bestAttemptContent, contentHandler: contentHandler)

}

}

override func serviceExtensionTimeWillExpire() {

if let contentHandler = self.contentHandler, let bestAttemptContent = self.bestAttemptContent {

contentHandler(bestAttemptContent)

}

}

}

Objective-C

// NotificationService.m file

#import "NotificationService.h"

@import Pushe;

@interface NotificationService ()

@property (nonatomic, strong) void (^contentHandler)(UNNotificationContent *contentToDeliver);

@property (nonatomic, strong) UNMutableNotificationContent *bestAttemptContent;

@end

@implementation NotificationService

- (void)didReceiveNotificationRequest:(UNNotificationRequest *)request withContentHandler:(void (^)(UNNotificationContent * _Nonnull))contentHandler {

self.contentHandler = contentHandler;

self.bestAttemptContent = [request.content mutableCopy];

[PusheClient.shared didReceiveNotificationExtensionRequest:self.bestAttemptContent :self.contentHandler];

}

- (void)serviceExtensionTimeWillExpire {

self.contentHandler(self.bestAttemptContent);

}

@end

تست و ثبت دستگاه در پوشه

پس از اجرای برنامه و فراخوانی کد رجیستر پوشه، باید در کنسول Xcode لاگ‌های زیر را ببینید (ممکن است به دلیل ارتباط با سرور این پروسه چند ثانیه طول بکشد):

Setting up Pushe ...

apns-token:<YOUR_APNS_TOKEN>

fcm-token:<DEVICE_FCM_TOKEN>

registering in Pushe ...

📗 -> successfully registered in Pushe

در صورتی که نصب و راه‌اندازی پوشه مشکل داشتید می‌توانید به مشکلات و خطاها مراجعه کنید.

برای بررسی امکانات بیشتر پوشه به مطالعه‌ی ادامه‌ی مستندات بپردازید.