The Catappult Developer Hub

Welcome to the Catappult developer hub. You'll find comprehensive guides and documentation to help you start working with Catappult as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Unity UDP

Prerequisites

Setting up your game
Open your game and check the version of Unity IAP package.

If you already integrated Unity IAP
Go to Package Manager (Window->Package Manager) or open the AssetStore and search for Unity IAP.

If you went through package manager the version should be at least 2.0.8.
If you went through the Asset Store the version should be 1.22.

OR

Just import this package to have everything setup for you.

Now please go to Integrating UDP with existing Unity IAP.

If you didn't integrate Unity IAP yet
If you don't have IAP setup at all first download the Unity IAP package from here, then set up the in-apps and the UDP part. This is the easiest and cleanest way to get the best results.
You can check more in-depth details about this process here.
Once you're done implementing Unity's IAP you can go to Integrating UDP with existing Unity IAP.

If you already have IAP integrated but using other solution rather than Unity IAP (like Google Play SDK directly) it's better for you to integrate the standalone SDK.

You can check more in-depth details about this process here.

Integrating UDP with existing Unity IAP implementation

If you didn't download the package yet, start by going here and downloading the Unity IAP package with UDP.

Integrate it on Unity and then follow this guide and then for easiness and speed this guide but first take a careful look at the following list of notes that might help you out dodging some possible errors you may encounter during the process:

  • Make sure the product ids for products you create on the catalog are lowercase. This is mandatory for Android but not iOS for example, so Unity doesn't warn you if you have capital letters by mistake. Don't use fullTrajectory use full_trajectory instead.

  • Make sure at the end of Unity IAP's IAP Catalog you have the Automatically initialize UnityPurhcasing checkbox enabled. This is crucial for the process to work with Codeless IAP for instance and sometimes it does not start enabled by default.

  • Don't forget to set up a price in USD on the Unity Distribution Portal section

After you're done creating and setting up your products you're ready for Submitting your game.

Submitting your game

First you need to build an APK of your game.

Before building the APK you need to make sure that the IAP system is targetting UDP. To verify this please go to Window -> Unity IAP -> Android and make sure that Target Unity Distribution Portal is checked.

Now you can build. Click File -> Build Settings. Make sure Android is the platform selected. click build and chose the APK filename.

You’ll have to manually upload it to Unity servers. To do so, on the Services tab, click “Go to dashboard” button.

On the website, after making sure you’re on the Develop tab, click Cloud Build -> Build History -> Upload Build.

On the upload window pick the APK, add a label and select the Android platform. Then click “Upload”.

After the upload is done, pick the latest build, tap the 3 dots button and select “Push to Unity Distribution Platform” option.

Press “Push” on the next popup and wait for the upload to finish.

You'll be taken to the Deployments section showing your latest deploy.

Click "Visit the UDP console" to see your game there.

You'll be taken to a page where you can edit your game's info. After your done, hit the Save Button.

The Save Button turns into a Release button and you can create a new Revision for submission.

Fill in the details and click Create.

On the top tabs press Publish to be taken to the stores listing.

This screen will show all available stores to publish your game. Find Catappult and click to sign up.
If you already have a Catappult account it will be linked to your Unity account. If you don't, one will be created for you with the details fetched from your Unity account.

After registration/merging of your account is done you'll be taken back to UDP portal and you can now register your game on the Catappult portal. Click the "Register your game on Catappult" and make sure the package name is correct.

Click Register.

You'll have to fill in some info about your company details. All fields are mandatory. Click create when done.

With company info filled in you can now click the register button again (this process might take a little bit).
Now you're ready to pick the target step to publish to the stores. On Catappult there are two target steps available:

  • Repack Game - this just applies the store SDK on your game and let's download a preview APK
  • Submit To Store - this step implicitly runs the previous step and then submits the game to the store

Since we don't support a sandbox environment, the APK resulting from the Repack Game won't be of any good by itself. Until the game is registered and uploaded to our portal the services won't work.

Go ahead and pick Submit to Store, tick the Catappult store and on the top right corner click Publish.

After clicking Publish and confirming, you'll be taken to the tab "Status" where you can see that your submission operation is "In Process". As this is a composite operation, you'll get 2 notifications. One when the game is successfully packed, and another when the game was successfully published. This process shouldn't last more than 5 minutes.

That's it!

If you login to Catappult you can now see your game is published and ready to be downloaded by our huge userbase!

Unity UDP


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.