Shell APK
The Shell APK provides a return path to your Instant Plays game for users who launch your Instant Plays game from an ad in Instant Plays. With the user's consent, an icon for your game is added to the user's smartphone app tray. The Shell APK is simply a deeplink to your Instant Plays game.
When a user launches your Instant Plays game for the first time from an ad in Instant Plays, an installation pop-up window displays. When the user clicks to install the Shell APK, your Instant Plays game is launched and the Shell APK is installed on the user's Galaxy smartphone app tray. If the user wants to play your game again, your game can be launched from the app icon installed on the smartphone.
Requirements
-
The Shell APK must have the same package name (App ID) and signing key as your Android (downloadable) APK.
-
The Shell APK version code must be lower than that of your Android (downloadable) APK so that it can be updated to the Android APK version.
NoteShell APK does not support automatic updates through Galaxy Store. -
The AndroidManifest.xml file must include the following:
<meta-data android:name="com.samsung.android.IP20shell" android:value="true"/>
<uses-sdk android:minSdkVersion="23" />
- Your Instant Plays game is registered in Seller Portal. The content ID of the registered game is used to create the deeplink for your game.
Sample Shell APK
For your convenience, a sample Shell APK project file is provided.
Make the following updates to the sample Shell APK project file:
-
Package name: Update
applicationId
, located in the shell_apk/build.gradle file. The package name of the Shell APK must be the same as your Android (downloadable) APK. -
App name: Update
app_name
, located in the shell_apk/src/main/res/values/strings.xml file. -
App icon: Replace the
ic_launcher.png
files in all of the shell_apk/src/main/res/mipmap-* directories. -
CloudGame deeplink URL: Update
cloudGameDeeplink
, located in the shell_apk\src\main\java\com\example\shellapk\MainActivity.kt file. The deeplink uses the following format:https://apps.samsung.com/a/cloudgame/play?content_id={Instant Play 2.0 CID}&orientation={01 or 02}&company={Company Name}&ua=01&utm_url=utm_source%3DAppIcon
where
{Instant Play 2.0 CID}
is the content ID assigned to your game by Seller Portal when you registered your Instant Plays game.{01 or 02}
is the game play orientation where01
is portrait and02
is landscape. For example, if your game runs in landscape mode, include "orientation=02" in your deeplink URL.{Company Name}
is your company name. If there is a space in your company name, use "%20" to represent the space. For example, "Samsung Electronics" would be "company=Samsung%20Electronics"
-
Signing key: Sign the Shell APK using the same signing key as your Android (downloadable) APK.
<uses-sdk android:minSdkVersion="23" />
is automatically added to the AndroidManifest.xml file when the project is built.