(BREAKING CHANGES) Refactoring MobileAds API to v3.0.0

[gumaciel]

Is your feature request related to a problem? If so, please describe.

This change intends to change many of the plugins in all aspects, in order to make the plugin more dynamic and easy to use, it is necessary almost completely to redo the plugin to meet the use of mediation.

⚠️WARNING⚠️:

• No long support for Godot 3 due to (BREAKING CHANGES) Refactoring MobileAds API to v3.0.0 godot-admob-plugin#82
• Next tag release will be v3.0.0

What feature or improvement would you like to see?

✅GOALS✅

• Create an Interface of MobileAds class with Kotlin with the most important methods used on AdMob.
  Example:

override fun getPluginSignals(): MutableSet<SignalInfo> {
    val signals: MutableSet<SignalInfo> = ArraySet()
    signals.add(SignalInfo("initialization_complete", Dictionary::class.java))
    return signals
}

@UsedByGodot
fun initialize() {
    MobileAds.initialize(aActivity) { initializationStatus ->
        val initializationStatusDictionary = createInitializationStatusDictionary(initializationStatus)
        emitSignal("initialization_complete", initializationStatusDictionary)
    }
}

private fun createInitializationStatusDictionary(initializationStatus: InitializationStatus) : Dictionary {
    val statusMap = initializationStatus.adapterStatusMap
    val initializationStatusDictionary = Dictionary()

    for (adapterClass in statusMap.keys) {
        Log.d("poing-godot-admob", "")

        val adapterStatusDictionary = createAdapterStatusDictionary(statusMap[adapterClass])
        initializationStatusDictionary[adapterClass] = adapterStatusDictionary
    }
    return initializationStatusDictionary
}

• Create mediations adapters such as Meta and AdColony
• Don't generate any more debug.aar file because it's a release, only generate on PR CI/CD
• Update Documentation

Additional context

No response

[gumaciel]

General Architecture:

flowchart LR
  subgraph com.poingstudios.godot.admob
    direction TB
    subgraph com.poingstudios.godot.admob.core
        direction RL
        AdNetworkExtras
    end
    subgraph com.poingstudios.godot.admob.ads
        direction BT
        PoingGodotAdMob/JNISingleton
        PoingGodotAdMobAdView/JNISingleton/BannerAds
    end
    subgraph com.poingstudios.godot.admob.mediation.adcolony
        direction BT
        AdColonyAdNetworkExtras --> AdNetworkExtras
    end
    subgraph com.poingstudios.godot.admob.mediation.vungle
        direction BT
        VungleAdNetworkExtras --> AdNetworkExtras
        PoingGodotAdMobVungle/JNISingleton
    end
    subgraph com.poingstudios.godot.admob.mediation.meta
        direction BT
        //NoCodeRequired
    end
  end

godot.aar --- com.poingstudios.godot.admob.mediation.vungle
godot.aar --- com.poingstudios.godot.admob.ads
com.google.android.gms:play-services-ads --- com.poingstudios.godot.admob.core
com.google.ads.mediation:adcolony --- com.poingstudios.godot.admob.mediation.adcolony
com.google.ads.mediation:vungle --- com.poingstudios.godot.admob.mediation.vungle
com.google.ads.mediation:facebook --- com.poingstudios.godot.admob.mediation.meta

com.poingstudios.godot.admob.ads --> com.poingstudios.godot.admob.core
com.poingstudios.godot.admob.mediation.adcolony --> com.poingstudios.godot.admob.core
com.poingstudios.godot.admob.mediation.vungle --> com.poingstudios.godot.admob.core
com.poingstudios.godot.admob.mediation.meta --> com.poingstudios.godot.admob.core

Loading

All com.poingstudios.godot.admob.* will be generated and exported when a new version comes out

[gumaciel]

Modules generation .aar:

flowchart LR

com.poingstudios.godot.admob.ads == generates ==> poing-godot-admob-ads-*version*-*variant*.aar
com.poingstudios.godot.admob.core == generates ==> poing-godot-admob-core-*version*-*variant*.aar
com.poingstudios.godot.admob.mediation.adcolony == generates ==> poing-godot-admob-adcolony-*version*-*variant*.aar
com.poingstudios.godot.admob.mediation.vungle == generates ==> poing-godot-admob-vungle-*version*-*variant*.aar
com.poingstudios.godot.admob.mediation.meta == generates ==> poing-godot-admob-meta-*version*-*variant*.aar

Loading

[gumaciel]

Example of build and exporting plugin files into the desired directory:

./gradlew build ; ./gradlew exportFiles -PpluginExportPath=D:\godot-admob-editor\android\plugins

or just export files:

./gradlew exportFiles -PpluginExportPath=D:\godot-admob-editor\android\plugins

Zip plugins:

./gradlew zipPlugins -PgodotVersion=4.1.1 (-PgodotVersion is optional)