Jc.GMA.iOS 13.0.0

Jc.GoogleMobileAds.iOS

Google Mobile Ads SDK iOS Bindings

Package Showcase

• marius-bughiu - Plugin.AdMob - AdMob plugin for .NET MAUI
• jcsawyer - Jc.AdMob.Avalonia - AdMob plugin for Avalonia mobile projects

Breaking Changes

Each major version contains breaking changes according to the Google AdMob SDK. Please refer to the Google AdMob SDK for more information. The headline changes relevant will be listed here.

v13.0.0

This package binds Google Mobile Ads SDK 13.0.0. It continues to support .NET 9/10 and requires iOS 15 or later. Jc.UMP.iOS remains at 2.7.5.

• NativeAd.RegisterAdView (both overloads) and NativeAd.UnregisterAdView have been removed with the native SDK. Use NativeAdView to render native ads.

• The existing anchored adaptive banner sizing functions are obsolete but retain their original behavior. Use these replacements on the main thread:

  Existing AdSizeCons method	Replacement
  GetCurrentOrientationAnchoredAdaptiveBannerAdSize	GetLargeAnchoredAdaptiveBannerAdSize
  GetPortraitAnchoredAdaptiveBannerAdSize	GetLargePortraitAnchoredAdaptiveBannerAdSize
  GetLandscapeAnchoredAdaptiveBannerAdSize	GetLargeLandscapeAnchoredAdaptiveBannerAdSize

• Large anchored adaptive banners can be taller; size the banner container from the returned AdSize.

• Request.NeighboringContentUrlStrings remains a string[]. The native SDK now raises an exception for non-string array elements; avoid null elements or passing other object types through native interop.

See Google's v12 to v13 migration guide.

v12.13.0

Both NativeAd.RegisterAdView overloads and NativeAd.UnregisterAdView are obsolete, matching the native SDK deprecations. Use NativeAdView to render native ads instead. These methods remain available but are no longer supported by Google and will be removed in a future SDK version.

v12.2.2

AdSizeCons constants were changed to be hardcoded while I try to find a better approach to access the true values. This means that values will be the same for both iPhone and iPad.

SmartBannerPortrait, SmartBannerLandscape, and Fluid have been removed until a workaround is discovered as these are entirely dependent on the framework or the calling framework (MAUI/Avalonia/etc.)

v9.x.x to v11.x.x

• The minimum supported version of iOS is now 13.
  • Note: SDK 11.0.0 still builds on iOS 12 devices, but ads will not serve.
• armv7 support has been removed from the SDK

From v11.13.0 and beyond, you must add this target to your csproj file to support linking with Swift system libraries

<Target Name="LinkWithSwift" DependsOnTargets="_ParseBundlerArguments;_DetectSdkLocations" BeforeTargets="_LinkNativeExecutable">
    <PropertyGroup>
        <_SwiftPlatform Condition="$(RuntimeIdentifier.StartsWith('iossimulator-'))">iphonesimulator</_SwiftPlatform>
        <_SwiftPlatform Condition="$(RuntimeIdentifier.StartsWith('ios-'))">iphoneos</_SwiftPlatform>
    </PropertyGroup>
    <ItemGroup>
        <_CustomLinkFlags Include="-L" />
        <_CustomLinkFlags Include="/usr/lib/swift" />
        <_CustomLinkFlags Include="-L" />
        <_CustomLinkFlags Include="$(_SdkDevPath)/Toolchains/XcodeDefault.xctoolchain/usr/lib/swift/$(_SwiftPlatform)" />
        <_CustomLinkFlags Include="-Wl,-rpath" />
        <_CustomLinkFlags Include="-Wl,/usr/lib/swift" />
    </ItemGroup>
</Target>

More info can be found here

Usage

To use Jc.GoogleMobileAds.iOS, you can add the required packages to your project:

dotnet add package Jc.GMA.iOS
dotnet add package Jc.UMP.iOS

Ensure that the SupportedOSPlatformVersion attribute in your project file is set to 15.0 or higher:

<SupportedOSPlatformVersion>15.0</SupportedOSPlatformVersion>

along with setting it in the Info.plist file:

<key>MinimumOSVersion</key>
<string>15.0</string>

Failing to set the minimum version will result in the compiler warning:

Jc.*.iOS requires a minimum SupportedOSPlatformVersion of 15.0. Update your project to target iOS 15 or later.