Migration Guide: APPTUTTi
Overview
This technical migration guide is for you if:
- You registered you game on APPTUTTi via UDP;
- You submitted your game to APPTUTTi via UDP;
- Your game went live on APPTUTTi and you have players.
If you implement IAP (In-App Purchases) using UDP SDK in your game, you can migrate your solution using APPTUTTi SuperSDK. To ensure continuity of service to your APPTUTTi players, specifically keeping the ability to update your existing game, please follow the migration steps.
Migration Steps
Publish to APPTUTTi
Step 1 (only needed for UDP generated signing key)
If you use UDP generated signing keys to sign your application, there are 2 ways you can get them:
- In the UDP console, go to My Games and you can download key files for your games.
- You can reach out to the support team via https://support.unity.com/hc/en-us and request your keystores.
Step 2
When you have retrieved the signing key and certificate, there are also 2 ways to sign your application.
- Option AYou can generate a keystore, load it in Unity Editor and build the signed application with this manual (please choose the right Unity version).The keystore will be used for signing release builds and is not recommended for development. You can use Unity Editor built-in debug key for signing your build for testing purpose by using the Development Build option in the build settings (https://docs.unity3d.com/Manual/BuildSettings.html).To create a keystore from UDP generated key files, you can run following commands (prerequisite: OpenSSL and keytool installed and added to your PATH):
$ openssl pkcs8 -inform DER -outform PEM -in {name-of-private-key}.pk8 -out private_key.rsa.pem -nocrypt$ openssl pkcs12 -export -in cert.x509.pem -inkey private_key.rsa.pem -out pkcs.p12 -name {alias-to-use-for-signing-key}$ keytool -importkeystore -destkeystore {keystore-filename}.keystore -srckeystore pkcs.p12 -srcstoretype PKCS12 -alias {alias-to-use-for-signing-key} - Option BYou can use apksigner to sign your apk.If you use your own signing key, then run:
$ apksigner sign --ks [Keystore Location].keystore --in [Build Location].apk --out sign_[Build Location].apkIf you use UDP generated signing keys, then run:$ apksigner sign --key [Private Key].pk8 --cert [Certificate].x509.pem --out signed.apk original.apk
Step 3
Publish your signed application to APPTUTTi through the partner portal by following these instructions but with your existing project entry.
In-App Purchases (IAP)
If you implement IAP using UDP SDK in your game, you need to migrate your solution using APPTUTTi SuperSDK.
- Option ADownload and extract APPTUTTi Unity SDK from this link. And then follow the SuperSDK Integration Guide and Demo which you can find in the extracted folder to implement IAP for your game project.
- Option BYou may also implement IAP in your project using APPTUTTi Android SDK + Unity IAP, and implement the IStore interface, combined with Android JNI with this Unity manual.
Firebase
If you integrate Firebase into your game, no further updates will be required. Nonetheless, we recommend revisiting the UDP Firebase manual to ensure that if any specific changes are needed.
Frequently Asked Questions (FAQ)
What will happen to my game on APPTUTTi after UDP deprecation?
If your game was published to APPTUTTi from UDP, it will continue to exist on APPTUTTi and will remain available for download on it. Additionally, users who already installed the game will still be able to play it on their device. After February 17, 2025, your game may have issues initializing or making IAP transactions. We recommend you to re-implement IAP in your game before the deprecation date.
What will happen to my game on UDP?
After February 17, 2025, you will no longer be able to submit game updates to APPTUTTi from UDP. The UDP console and services will also no longer be available after the deprecation date.
Can I continue to use UDP until the deprecation date?
Yes, although you cannot add new games, you can still use the service until the deprecation date.
Will my users be able to download and play my game in the Chinese market after UDP deprecation?
Yes, users will still be able to download and play your game from supported Chinese AppStores. We recommend you create and submit an update to APPTUTTi before February 17, 2025 to avoid any disruption in game behavior.
What will happen to the UDP package in versions 2021.3 and 2022.3 after the deprecation date?
Following the sunset date, the UDP package in versions 2021.3 and 2022.3 will be officially marked as deprecated.
Will my users be able to make IAP after UDP deprecation if I use UDP package?
No, users might face issues making IAP after the deprecation date. Please see IAP (In-App Purchases) for migrating UDP SDK based IAP to APPTUTTi SuperSDK.
Can I update my existing game on AppGallery with a new build that I'd create separately?
Yes, this is actually the best way forward. Please see Publish to APPTUTTi.
What happens if I use a different package name or a different signature for my game on APPTUTTi?
The APPTUTTi, as well as the players’ devices, will consider it as a separate game from the original one. Your existing players will not be served that update (they are on the “original” game). If they download the game with the new package name / new signature, they will start the game from the beginning; progress and purchases made in the original game version will not be restored.
Must I create a separate account on APPTUTTi partner portal?
No, you will still be able to log into the APPTUTTi partner portal using your Unity ID.
Am I going to be paid the same way as before?
Your APPTUTTi partner account will still be active, so there shouldn't be any change to the way you've historically received payments.
Overview
Migration Steps
Publish to APPTUTTi
In-App Purchases (IAP)
Firebase
FAQ