Skip to content

muxinc/mux-stats-google-ima

Repository files navigation

Version License Platform

Mux-Stats-Google-IMA

Development

To run the example project, clone the repo, and run pod install from the Example directory first. Then open up the .workspace in the Example/ directory

Tests

Run tests in XCode with cmd + u

Installation

Swift Package Manager

In order to install in your iOS application open your Package.swift file, add the following to dependencies.

.package(
	url: "https://github.com/muxinc/mux-stats-google-ima",
	.upToNextMajor(from: "0.13.0")
 ),

Swift Package Manager does not support installation of Google IMA packages for both iOS GoogleAds-IMA-iOS-SDK and tvOS GoogleAds-IMA-tvOS-SDK at the same time because they cannot be disambiguated at the time of package resolution. This is a known issue with Google IMA tracked here.

As a workaround, if installing for just tvOS, add the following binary target to your Package.swift file.

.binaryTarget(
    name: "MuxStatsGoogleIMAPluginTVOS",
    url: "https://github.com/muxinc/mux-stats-google-ima/releases/download/v0.13.0/MuxStatsGoogleIMAPluginTVOS.xcframework.zip",
    checksum: "bb71f2120ebff9160f8aeae82d7a7c19ddde3e396c42852d01a04ae2f5fda6e8"
)

Cocoapods

The Mux Google IMA plugin is available through CocoaPods. To install it, add the following line to your Podfile:

pod 'Mux-Stats-Google-IMA'

Manual Installation

  • Depending on the platforms your application is targeting, download and integrate GoogleAds-IMA-iOS-SDK or GoogleAds-IMA-tvOS-SDK.
  • Navigate to the most recent release listed here.
  • For iOS applications download MuxStatsGoogleIMAPlugin.xcframework.zip
  • For tvOS applications download MuxStatsGoogleIMAPluginTVOS.xcframework.zip
  • Unzip the xcframework and add to your Xcode project

Releasing a new version

  1. Checkout a new release branch named releases/vX.Y.Z where X, Y, and Z are the major, minor, and patch versions of the released SDK.
  2. Update Mux-Stats-Google-IMA.podspec with new major, minor, and patch versions.
  3. Update marketing version with new major, minor, and patch versions in Xcode project files in FrameworkProject/MuxStatsGoogleIMAPlugin and FrameworkProject/MuxStatsGoogleIMAPluginTVOS
  4. cd Example/ and run pod install (this will install the updated version into the example app)
  5. create a PR against master for your releaes/v* branch
  6. merge PR after release notes pop in (check them for spelling/grammar/tone)
  7. wait for PR comment to appear with a link to a draft release
  8. attach the MuxStatsGoogleIMAPlugin.xcframework.zip anc MuxStatsGoogleIMAPluginTVOS.xcframework.zip file to that release
  9. Create the release
  10. From up-to-date master: pod trunk push Mux-Stats-Google-IMA.podspec --allow-warnings