diff --git a/developer_manual/app_development/bootstrap.rst b/developer_manual/app_development/bootstrap.rst index 7d279498e..c8be92e48 100644 --- a/developer_manual/app_development/bootstrap.rst +++ b/developer_manual/app_development/bootstrap.rst @@ -19,8 +19,8 @@ The `Application` class is the main entry point of an app. This class is optiona to register any services or run some code for every request. -Nextcloud will try to autoload the class from the namespace ``\OCA\\AppInfo\Application``, like e.g. -``\OCA\Mail\AppInfo\Application``. The file will therefore be located at ``lib/AppInfo``. +Nextcloud will try to autoload the class from the namespace ``\OCA\\AppInfo\Application``, like +``\OCA\MyApp\AppInfo\Application``, where *MyApp* would be the name of your app. The file will therefore have the location ``myapp/lib/AppInfo/Application.php``. .. code-block:: php @@ -41,7 +41,7 @@ Nextcloud will try to autoload the class from the namespace ``\OCA\registerService(...)``. The emphasis is on **lazyness**. At this very early stage of the process lifetime, no other apps nor all of the server components are ready. Therefore the app **must not** try to use anything except the API provided by the context. That shall ensure that all apps can safely run their registration logic - before any services are queried from the DI container or related code is run. -2) Nextcloud will load groups of certain apps early, like filesystem or session apps, and other later. For this their optional + before any services are queried (instantiated) from the DI container or related code is run. +2) Nextcloud will load groups of certain apps early, e.g. filesystem or session apps, and other later. For that purpose, their optional :ref:`app-php` will be included. As ``app.php`` is deprecated, apps should try not to rely on this step. -3) Nextcloud will query the app's ``Application`` class (again), no matter if it implements ``IBootstrap`` or not. +3) Nextcloud will query the app's ``Application`` class (again), no matter whether it implements ``IBootstrap`` or not. 4) Nextcloud will invoke the ``boot`` method of every ``Application`` instance that implements ``IBootstrap``. At this stage - you may assume that all registrations via ``IBootstrap::register`` have been done. + you may assume that all registrations via ``IBootstrap::register`` have completed. Nextcloud 19 and older **********************