Skip to main content

Android

Editor 2019 and above version import​

Step 1: In Project Setting, check the ticked part in the figure below to generate the files required for Android compilation.​

Step 2: Introduce Gradle​

(1)baseProjectTemplate.gradle Introduce the required Maven library into the file, and the reference of the Maven library shall be subject to the code generated by the packaging platform​

Example

  • Developers need to confirm that the integrated SDK is correctly added to the project according to SDK DownLoad Platform.

  • For example: to access the IronSource SDK, developers need to check the IronSource advertising platform for the packaging platform, and then click to generate code.

  • Copy the repository in the Gradle reference repositories to baseProjectTemplate.gradle the file. See the sample code below for the specific location.
allprojects {
    buildscript {
        repositories {**ARTIFACTORYREPOSITORY**
			// TradPlus SDK maven library
			mavenCentral()
			google()
			// IronSource maven library
			maven { url 'https://android-sdk.is.com/' }
			jcenter()
        }
    }

    repositories {**ARTIFACTORYREPOSITORY**
		// TradPlus SDK maven library
        mavenCentral()
		google()
		// IronSource maven library
		maven { url 'https://android-sdk.is.com/' }
		jcenter()
        flatDir {
            dirs "${project(':unityLibrary').projectDir}/libs"
        }
    }
}

(2)Configure Gradle mainTemplate.gradle and advertising platform in the file​

Example

  • Copy the Gradle dependencies in the Gradle reference dependencies to mainTemplate.gradle the file. See the sample code below for the specific location.

def tradplus_version = "10.3.0.1"

dependencies {
    // noinspection GradleCompatible
    implementation 'androidx.legacy:legacy-support-v4:1.0.0'
    implementation 'androidx.appcompat:appcompat:1.3.0-alpha02'
	
    // TradPlus SDK
    implementation "com.tradplusad:tradplus:${tradplus_version}"
	
    // IronSource SDK
    implementation 'com.ironsource.sdk:mediationsdk:7.5.1'
    implementation "com.tradplusad:tradplus-ironsource:10.${tradplus_version}"
    implementation 'com.google.android.gms:play-services-appset:16.0.0'
    implementation 'com.google.android.gms:play-services-ads-identifier:17.0.0'
    implementation 'com.google.android.gms:play-services-basement:17.5.0'
}

Step 3: Configure manifest file​

（1）AndroidManifest.xml​

  • Step 1: Declare permissions. Development can add permissions according to the access platform.
  • Step 2: Apache Compatibility
  • Step 3: Configure the statement and develop the code generated according to SDK DownLoad Platform to add it (there are screenshots below)
<manifest
    xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.unity3d.player"
    xmlns:tools="http://schemas.android.com/tools">

    <!--Step 1: Declare permissions-->
    <!-- TG Domestic and Pangolin CSJ Domestic will use this permission to determine whether the application corresponding to the advertisement is installed on the user's app on the Android R system to avoid placing wrong advertisements -->
    <uses-permission android:name="android.permission.QUERY_ALL_PACKAGES"/>
    <!-- Pangolin CSJ domestic necessary permissions to solve security risk vulnerabilities. Sending and registering broadcast events requires calling an interface with delivery permissions -->
    <permission
        android:name="${applicationId}.openadsdk.permission.TT_PANGOLIN"
        android:protectionLevel="signature" />
    <uses-permission android:name="${applicationId}.openadsdk.permission.TT_PANGOLIN" />
    <!--Pangolin CSJ domestic, Pangle V45 or below, please be sure to add it, otherwise the screen will be black  -->
    <uses-permission android:name="android.permission.WAKE_LOCK" />

    <!-- Android 12 or above, agree to obtain Android Advertiser Identifier -->
    <uses-permission android:name="android.permission.AD_ID" />

    <application 
		>

         <!-- Step 2: Apache compatibility -->
        <uses-library android:name="org.apache.http.legacy" android:required="false"/>
		

        <!--Step 3: Configuration statement (the meta-data and provider generated by the packaging platform are added here)-->
        <!-- Add Google AdMob App ID:  ca-app-pub-3940256099942544~3347511713-->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    </application>
</manifest>
  • For example: SDK DownLoad Platform chooses to access Tencent Youlianghui. The AndroidManifest.xml part of the manifest file will generate the providers required by Tencent Youlianghui . Developers can add them directly according to the third step of the sample code.

（2）LauncherManifest.xml​

  • Step 1: Add hardware acceleration for video ads
  • Step 2: Add Network Security Profile
<manifest
	...
    <application android:label="@string/app_name"
                 android:icon="@mipmap/app_icon"
		<!-- The first step: Hardware acceleration of video ads Meta, MTG, ChartBoost, Adx and other video ads need to start hardware accelerated rendering -->
        android:hardwareAccelerated="true"
        android:supportsRtl="true"

		<!-- AndroidV9.2 is written into the SDK, no configuration is required; projects upgraded from older versions will report errors because the configuration has been added to the manifest file, just delete the configuration  -->
		<!-- Step 2: Add network security configuration file: network_security_config see below -->
        android:networkSecurityConfig="@xml/network_security_config"/>
</manifest>
  • Add network_security_config.xml in the Assets\Plugins\Android\res\xml folder of the project, with the following content：
<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <domain-config 
		cleartextTrafficPermitted="true">
        	<domain includeSubdomains="true">127.0.0.1</domain>
    </domain-config>
</network-security-config>

Step 4: AndroidX configuration​

  • The AndroidX project needs to be added, and the Support project can be ignored directly.
  • Add configuration in the above file gradleTemplate.properties
android.enableJetifier=true
android.useAndroidX=true

Step 5: Confusing configuration​

  • Add obfuscation configuration in the file proguard-user.txt above
  • After minifyEnabled is turned on, TP-related classes and methods can be found normally, otherwise the release package request advertisement will fail.
-keep public class com.tradplus.** { *; }
-keep class com.tradplus.ads.** { *; }

Step 6: Resource Optimization​

The resources of the advertising SDK cannot be confused. If you use a third-party resource optimization framework, please configure the resources of the SDK as a whitelist, for example:

# Access native, native banner, native splicing screen opening and other advertising types
R.string.tp_*
R.drawable.tp_*
R.layout.tp_*
R.id.tp_*

# Access crosspromotion, adx
R.string.cp_*
R.drawable.cp_*
R.layout.cp_*
R.id.cp_*

# Access Klevin
R.anim.klevin_*
R.color.klevin_*
R.drawable.klevin_*
R.id.klevin_*
R.layout.klevin_*
R.mipmap.klevin_*
R.string.klevin_*
R.integer.klevin_*
R.style.klevin_*
R.dimen.klevin_*
R.xml.klevin_*