FAQ and Error codes

1. Compilation error: error: unexpected element found in manifest

The Android development environment requires the use of Gradle and Gradle plugin. There is a corresponding relationship between the two. If they do not correspond, an error will be reported

• Some advertising platform SDKs have requirements for the Gradle plugin version. Please confirm the Gradle Version you are using first, and then find the available Gradle plugin based on the corresponding relationship between Gradle Plugin and Gradle. Gradle plugin version range, and update the Gradle plugin version according to the following table: Specify Gradle plugin example 3.3.3 If you are using Gradle Version v4.10.1+, then update the Gradle plugin to v3.3.33.4.3 If you are using If the Gradle Version is v5.1.1+, then update the Gradle plugin to v3.4.33.5.4. If the Gradle Version you are using is v5.4.1+, then update the Gradle plugin to v3.5.43.6.4...4.0.1.. .

2. Running error: NoClassDefFoundError: Failed resolution of : **

• Missing dependencies, please follow Failed resolution of: In the following log, check for missing dependencies
• TopOn Cocos SDK needs to be used together with TopOn Android SDK , check whether the dependency package of TopOn Android SDK has been introduced

3. Banner ads and native ads are not fully displayed or have display problems

Banner ads: Make sure that the width-to-height ratio passed in when the ad is loaded is consistent with the ad. The proportion of advertising spaces on the platform is consistent

Native advertising: It is necessary to ensure that the width and height passed in when the ad is loaded and displayed are consistent, and the ratio is close to the advertising platform template. (You can check the width-to-height ratio of the advertising templates in the background of the advertising platform, and remove templates with large width-to-height ratio differences to ensure that the width-to-height ratios of ads issued by the advertising platform are close)

4. There is no result callback when the advertisement is loaded, the image in the advertisement cannot be displayed, and the resource download fails

You need to refer to the Android SDK import document to adapt to Android 9 and above systems

(1) New in AndroidManifest Add the following configuration:

<application>
    ...
    <uses-library android:name="org.apache.http.legacy" android:required="false"/>
    ...
</application>

(2)(Required only when using domestic SDK) Compatible with some third-party advertising SDKs, Http requests exist in the application tag of AndroidManifest Added: android:networkSecurityConfig configuration:

<application
    ...
    android:networkSecurityConfig="@xml/network_security_config"
    ...
    >
    ...
</application>

Add network_security_config.xml in the res/xml folder of the project, with the following content:

<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <base-config cleartextTrafficPermitted="true" />
</network-security-config>

Note: If there are the following configurations in network_security_config.xml, it may cause adaptation failure

<domain-config cleartextTrafficPermitted="true"> 
    <domain includeSubdomains="true">xxxxxx</domain> 
</domain-config>

5. The appId and placementId of the advertising source do not match

1. Check the configuration of the advertising source in the TopOn background (open the log of the SDK, and you can see the advertising source parameters configured in the TopOn background through the networkUnit field, and follow the advertising platform Check whether the background configuration comparison is consistent)

2. Check whether there is logic in the code to initialize the advertising platform SDK separately (initializing two different appids at the same time in the project will There will be problems, just make sure to initialize the same appId)

3. Check whether the test mode of the background advertising space is turned on (because the appId of the test mode is different from the developer The appIds of the advertising sources are different. Problems will occur if two different appIds are initialized at the same time in the project. Close the test mode of the TopOn background and try again)

4. Check Whether the open-screen advertisement uses the ATMediationRequestInfo instance and the wrong application and advertising space parameters are passed in (passing in errors will cause the wrong ID to be used to initialize the SDK of the advertising platform)

6. When displaying ads, multiple processes of the same application appear in the recent task list. How to solve this problem?

Change android in Application in AndroidManifest :taskAffinityConfiguration removal

TopOn SDK error For code and FAQ guidelines, please refer to: