User Guide (Version 1.21)

Android Debugging

You can debug your Android game using Visual Studio 2015.

To debug your Android game

  1. In the Visual Studio 2015 installer, select Cross platform tools for C++ development. Follow the on-screen instructions to complete the installation.

  2. In Visual Studio 2015, click Tools, Options.

  3. In the left pane of the Options dialog box, expand Cross Platform, C++, and click Android.

  4. Edit the paths to use the correct directories on your computer:

  5. Click OK and close Visual Studio 2015.

  6. Build a debug version of an .apk file and then relaunch Visual Studio 2015.


    Before you can use Visual Studio 2015 to run and debug the .apk, you must build your game assets for Android and then deploy them to the device or bundle them with the .apk. For information, see Building Game Assets for Android Games.

  7. In Visual Studio 2015, click File, Open Project/Solution. Locate and select your .apk file (BinAndroid.Debug\).

  8. In the project window, right-click the project and click Properties.

  9. Do one of the following:

    • If you are using Visual Studio 2015 without any updates, enter .CryEngineActivity for Launch Activity.

    • If you are using Visual Studio 2015 with Update 1 or later, verify that the correct activity is already set for Launch Activity. For the Samples Project, you should see LAUNCHER activity (com.lumberyard.samples.SamplesProjectActivity).

  10. For Additional Symbol Search Paths, enter dev/Code and dev/BinAndroid.Debug.

  11. Open your code files by pressing Ctrl+O or clicking File, Open.

  12. Set breakpoints, if necessary, and then press F5 to run your game.