Added ads module.

[pabulaner]

The ads module provides mobile developers (at the moment only android) with the ability to show banner, interstitial and rewarded ads from JavaFX.

It uses the Google AdMob SDK for loading and showing ads.

[pabulaner]

INFO: For merging this pull request, an entry would have to be added to the gluonfx-maven-plugin.

[pabulaner]

Hey, it would be nice to maybe get some feedback or comment on this pull request after one year, because I put a lot of effort into this one and would really like to see it integrated in gluon attach itself.

[jperedadnr]

Thanks @pabulaner for this PR

Could you please sync your branch with head? We use Android SDK 34 now, and it would be good to update the ADS dependency probably to the latest one.

Also, note that all files should have a license header.

And for testing this PR it would be great if you provide a small code snippet of how it can be used.

I've managed to build the service and deploy it to Android with this:

AdsService.create().ifPresent(ads -> {
                            ads.initialize(() -> {
                                ads.setRequestConfiguration(new RequestConfiguration.Builder()
                                        .setTestDeviceIds(List.of(AdsService.BANNER_TEST_AD_UNIT_ID))
                                        .build());
                                ads.newBannerAd();
                            });
                        });

but the initialize call doesn't seem to succeed. All I see in the logs is:

 I/GluonAttach(  910): JNI_OnLoad_ads called
 D/GluonAttach(  910): [Ads Service] Initializing native Ads from OnLoad 
 D/GraalCompiled(  910): Apr 22, 2025 12:25:11 PM com.gluonhq.attach.ads.AdRegistry <init>
 D/GraalCompiled(  910): INFO: AdRegistry(): {id=0, handlers={OnUserEarnedRewardListener=com.gluonhq.attach.ads.OnUserEarnedRewardListener$Handler@6c0109b6, FullScreenContentCallback=com.gluonhq.attach.ads.FullScreenContentCallback$Handler@1ac5ffc5, InterstitialAdLoadCallback=com.gluonhq.attach.ads.AdLoadCallback$Handler@2c9db309, RewardedAdLoadCallback=com.gluonhq.attach.ads.AdLoadCallback$Handler@30ed74db, AdListener=com.gluonhq.attach.ads.AdListener$Handler@7136a281}, ads={}, callbacks:{}}
 V/GluonAttach(  910): Initializing MobileAds...

[pabulaner]

Thanks for the feedback.
I will look into it this or next week.

[pabulaner]

I implemented the feedback and here is a short example that should work:

AdsService.create().ifPresent(service -> {
            service.initialize(() -> {
                BannerAd ad = service.newBannerAd();
                
                ad.setAdUnitId(AdsService.BANNER_TEST_AD_UNIT_ID);
                ad.setLayout(BannerAd.Layout.BOTTOM);
                ad.setAdSize(BannerAd.Size.BANNER);
                ad.setAdListener(new AdListener() {
                    // add some listeners like onAdClicked, onAdClosed(), ...
                });
                
                // currently no settings in AdRequest are supported
                ad.load(new AdRequest.Builder().build());
                
                // now the banner ad should appear
            });
        });

I did not test this myself yet, as I don't have the time right now.
I will probably get to it at the end of next month.

PS: Sorry for the long delay

[pabulaner]

I know it has been some time now, but I finally had the time to put in some more work for the ads module and I created an example application for showcasing the different types of ads.
The repository for this example application can be found here:

https://github.com/pabulaner/ads-example

This currently only works with Android as I still have some issues with iOS. Maybe You could help me with one of the issues I am having as I don't know how to add the Google Mobile Ads SDK dependency into the native iOS part? Because as far as I searched I need to somehow add a CocoaPod dependency, but I don't know how and I also couldn't find any example that uses this technique.
So maybe You know how to do it the right way and could point me in the right direction. I would appreciate that very much!

I am looking forward to Your valuable feedback!