Pinou Adventure – Android & Xcode Game with AdMob ads (Ready to Publish)

Introduction:

Pinou Adventure is a popular open-source endless runner game that has been well-received by gamers on both Android and iOS platforms. The game's versatility and ease of customization have made it a favorite among developers, allowing them to easily integrate their own brand and monetize their gameplay experience. In this tutorial, we will walk you through the process of setting up Pinou Adventure with AdMob ads, ensuring your game is ready to be published on the Google Play Store and Apple App Store.

Prerequisites:

Before we begin, ensure you have the following requirements met:

1. Install Android Studio for Android app development.
2. Install Xcode for iOS app development.
3. Create an AdMob account and get your AdMob ID for both Android and iOS apps.
4. Familiarity with Java or Kotlin programming language for Android or Swift or Objective-C programming language for iOS.

Step 1: Preparing the Pinou Adventure Game

1. Download the Pinou Adventure project from GitHub: https://github.com/ibright/Pinou-Adventure-Android
2. Clone the repository to your Android Studio project directory.
3. Open the project in Android Studio and follow these steps:
   • Change the package name in build.gradle file: android {... packaging {... package 'your.package.name' }... }
   • Rename the app module to your desired name, e.g., com.yourcompany.pinouadventure
4. For iOS development, you can download the Pinou Adventure project from GitHub and open it in Xcode.

Step 2: Setting up AdMob Ads

1. Android:

   • Create a new file in the app directory called AdConfig.java and add the following code:

     public class AdConfig {
     public static final String ADMOB_ID_BANNER = "your-banner-admob-id";
     public static final String ADMOB_ID_INTER = "your-inter-admob-id";
     }

     Replace your-banner-admob-id and your-inter-admob-id with your actual AdMob IDs.

2. In the MainActivity.java file, add the AdMob ads initialization code in the onCreate() method:

   
   import com.google.android.gms.ads.AdRequest;
   import com.google.android.gms.ads.AdView;
   import com.google.android.gms.ads.MobileAds;

public class MainActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); MobileAds.initialize(this, new OnInitializationCompleteListener() { @Override public void onComplete(InitializationStatus initializationStatus) { } }); AdView bannerAdView = new AdView(this); AdRequest adRequest = new AdRequest.Builder().build(); bannerAdView.loadAd(adRequest); } }

3. **iOS:**
    * Create a new file in the `PinouAdventure` project directory called `AdConfig.swift` and add the following code:
```swift
import UIKit
import GoogleMobileAds

enum AdConfig {
    static let bannerAdId = "your-banner-admob-id"
    static let interstitialAdId = "your-inter-admob-id"
}

Replace your-banner-admob-id and your-inter-admob-id with your actual AdMob IDs.

1. In the GameViewController.swift file, add the AdMob ads initialization code in the viewDidLoad() method:

   
   import UIKit
   import GoogleMobileAds

class GameViewController: UIViewController, GADBannerViewDelegate { @IBOutlet weak var bannerView: GADBannerView!

override func viewDidLoad() {
    super.viewDidLoad()
    MobileAds.sharedInstance().start()
    bannerView.adUnitID = AdConfig.bannerAdId
    bannerView.rootViewController = self
    bannerView.delegate = self
    bannerView.load(GADRequest())
}

}

**Step 3: Integrating AdMob Ads into the Game**

1. **Android:**
    * In the `GameActivity.java` file, add the following code to display the banner ad:
```java
// Create a banner ad instance
AdView bannerAdView = new AdView(this);
bannerAdView.setAdSize(AdSize.BANNER);
bannerAdView.setAdUnitId(AdConfig.ADMOB_ID_BANNER);
bannerAdView.loadAd(new AdRequest.Builder().build());

// Set the banner ad view layout
LinearLayout layout = new LinearLayout(this);
layout.setLayoutParams(new LinearLayout.LayoutParams(
            LinearLayout.LayoutParams.MATCH_PARENT, LinearLayout.LayoutParams.WRAP_CONTENT));
layout.addView(bannerAdView);
setContentView(layout);

1. iOS:
   • In the GameViewController.swift file, add the following code to display the banner ad:

     
     // Create a banner ad instance
     let bannerView = GADBannerView(adUnitID: AdConfig.bannerAdId)
     bannerView.rootViewController = self
     bannerView.delegate = self
     bannerView.load(GADRequest())

// Set the banner ad view layout bannerView.translatesAutoresizingMaskIntoConstraints = false view.addSubview(bannerView) NSLayoutConstraint.activate([ bannerView.centerXAnchor.constraint(equalTo: view.centerXAnchor), bannerView.bottomAnchor.constraint(equalTo: view.bottomAnchor) ])

**Step 4: Testing and Publishing**

1. Run the game on your emulator or physical device to test the AdMob ads.
2. Test the ads by interacting with the game and checking for ad displays.
3. Once you're satisfied with the ad integration, generate a signed APK or submit your app to the Apple App Store.

By following these steps, you have successfully integrated AdMob ads into the Pinou Adventure game, making it ready for publication on both the Google Play Store and Apple App Store.