Language:
Page Info
Tags:
Skill Level:
Engine Version:

5. Package Your Game

Choose your OS:

In order for you to be able to share your project with others or put it on a digital store to sell, the project needs to be packaged. In the following section we will take a look at how you can package your finished project for deployment inside of UE4.

Steps

Choose Your Operating System

Windows

Mac OS

Linux

We are currently packaging in Development because we are testing this game, but when your game is complete, you can package it in Shipping by hovering over the Build Configurations option in the Package Project menu.

  1. In the File menu, go to Package Project > Android and select the Texture format you want to package. For this example, we will choose Android ETC1 as it is supported by all devices.

    package_menu.png

    Different devices support different Texture formats depending on the hardware they run on. See, Android Development Reference for a detailed breakdown of the various formats.

  2. You will then be prompted for a location to save your packaged game. For now create a new folder on the desk top and select that as the location to save your project to.

    package_folder.png

  3. While your project is being packaged a packaging message will appear in the bottom right corner showing the progress of the packing.

    package_toast.png

  4. Once packaging is successful, a Packaging Complete message will appear in the bottom right of the editor.

    Packageing_Completed.png

  5. Navigate to the folder that was created in step two and in this folder you should have a new folder named specifically for the texture type you selected when packaging. In this example, the folder is named Android_ETC1.

    Android_ECT1_Folder.png

  6. Open up the Android_ETC1 folder and then Double-click on the Install[ProjectName]Development.bat batch file to install the project on your Android device.

    Install_Bat.png

    You must have your Android device plugged into your development PC via USB to deploy the project to your device. If you do not have your device plugged in running the .BAT file will do nothing.

  7. After the .BAT file has finished you should now see your project ready to be used on your Android device.

    Game_On_Phone.png

We are currently packaging in Development because we are testing this game, but when your game is complete, you can package it in Shipping by hovering over the Build Configurations option in the Package Project menu.

  1. In the File menu, go to Package Project > Android and select the Texture format you want to package. For this example, we will choose Android ETC1 as it is supported by all devices.

    AQS_Mac_01.png

  2. You will be prompted for a save location for your packaged game, which should default to your project folder. Create a new folder and call it Android_Builds.

    AQS_Mac_02.png

  3. While your project is being packaged a packaging message will appear in the bottom right corner showing the progress of the packing.

    package_toast.png

  4. Once packaging is successful, a Packaging Complete message will appear in the bottom right of the editor.

    Packageing_Completed.png

  5. Navigate to the folder that was created in step two and in this folder you should have a new folder named specifically for the texture type you selected when packaging. In this example, the folder is named Android_ETC1.

    MAC_Install_Folder.png

  6. Open up the Android_ETC1 folder and then Double-click on the Install[ProjectName]Development_armv7-es3.command file to install the project on your Android device.

    MAC_Install_BAT.png

    You must have your Android device plugged into your development PC via USB to deploy the project to your device. If you do not have your device plugged in running the .command file will do nothing.

  7. After the .command file has finished you should now see your project ready to be used on your Android device.

    Game_On_Phone.png

  1. Opening the File menu, scroll down to Package Project, and hover your mouse curser over Android before selecting Android (ETC1).

    Click for full image.

  2. After the Open Directory menu appears, create a new folder entitled Android_Builds using the New Folder button.

    Click for full image.

  3. Now, click the Open button to begin the packaging process.

    Click for full image.

  4. You should see a progress indicator in the bottom right corner while UE4 packages your project.

    Click for full image.

  5. At the end of the packaging process, you should see a message telling you that the packaging process has completed.

    Click for full image.

  6. Navigate to the Android_Builds folder, where you should see a folder entitled Android_ETC1.

    LinuxAndroid_Step36.png

  7. Open the Android_ETC1 folder, where you'll find the files that were created during the packaging process.

    LinuxAndroid_Step37.png

    You should see the Installation and Uninstallation shell scripts (*.sh) along with the Android Application Package (*.apk) that contains all of the files you need to install the project onto any Android device that supports the ETC1 compression scheme.

  8. Now, open up the terminal from this folder's location by right-clicking inside of the folder and selecting Open in Terminal.

    LinuxAndroid_Step38.png

  9. Enter ./Install_LinuxAndroidProject_Development-arm64.es2.sh into the terminal to install the project onto your Android device.

    Click for full image.

    If you're having trouble running the shell script, try entering adb devices into the terminal to verify that your device is indeed, connected to your computer.

  10. During the installation process, the shell script should flush the following output to your terminal.

    Click for full image.

    When the shell script has completed the installation process, you should see an Installation successful message.

End Result

When completed you will now have a .APK file that contains your UE4 project that can now be deployed via the .BAT file to any Android based smartphone.