راه اندازی تپسل پلاس در ReactNative (Android)

در صورت وجود مشکل یا ابهام به لیست خطاهای فنی رایج مراجعه کنید یا صفحه‌ی Github Issues را بررسی نمایید.

خطاهای رایج و احتمالی کاربران را می‌توانید در GitHub issues ریپازیتوری پلاگین مشاهده کنید.

دریافت SDK تپسل پلاس

برای افزودن پلاگین تپسل‌پلاس به پروژه از کامند زیر استفاده کنید:

npm install react-native-tapsell-plus --save

برای استفاده از تپسل پلاس بایستی ورژن Android gradle plugin حداقل ۳.۶.۰ باشد
برای مشاهده‌ی نمونه‌ی پیاده‌سازی می‌توانید کد نظیر در سمپل تپسل را از این لینک مشاهده کنید

// <prj_root>/android/build.gradle

dependencies { 
  classpath("com.android.tools.build:gradle:4.1.3") // Use a version higher than 3.5.x
}

در صورت پایین بودن ورژن با خطاهای کامپایل همانند Manifest merger failed with multiple errors, see logs روبرو خواهید شد.

npm version

شروع کار با پلاگین

ابتدا ماژول تپسل پلاس را به کد خود اضافه کنید:

import { TapsellPlus } from 'react-native-tapsell-plus';

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

TapsellPlus.initialize(APP_KEY);

APP_KEY کلید تپسل هست و برای هر اپلیکیشن که می‌سازید در پنل تپسل ساخته میشود، میتوانید از پنل کپی کنید.

اکنون می‌توانید با توجه به نیاز خود و توضیحات به هر نوع تبلیغ، تبلیغ مورد نظر را نمایش دهید.

برای مشاهده‌ی جزئی‌تر لاگ‌ها در لایبرری از کد

TapsellPlus.setDebugMode(3)

استفاده کنید. هنگام درخواست یا نمایش هرگونه خطایی با جزئیات دقیق‌تر نمایش داده می‌شود.

در صورتی که targetSdkVersion برابر ۲۸ یا بالاتر باشد هنگام اجرای برنامه در حالت دیباگ (با استفاده از Metro sever) بایستی network-security را در برنامه لحاظ کنید.
برای اطلاعات بیشتر این بخش از مستندات ری‌اکت نیتیو را مطالعه کنید.

راه حل سریع:
عبارت android:usesCleartextTraffic="true" را به اتریبیوتهای تگ application در مانیفست اضافه کنید:

<!-- android/app/src/main/AndroidManifest.xml -->
<application
  ...
  android:usesCleartextTraffic="true">
 <!-- ... -->
</application>

نمونه در سمپل گیتهاب