در صورت وجود مشکل یا ابهام به لیست خطاهای فنی رایج مراجعه کنید یا صفحه‌ی 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روبرو خواهید شد.
شروع کار با پلاگین
ابتدا ماژول تپسل پلاس را به کد خود اضافه کنید:
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>