Export a Game Project

To export your project, you need to complete the steps below and then compile your game project for the platform where you want to publish your game.

Saving and Exporting Your Game Project

  1. Remove unused images and sounds:
    1. On the Buildbox menu bar, go to View Atlases.
    2. In the Atlas Editor, select each atlas and in the Options panel click Optimize.
    3. Close the Altas Editor.
    4. On the menu bar, go to Tools and select Remove Unused Sound Objects.
  2. On the Navigation bar, click the Settings button.
  3. In the Project Settings window, fill in the General project settings for each platform where you want to publish your game.
    Make sure to set a unique bundle ID for each platform App Store where you want to publish your game, for example, in the Apple App Store settings and Google Play Store settings. This will prevent errors and notifications when compiling your game.
  4. Close the Settings window.
  5. On the Buildbox menu bar, go to File Export and select the platform where you want to publish your game.
    A progress indicator appears as Buildbox saves your game project.
  6. In the displayed Save As dialog, type a name for the folder where your exported game should be saved and select its location on your computer, for example, Desktop.
    If you are planning to export to more than one platform, to be able to distinguish between the export folders with the same name, include the platform name at the end of the export folder name, for example, My Game Name iOS.
  7. Click Save.
    A progress indicator appears as Buildbox exports your game project.
  8. When the process is complete, navigate to the export folder where you saved it on your computer and open it.
  9. For all platforms except Windows EXE, compile your project in Xcode, Visual Studio, or a similar IDE, as explained below.

Compiling Your Game Project

For iOS

Prerequisites

  • Complete the saving and exporting steps above, including the settings for Apple App Store.
  • Install the latest version of Xcode on your Mac computer. If you only have a PC, search for solutions to running Mac OS on other computers online.
  • Make sure you have an Apple Developer Account or at least an Apple ID so that you can add an account during the compilation process, if you don’t have one.

To compile your game in Xcode for iOS:

  1. Navigate to the iOS export folder where you saved your game and double-click your Xcode project file named BBPlayer.xcodeproj.

    Xcode opens with your project loaded.
  2. In the panel on the left, select BBPlayer at the top and navigate to the Signing & Capabilities tab on the right as shown below.
  3. In the Team drop-down, select your developer account. If you don’t have one, select Add an Account and enter your Apple ID and follow the onscreen instructions.
  4. Select the device on which you would like to run your game:
    1. Plug in your device to your computer with a cable and, if you want to trust the connected computer, select Trust on your device when prompted.
    2. In the Device list that appears in Xcode, scroll and select the device you need, for example, iPhone 11 Pro Max.
    3. If you are prompted to register your device in the Status section, click Register Device and follow any onscreen instructions that may appear.
  5. Unlock your device.
  6. In the top-left corner of the Xcode window, click the Run button.
    A blue build progress indicator appears at the top of the Xcode window.
  7. When prompted, enter your computer password as the login keychain password.

When the build is complete, you should be able to play your game on your iOS device. Congratulations! You’ve compiled you game project and can now upload your game to the App Store.

For Android

Prerequisites

  • Complete the saving and exporting steps above, including the settings for Google Play Store.
  • Install the latest version of Android Studio and Android Gradle Plugin.
  • (Optional) Install the Dropbox app on your Android device for importing the APK file.

To compile your game in Android Studio:

  1. Navigate to the Android export folder where you saved your game and double-click your either the build.gradle or settings.gradle Android Studio Documents.

    Android Studio opens and starts syncing your project. If prompted to search for an application, click Choose Application and select Android Studio to load the gradle file.
    If prompted to install any missing SDK packages, do so by following the displayed links and installation instructions.
    After the synching process is complete, the build output is displayed with green checkmarks at the bottom of the Android Studio window.
  2. Click the Make Project button .
    The build process begins, with the progress indicated by green checkmarks appearing in the Build Output section. When the build is completed, a new build folder is added in your game export folder.
  3. Navigate to the app-debug.apk file in the newly added folder, android > app > build > outputs > apk > debug.
  4. To install the APK, connect your device to the computer and in Android Studio, click the Run App button . Follow the onscreen instructions.
    You can also add the APK file to your personal Dropbox, create a sharable link, and then use the Dropbox app on your device.

Congratulations! You’ve compiled you game project and can now play your game and upload it to the Google Play Store.