In order to use Tapsell, you first need to follow the steps below to add Tapsell to your project.
Gradle Config
You can import the Tapsell SDK with a Gradle dependency that points to Tapsell’s Maven repository. To use this repository, you need to reference it in the project-level build.gradle
file, in the allprojects -> repositories
section.
maven {
mavenCentral()
// Before v4.5.4
maven { url 'https://dl.bintray.com/tapsellorg/maven' }
}
Then add the following lines to the dependencies section of your app-level build.gradle
file.
implementation 'ir.tapsell.sdk:tapsell-sdk-android:4.9.5'
Finally, sync Gradle using a proxy.
Initialization
You should initialize Tapsell in the application class.
import ir.tapsell.sdk.Tapsell;
...
public void onCreate() {
super.onCreate();
Tapsell.initialize(application, TAPSELL_KEY);
}
You can get your tapsell-key
from Tapsell Dashboard and Initialize the SDK in the application
class.
You can read this article to get acquainted with the application class.
Proguard Configuration
Get the proguard.properties
file from this link and add it to the proguard properties of your app module.
Network Security Configuration
In case your application uses the HTTP protocol, in the res/xml
path of your project create a file named network_security_config.xml
.
- If all the connections made by your application use the HTTP protocol, add the following lines to
network_security_config.xml
:
<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
<base-config cleartextTrafficPermitted="true"/>
</base-config>
</network-security-config>
- If your application sends HTTP packets to only a few domains, add the following lines to
network_security_config.xml
:
<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
<domain-config cleartextTrafficPermitted="true"/>
<domain includeSubdomains="true"><!—your subdomain--></domain>
</domain-config>
</network-security-config>
Then add the android:networkSecurityConfig
attribute to the application tag in the AndroidManifest.xml
file of your application, such as the following lines:
<?xml version="1.0" encoding="utf-8"?>
<manifest>
<application
android:networkSecurityConfig="@xml/network_security_config">
</application>
</manifest>
And lastly, delete the attribute below if it exists in the AndroidManifest.xml
file of your application:
<application
android:usesCleartextTraffic="true">