The AZ Bootstrapping Process

An AZ framework application initializes modules based on the dynamic libraries listed in the application descriptor file, and the static libraries referenced from the CreateStaticModules() function.

When an AzFramework::Application starts, the following order of events takes place:

  1. The executable starts.

  2. The AzFramework::Application class is initialized. It takes a path to an application descriptor file and a pointer to a function that will create the AZ::Modules from static libraries.

  3. The application bootstraps itself just enough to read the application descriptor file.

  4. The application descriptor file is read to get memory allocator settings and the list of dynamic libraries to load. O3DE is not yet able to read the system entity from the file.

  5. O3DE shuts down the bootstrapped systems, configures them according to the settings it just loaded, and starts these systems back up.

  6. Each dynamic library is loaded.

  7. Each dynamic library’s InitializeDynamicModule() function is run, which attaches the DLL to the global AZ::Environment.

  8. Each static library’s AZ::Module instance is created using the function pointer passed in during step 2.

  9. Each dynamic library’s AZ::Module instance is created by its CreateModuleClass() function.

  10. Each AZ module’s RegisterComponentDescriptors() function is called. Now the application knows how to serialize any components defined within a library.

  11. The application descriptor file is read again to extract the system entity along with its components and their settings.

  12. Each AZ module’s GetRequiredSystemComponents() function is called. If any components are missing from the system entity, they are added.

  13. The system entity is activated, and all of its system components are activated in the proper order.

At this point, initialization has been completed and the game is running.


Copyright © 2022 Open 3D Engine Contributors

Documentation Distributed under CC BY 4.0.
For our trademark, privacy and antitrust policies, code of conduct, and terms of use, please click the applicable link below or see https://www.lfprojects.org.


The Linux Foundation has registered trademarks and uses trademarks. For a list of trademarks of The Linux Foundation, please see our Trademark Policy page.