Tutorials

Ludei CocoonJS

CocoonJS from Ludei can wrap your PlayCanvas game as a native application which can then be submitted to either Google Play or the Apple App Store.

Testing your PlayCanvas Game in CocoonJS

Before you generate a native build of your PlayCanvas game, you will want to test it in CocoonJS and see how it performs. Ludei have created an awesome app called the CocoonJS Launcher that can pull your PlayCanvas game directly from playcanvas.com and run it on the device. Just give the launcher your game's URL and it will happily run in the launcher.

Let's step through the process to illustrate how easy it is:

  1. Create an account on ludei.com.
  2. Install the CocoonJS Launcher for Android or iOS.
  3. Start the Launcher on your mobile device.

    CocoonJS Launcher

  4. Select 'Your App' and log in.

    CocoonJS Launcher

  5. Select URL and enter the URL to your embeddable link (see below) for your PlayCanvas game.

    CocoonJS Launcher

    Type this into the URL edit box in the Launcher and hit 'CANVAS+' or 'WEBVIEW+'!

Your game can be accessed by one of two links. The build link or the project link.

To get the embeddable version of either link, add /e/ after the host. e.g.

Generating the Native Build of your Game

Now that you have tested your game on your mobile device via the CocoonJS Launcher app, you are ready to build a native version. Once again, Ludei makes this really easy for you. Just follow these simple steps:

  1. Log in to the Ludei Dev Portal.
  2. Hit the 'New Project' button.
  3. Fill in the Project Information form.
  4. Select iOS configuration from the left.
  5. Select the link to load default assets from the web. This will set default images for icons and loading screen. You can change these at any point to your own images.
  6. Select Compilation -> Compile Project.
  7. Download your game from PlayCanvas as explained in the self-hosting guide.
  8. Select the downloaded ZIP file.
  9. Check the platforms your want to publish to.
  10. Accept the conditions.
  11. Hit 'Compile Project' and you're done.
This site is translated by the community. If you want to get involved visit this page