Testing & Debugging

Once you have your game uploaded and deployed, you can start testing it in Tester App or in a browser.

Test in a Browser (a.k.a Debug Mode)#

Instructions are exactly the same as local development. Please find the details here.

Test in Link Test Build#

To test with Link test build, you'll need to meet these requirements:

  • Access to latest Link test build for iOS or Android
  • An iOS or Android device
  • A Rakuten Mobile eSIM or physical SIM (depending on whether your device supports eSIM)

Please reach out to our team. Once you have your requirements met, please proceed with these steps to start testing:

First, install the eSIM or physical SIM on your test device.

Second, download and install the test build.

For Android, please download the .apk file, copy it to the device's storage, and use a file manager app to open the file to start installation. (If command line is preferred, you can also use adb install to install the build. Details on adb)

For iOS, please download the .ipa file, connect your device to your Mac, make sure the Mac is trusted, then open the device in Finder, drag and drop the .ipa file to the device to start installation.

note

On iOS, it may be required to trust the Rakuten Enterprise certficitation before you can launch the test build. The setting can be found at: Settings -> General -> Profiles and Device Management -> Rakuten, Inc. -> Trust Rakuten, Inc.

Third, open the Link test build and finish the first time setup, which requires you to first login the connected Rakuten account (credentials should be attached along with the eSIM/SIM), fill in your eSIM/SIM phone number and finish SMS verification. Now the device is ready to be used for testing.

Fourth, go to developer console and show your game's Preview URL (or Game URL if the game is already published). And open the URL on your device (or scan the QRCode on the device), which should bring up the game in Link test build.

Test in Tester App#

We would recommend testing in browser for early stage integration and testing on Link test build for pre release stage integration.

But due to there can be physical limitations on the access to testing on Link test build (e.g. the number available eSIM/SIM). Tester App can be utilized as an alternative way to test your game's behavior. But please be note that there're limitations in Tester App:

  1. Message can't be sent out
  2. Contact list will be mocked
  3. The WebView behavior may differ from Link test build and Link production build

To test a game in Tester App, you'll need to first install the app on your mobile device.

note

If you're using the iOS device version, it will be required to trust the Rakuten Enterprise certficitation before you can launch the app, which setting can be found at: Settings -> General -> Profiles and Device Management -> Rakuten, Inc. -> Trust Rakuten, Inc.

Android: https://install.appcenter.ms/orgs/rakuten-early-adoption-organization/apps/mini-app-sample/distribution_groups/production
iOS (Real device): https://install.appcenter.ms/orgs/rakuten-early-adoption-organization/apps/mini-app-demo/distribution_groups/production
iOS (Simulator): https://install.appcenter.ms/orgs/rakuten-early-adoption-organization/apps/mini-app-demo-ios-simulator/distribution_groups/production

Once you've installed the app, open the Change App Settings to set up access to your own game.

On this screen, fill in the Project ID and Subscription Key (which is can be found on the Admin page for organization administrators), then click save. This will lead you back to the list, which should now have your game on the list.

Clicking the latest version of the game will bring up the webview for you to test.

On Android, to debug the WebView, connect your mobile device to your desktop, and navigate to chrome://inspect inside Chrome. Then you can debug by inspecting the corresponding WebView instance.