راه‌اندازی سریع در Unity

می‌خواهید در مورد این سرویس بیشتر بدانید؟ کلیک‌کنید

پیش‌نیازها

  • پروژه باید از Gradle build tool استفاده کند.
  • داشتن‌ ابزار گذرازتحریم (به دلیل تحریم‌بودن ‌Bintray)
  • باید Android SDK بروزرسانی شود
  • ثبت اپلیکیشن در کنسول
  • دستگاه تست باید گوگل‌پلی‌سرویس داشته‌باشد

اضافه‌کردن لایبرری

پلاگین پوشه مختص بازی‌های اندروید هستند و باید در پروژه Android platform انتخاب شود.

دانلود پلاگین

فایل پلاگین از لینک زیر دانلود کرده و آن‌را در پروژه‌ی خود import کنید.

پلاگین پوشه‌پلاس برای یونیتی

دانلود کتابخانه‌ها

در صورتی که در برنامه فایل mainTemplate.gradle ندارد، این فایل را از فولدر Pushe/Setup در آدرس Assets/Plugin/Android کپی کنید.

در صورتی که این فایل از قبل وجود دارد موارد زیر را در فایل mainTemplate.gradle خود اضافه‌کنید:

allprojects {
repositories {
google()
jcenter()
// Pushe Extended plugin
maven { url 'https://dl.bintray.com/pushe/plugin' }
flatDir {
dirs 'libs'
}
}
}

و همچنین:

compileSdkVersion 28

و سپس لایبرری پلاس را اضافه نمایید:

dependencies {
implementation fileTree(dir: 'libs', include: ['*.jar'])
// Adding Pushe Plus
implementation ('co.pushe.plus:unity-extended:0.4.4')
**DEPS**}

چرا از Unity Jar resolver استفاده نشده‌است؟

این ابزار در نسخه‌ی فعلی قابلیت Excludeکردن را ندارد که نبود این قابلیت باعث می‌شود به دلیل duplicate‌شدن لایبرری Excludeشده بیلد با خطا مواجه شود. در صورتی که این مورد حل شود و پلاگین نیز آپدیت خواهد شد.

به علاوه به دلیل اینکه لایبرری تعداد متد زیادی دارد ممکن است که Single dex برای اجرای برنامه کافی نباشد. لذا برای پشتیبانی از API<21 باید مالتی‌دکس را فعال‌کرد.

افزودن شناسه به مانیفست

قبل از اجرای برنامه باید توکن برنامه را از کنسول پوشه برداشته و در فایل AndroidManifest.xml قرار دهید. تگ دریافتی باید کدی همانند زیر باشد:

<meta-data android:name="pushe_token" android:value="PLUS_TOKEN" />

به جای PLUS_TOKEN باید توکن برنامه‌ی خود را قرار دهید.

نکته: محل فایل‌مانیفست Assets/plugin/Android/AndroidManifest.xml می‌باشد. در صورتی که این فایل موجود نیست آن‌را از Pushe/Setup می‌توانید کپی کنید

و محل اضافه‌کردن آن در فایل AndroidManifest باید مطابق زیر باشد:

<manifest ...>
<application ...>
...
<!-- تگ باید در اینجا قرار گیرد -->
<meta-data android:name="pushe_token" android:value="{PUSHE_TOKEN}" />
</application>
</manifest>

برای استفاده از امکان ارسال اعلان با استفاده‌ از موقعیت مکانی پرمیشن لوکیشن را نیز به مانیفست اضافه‌کنید:

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>

در صورتی که بخواهید آمار کاربران را بر حسب موقعیت جغرافیایی آنها مشاهده کنید و یا با فیلتر لوکیشن اعلان ارسال کنید باید کاربر این دسترسی را به برنامه بدهد.

اجرای برنامه

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

متوقف‌شدن برنامه قبل از نمایش لوگو:

در صورتی که این اتفاق رخ‌‌داد احتمالا در برنامه MultiDex باید اضافه‌شود.

  • ابتدا مطمئن شوید که در بلاک dafaultConfig عبارت multiDexEnabled true اضافه‌شده باشد.
defaultConfig {
multiDexEnabled true
//...
  • سپس در فایل AndroidManifest عبارت زیر را به اتریبیوت‌های <application> اضافه‌کنید:
<application
android:name="co.pushe.plus.ext.PusheMultiDexApplication"
...>

در فایل SampleCode.cs مثالهایی از قابلیت‌های بیشتر قرار داده شده است.

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